> ## Documentation Index
> Fetch the complete documentation index at: https://algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Hits
> Shows a list of search results.
{/* vale Algolia.HeadingPronouns = NO */}
## About this widget
Use the `Hits` view and helper components to display a list of search results.
Use [`HitsPaging`](/doc/api-reference/widgets/infinite-hits/android) if you want to use [infinite scrolling](/doc/guides/building-search-ui/ui-and-ux-patterns/infinite-scroll/android) in your search.
To add `Hits` to your search experience, use these components:
* `Searcher`. The [`Searcher`](/doc/api-reference/widgets/instantsearch/android) that handles your searches.
* `T`. A `data class` representing a search result.
* `HitsView`. The view that renders objects of type `T`.
See also:
* [Get started with imperative UI](/doc/guides/building-search-ui/getting-started/how-to/programmatically/android)
* [Multi-index search](/doc/guides/building-search-ui/ui-and-ux-patterns/multi-index-search/android)
* [Searches without results](/doc/guides/building-search-ui/going-further/conditional-display/android#handling-no-results)
Browse the Hits example code on GitHub.
## Examples
You can use `deserialize` to convert raw hits into your own `data class` using the `Serializable` annotation.
```kotlin Kotlin icon=code theme={"system"}
class MyActivity : AppCompatActivity() {
val searcher = HitsSearcher(
applicationID = "YourApplicationID",
apiKey = "YourSearchOnlyAPIKey",
indexName = "YourIndexName"
)
val connection = ConnectionHandler()
val adapter = MovieAdapter()
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
connection += searcher.connectHitsView(adapter) { response ->
response.hits.deserialize(Movie.serializer())
}
searcher.searchAsync()
}
override fun onDestroy() {
super.onDestroy()
connection.disconnect()
searcher.cancel()
}
}
@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 : RecyclerView.Adapter(), HitsView {
private var movies: List = listOf()
override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): MovieViewHolder {
return MovieViewHolder(TextView(parent.context))
}
override fun onBindViewHolder(holder: MovieViewHolder, position: Int) {
val movie = movies[position]
holder.bind(movie)
}
override fun setHits(hits: List) {
movies = hits
notifyDataSetChanged()
}
override fun getItemCount(): Int {
return movies.size
}
}
```
### Compose UI
InstantSearch provides the `LoadingState` as a state model, which is an implementation of the `LoadingView` interface.
You need to connect `LoadingState` to the `LoadingConnector` or `LoadingViewModel` like any other `LoadingView` implementation.
```kotlin Kotlin icon=code theme={"system"}
class MyActivity : AppCompatActivity() {
val searcher = HitsSearcher(
applicationID = "YourApplicationID",
apiKey = "YourSearchOnlyAPIKey",
indexName = "YourIndexName"
)
val hitsState = HitsState()
val connections = ConnectionHandler()
init {
connections += searcher.connectHitsView(hitsState) {
it.hits.deserialize(Movie.serializer())
}
}
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContent {
LazyColumn {
items(hitsState.hits) { movie ->
Text(movie.title)
}
}
}
searcher.searchAsync()
}
override fun onDestroy() {
super.onDestroy()
connections.disconnect()
searcher.cancel()
}
}
```
## Parameters
A function transforming the search response into a list of results of your class `T`.
```kotlin Kotlin icon=code theme={"system"}
import com.algolia.client.model.search.SearchResponse
val transform: (SearchResponse) -> List = { response ->
response.hits.map { hit -> Movie(hit.json.getPrimitive("title").content) }
}
searcher.connectHitsView(adapter, transform)
```