Stats

Shows data about the performed search.

About this widget

Each search results comes with a SearchStats structure containing metadata that you might display in your search experience. The following information is available within SearchStats:

• hitsPerPage. Number of hits per page.
• totalHitsCount. Total number of hits.
• pagesCount. Total number of pages.
• page. Current page.
• processingTimeMS. Processing time of the request (in ms).
• query. Query text that produced these results.

InstantSearch provides two types of StatsController:

• LabelStatsController. Presents metadata in UILabel in the form of text.
• AttributedLabelStatsController. Presents metadata in UILabel in the form of attributed text.

The format in which metadata appears in StatsController is defined in the presenter closure provided while connecting the controller with Interactor.

Explore example code

Examples

Instantiate a StatsConnector and launch an initial search on its Searcher.

Swift

let searcher = HitsSearcher(appID: "YourApplicationID",
                            apiKey: "YourSearchOnlyAPIKey",
                            indexName: "YourIndexName")
let labelStatsController: LabelStatsController = LabelStatsController(label: UILabel())

let statsConnector: StatsConnector = .init(searcher: searcher,
                                           controller: labelStatsController,
                                           presenter: DefaultPresenter.Stats.present)

searcher.search()

Parameters

searcher · HitsSearcher · required

The Searcher that handles your searches.

interactor · StatsInteractor · required · default: .init()

The logic applied to Stats.

controller · ItemController · default: nil

The Controller interfacing with a concrete stats view.

presenter · Presenter<SearchStats?, Output> · default: nil

The Presenter defining how stats appear in the controller.

Low-level API

If you want to fully control the Stats components and connect them manually, you can use the following components:

• Searcher. The Searcher that handles your searches.
• StatsInteractor. The logic applied to the stats.
• StatsController. The controller that interfaces with a concrete stats view.

Swift

let searcher = HitsSearche(appID: "YourApplicationID",
                           apiKey: "YourSearchOnlyAPIKey",
                           indexName: "YourIndexName")
let labelStatsController: LabelStatsController = LabelStatsController(label: UILabel())
let statsInteractor: StatsInteractor = .init()
statsInteractor.connectSearcher(searcher)
statsInteractor.connectController(labelStatsController, presenter: DefaultPresenter.Stats.present)

searcher.search()

Customizing your view

The default controllers, such as the LabelStatsController, work well when you want to use native UIKit with their default behavior.

If you want to use another component (other than a UILabel) such as a UITextView, a third-party view, or want to introduce some custom behavior to the already provided UIKit component, you can create your own controller conforming to the StatsTextController protocol.

Protocol

func setItem(_ item: String?): Function called when new metadata are received.

Example

Swift

public class LabelStatsController: StatsTextController {

  public let label: UILabel

  public init (label: UILabel) {
    self.label = label
  }

  public func setItem(_ item: String?) {
    label.text = item
  }

}

SwiftUI

InstantSearch provides the StatsTextObservableController data model, which is an implementation of the StatsTextController protocol adapted for usage with SwiftUI. StatsTextObservableController must be connected to the StatsConnector or StatsConnector like any other StatsTextController implementation.

The example of the current filters view presenting the grouped filters.

Swift

struct ContentView: View {

  @ObservedObject var statsController: StatsTextObservableController

  var body: some View {
    Text(statsController.stats)
  }

}

If you prefer to create a custom textual stats SwiftUI view, you can directly use the StatsTextObservableController as a data model. It provides the stats property to streamline the design process of your custom SwiftUI view.