The Search template presents a search bar, keyboard, and results list to enable users to perform searches, such as searching for destinations.
During drives, users can't access the keyboard, but they can use speech-to-text to perform searches and find previous results.
Search template include the following:
- Search bar header with optional action strip
- List rows for search results (within limits)
- Keyboard (when parked), which apps can choose to show or hide when the template is first displayed.
Apps can customize the background color of markers with any color. The color used for the map marker is applied to the list marker.
Search template examples
Search template UX requirements
App developers:
| MUST | Update the list when a user enters keywords. |
| SHOULD | Provide dynamic content (screen refresh) only to show search results during user input. |
| SHOULD | Show a loading indicator for searches that are expected to take longer than one second. |
| SHOULD | Either show content or launch a keyboard (if there is no content to show) when opening the template. |
| MAY | Display the keyboard as either expanded or collapsed when a user opens the template in a parked state (the keyboard is unavailable during the driving state). |
| MAY | Provide initial search text. |
| MAY | Provide hint text on the search bar. |
| MAY | Display a default list of past results or other relevant content. |
Resources
| Type | Link |
| API reference |
SearchTemplate, SearchTemplate.Builder
|