列表模板

List 模板以列表布局呈现信息项。

可以使用子列表将列表划分为多个部分。

此模板可嵌入到 Tab 模板中，以提供标签页式导航。

可以将此模板包含在“地图 + 内容”模板中，以在地图上提供列表。

包含：

• （可选）标头。 当此模板嵌入到 Tab 模板中时，标题会替换为标签页。
• 列表项（一行中的项目数量和文本数量可能会有所不同）：
  • 列表项的数量。允许显示的内容数量取决于车辆。如需检索给定车辆的列表行数上限，请使用 ConstraintManager API。
  • 每件商品的文字量。列表行中的次要文本在停车状态下可以超过 2 行。请参阅停车状态下的更多列表文本。
• 可选的悬浮操作按钮

如需详细了解此模板中可包含哪些行，请参阅仅适用于列表模板的行选项和示例流中的示例。

注意：允许显示的列表项数量存在限制，但此限制不会少于 6 个，在某些车辆中可能会更高。如需检索指定车辆的物品限制，请使用 ConstraintManager API。

停车后显示更多列表文字

每个列表行中允许的辅助文本数量取决于汽车是处于停车状态还是正在行驶中。为了最大限度地减少干扰，文本在驾车时会被截断为 2 行。任何要在驾车时阅读的内容都应显示在辅助文本的开头。

处于停车状态时，文本可以超过两行。

在驾车时，应截断文本，以免分散注意力。

列表模板示例

以下 Android Auto 和 Android Automotive OS (AAOS) 示例是使用 List 模板构建的。

位置列表

最近浏览的位置列表

列出模板用户体验要求

应用开发者：

必需	包含章节时添加章节标题。
不得	将可选的列表行（带有单选按钮的行）与其他类型的行混合使用，或者使用部分将它们分隔开。
应当	在可选列表中显示默认选择。
应当	具有与每个列表项关联的操作（不推荐仅包含信息的行）。
应当	将要在驾车时阅读的辅助文本内容放在靠近开头的位置，以免被截断。
应当	添加一个标题，其中包含可选标题以及主要操作和辅助操作。
可以	将列表内容划分为多个部分。
可以	根据需要将具有切换开关的行与其他行混合使用。
可以	在用户更改切换状态时更新行文字、图片或图标素材资源。