Optional header.
When this template is embedded in the
Tab template,
the header is replaced with tabs.
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.
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.
List of locationsList of recently-navigated locations
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
Include a header with an optional title and primary and secondary
actions.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-23 UTC."],[[["\u003cp\u003eThe List template displays information in a list format, which can be divided into sections using sublists and integrated with Tab or Map + Content templates.\u003c/p\u003e\n"],["\u003cp\u003eList items have varying amounts of allowed text depending on the car's state (parked or driving) and the vehicle's capabilities, and ideally, each item should have an associated action.\u003c/p\u003e\n"],["\u003cp\u003eThis template includes an optional header (or tabs when embedded), list items with varying text limits, and an optional floating action button for user interaction.\u003c/p\u003e\n"],["\u003cp\u003eWhile driving, secondary text in list items is truncated to two lines to minimize distraction, so crucial information should be placed at the beginning.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should utilize section headers, avoid mixing selectable rows with others, offer default selections on lists, and prioritize clear actions for each list item for optimal user experience.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\nThe List template presents information items in a list layout.\n\nLists may be separated into sections using sublists.\n\nThis template can be embedded in the\n[Tab template](/cars/design/create-apps/apps-for-drivers/templates/tab-template)\nto provide tabbed navigation.\n\nThis template can be included in the\n[Map + Content template](/cars/design/create-apps/apps-for-drivers/templates/map-content-template)\nto provide a list on a map. \n**Includes:**\n\n- Optional [header](/cars/design/create-apps/apps-for-drivers/components/header). When this template is embedded in the [Tab template](/cars/design/create-apps/apps-for-drivers/templates/tab-template), the header is replaced with tabs.\n- List items (where the number of items and the amount of text in a row can vary):\n - **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](https://developer.android.com/training/cars/apps#constraint-manager).\n - **Amount of text per item.** Secondary text in list rows can be longer than 2 rows when parked. See [More list text while parked](#parked).\n- Optional [floating action button](/cars/design/create-apps/apps-for-drivers/components/fab)\n\nFor more about what rows can include in this template, see\n[Row options for List template only](/cars/design/create-apps/apps-for-drivers/components/row#row-options)\nand the examples in [Sample flows](/cars/design/create-apps/sample-flows/overview).\n\n\u003cbr /\u003e\n\n| **Note:** There is a limit on the number of list 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](https://developer.android.com/training/cars/apps#constraint-manager).\n\nMore list text when parked\n\nThe amount of secondary text allowed in each list row varies depending on\nwhether the car is parked or driving. To minimize distraction, text is\ntruncated to 2 lines while driving. Any content intended to be read while\ndriving should be displayed at the beginning of the secondary text.\nWhen parked, text can be longer than two lines. When driving, text should be truncated to avoid causing distraction.\n\n\u003cbr /\u003e\n\nList template examples\n\nThe following Android Auto and Android Automotive OS (AAOS) examples were built\nusing the List template.\nList of locations List of recently-navigated locations\n\n\u003cbr /\u003e\n\nList template UX requirements\n\nApp developers:\n\n|--------------|--------------------------------------------------------------------------------------------------------------------|\n| **MUST** | Include a section header when sections are present. |\n| **MUST NOT** | Mix selectable list rows (rows with radio buttons) with other types of rows or separate them with sections. |\n| **SHOULD** | Present default selections on selectable lists. |\n| **SHOULD** | Have an action associated with each list item (information-only rows are not recommended). |\n| **SHOULD** | Place content in secondary text that is intended to be read while driving near the beginning, to avoid truncation. |\n| **SHOULD** | Include a header with an optional title and primary and secondary actions. |\n| **MAY** | Divide list content into sections. |\n| **MAY** | Mix rows that have toggle switches with other rows as needed. |\n| **MAY** | Update row text and image or icon asset when user changes toggle state. |"]]
