List template

The List template presents information items in a list layout.

Lists may be separated into sections via sublists. For a version of this template with a map, navigation apps can use the Map template.

This template can be embedded in the Tab template to provide tabbed navigation.

Includes:

• Header with optional action strip (action strip is replaced with tabs when this template is embedded in the Tab template)
• List items (where the number of items and the amount of text in a row can vary):
  • Number of list items. The number of items allowed to be shown depends on the vehicle. To retrieve the list row limit for a given vehicle, use the ConstraintManager API.
  • Amount of text per item. Secondary text in list rows can be longer than 2 rows when parked. See More list text while parked.
• Optional floating action button

For more about what rows can include in this template, see Row options for List template only and the examples in Sample flows.

Note: There is a limit on the number of grid items allowed to be shown, but the limit will not be less than 6 and may be higher in some vehicles. To retrieve the item limit for a given vehicle, use the ConstraintManager API.

More list text when parked

The amount of secondary text allowed in each list row varies depending on whether the car is parked or driving. To minimize distraction, text is truncated to 2 lines while driving. Any content intended to be read while driving should be displayed at the beginning of the secondary text.

When parked, text can be longer than two lines.

When driving, text should be truncated to avoid causing distraction.

List template examples

The following Android Auto and Android Automotive OS (AAOS) examples were built using the List template.

Uniform list of locations (Android Auto example)

List with sections and toggle rows (Android Auto example)

Selectable list with radio buttons – no sections or non-selectable rows allowed (AAOS example)

List template UX requirements

App developers:

MUST	Include a section header when sections are present.
MUST NOT	Mix selectable list rows (rows with radio buttons) with other types of rows or separate them with sections.
SHOULD	Present default selections on selectable lists.
SHOULD	Have an action associated with each list item (information-only rows are not recommended).
SHOULD	Place content in secondary text that is intended to be read while driving near the beginning, to avoid truncation.
SHOULD NOT	Include both an action strip and a floating action button at the same time.
MAY	Divide list content into sections.
MAY	Mix rows that have toggle switches with other rows as needed.
MAY	Update row text and image or icon asset when user changes toggle state.