Concepts / Building Search UI / Conditional display
Aug. 20, 2019

Conditional Display

Handling no results

When a search returns no results, you might want to display specific content bringing the user back to a successful search. To do this, subscribe to the Searcher’s response and show your no-results UI when the response has no hits:

Example

1
2
3
4
5
6
7
searcher.response.subscribe {
    if (it == null || it.hitsOrNull.isNullOrEmpty()) {
        showNoResultsUI()
    } else {
        hideNoResultsUI()
    }
}

Handling errors

When an error occurs you might want to display some specific content helping the user go back to a search that was successful.

To be notified of errors, subscribe to the Searcher’s error field:

1
2
3
4
5
searcher.error.subscribe {
    if (it != null) {
        Log.e("TAG", "Error on search $query: ${it.message}")
    }
}

Handling empty query

By default, InstantSearch Android will always display results, even when the query is empty. In some cases you may want to hide the results on the empty query.

To override this default behavior, you can implement your own SearchBoxView. Instead of calling onQueryChanged (for search-as-you-type) or onQuerySubmitted with every query you want to execute, you only call them when the query is not empty:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
public class SearchBoxNoEmptyQuery(
    public val searchView: SearchView
) : SearchBoxView {

    override var onQueryChanged: Callback<String?>? = null
    override var onQuerySubmitted: Callback<String?>? = null

    init {
        searchView.setOnQueryTextListener(object : SearchView.OnQueryTextListener {

            override fun onQueryTextSubmit(query: String?): Boolean {
                query?.isNotEmpty()?.let { onQuerySubmitted?.invoke(query) }
                return false
            }

            override fun onQueryTextChange(query: String?): Boolean {
                query?.isNotEmpty()?.let { onQuerySubmitted?.invoke(query) }
                return false
            }
        })
    }

    override fun setText(text: String?) {
        searchView.setQuery(text, false)
    }
}

Did you find this page helpful?