> ## Documentation Index
> Fetch the complete documentation index at: https://algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Infinite Hits (Paging)

> Shows a paginated list of search results.

export const Filter = () => <Tooltip tip="A filter is a condition that limits which records Algolia returns. Filters often use one or more facet-value pairs, such as brand:Apple AND color:red. You can also filter by numeric values, dates, tags, booleans, or geographic constraints." cta="Filtering" href="/doc/guides/managing-results/refine-results/faceting">
    filter
  </Tooltip>;

## About this widget

A view with helpers that displays a paginated list of search results.

It uses Android Architecture Components'
[Paging library](https://developer.android.com/topic/libraries/architecture/paging)
and [LiveData](https://developer.android.com/topic/libraries/architecture/livedata) to provide lifecycle-aware,
observable search results that can be loaded as users scroll.

To add infinite hits to your search experience, add the following to your `build.gradle` file:

```groovy theme={"system"}
implementation 'com.algolia:instantsearch-android-paging3:4.+'
```

Use these components:

* [`Searcher`](/doc/api-reference/widgets/instantsearch/android) to handle your searches.
* `Paginator`. A pagination utility that will load hits incrementally.
* `PagingConfig` to configure loading behavior.
* `T`. A `data class` representing a search result.
* `FilterState` so that the paginated list refreshes when a <Filter /> changes.

As an alternative to this approach,
[the infinite scroll guide](/doc/guides/building-search-ui/ui-and-ux-patterns/infinite-scroll/android)
describes how to create an automatically scrolling infinite hits experience.

See also: [Searches without results](/doc/guides/building-search-ui/going-further/conditional-display/android#handling-no-results)

<Card title="Explore example code" icon="github" href="https://github.com/algolia/instantsearch-android/tree/master/examples/android">
  Browse the Infinite Hits (Paging) example code on GitHub.
</Card>

## Examples

```kotlin Kotlin icon=code theme={"system"}
class MyActivity : AppCompatActivity() {

    val searcher = HitsSearcher(
        applicationID = "YourApplicationID",
        apiKey = "YourSearchOnlyAPIKey",
        indexName = "YourIndexName"
    )
    val paginator = Paginator(
        searcher = searcher,
        pagingConfig = PagingConfig(pageSize = 10),
        transformer = { it.deserialize(Movie.serializer()) }
    )
    val filterState = FilterState()
    val adapter = MovieAdapter()
    val connection = ConnectionHandler()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        connection += filterState.connectPaginator(paginator)
        paginator.liveData.observe(this) { adapter.submitData(lifecycle, it) }
        searcher.searchAsync()
    }

    override fun onDestroy() {
        super.onDestroy()
        searcher.cancel()
        connection.disconnect()
    }
}

@Serializable
data class Movie(
    val title: String
)

class MovieViewHolder(val view: TextView) : RecyclerView.ViewHolder(view) {

    fun bind(data: Movie) {
        view.text = data.title
    }
}

class MovieAdapter : PagingDataAdapter<Movie, MovieViewHolder>(MovieDiffUtil) {

    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MovieViewHolder {
        return MovieViewHolder(TextView(parent.context))
    }

    override fun onBindViewHolder(holder: MovieViewHolder, position: Int) {
        val movie = getItem(position)

        if (movie != null) holder.bind(movie)
    }

    object MovieDiffUtil : DiffUtil.ItemCallback<Movie>() {

        override fun areItemsTheSame(oldItem: Movie, newItem: Movie): Boolean {
            return oldItem == newItem
        }

        override fun areContentsTheSame(oldItem: Movie, newItem: Movie): Boolean {
            return oldItem.title == newItem.title
        }
    }
}
```

### Compose UI

InstantSearch provides the `Paginator`,
which exposes a `flow` property for paging data and an `invalidate()` method to stop loading.
You must also connect `Paginator` to other components, such as `SearchBoxConnector`, `FilterState`, or `FacetListConnector`.

```kotlin Kotlin icon=code theme={"system"}
class MyActivity : AppCompatActivity() {
    val searcher = HitsSearcher(
        applicationID = "YourApplicationID",
        apiKey = "YourSearchOnlyAPIKey",
        indexName = "YourIndexName"
    )
    val pagingConfig = PagingConfig(pageSize = 10)
    val hitsPaginator = Paginator(searcher, pagingConfig) { it.deserialize(Movie.serializer()) }
    val searchBoxState = SearchBoxState()
    val searchBox = SearchBoxConnector(searcher)
    val connections = ConnectionHandler()

    init {
        connections += searchBox.connectView(searchBoxState)
        connections += searchBox.connectPaginator(hitsPaginator)
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            SearchBox(
                searchBoxState = searchBoxState
            )
            val hitsPaging = hitsPaginator.flow.collectAsLazyPagingItems()
            LazyColumn {
                items(hitsPaging) { movie ->
                    movie?.let { Text(it.title) }
                }
            }
        }
        searcher.searchAsync()
    }

    override fun onDestroy() {
        super.onDestroy()
        connections.disconnect()
        searcher.cancel()
    }
}
```