列表模板以垂直滚动方式显示行或对话项的集合。当用户需要以文本格式快速浏览项目时(例如最近浏览过的地方或队列中的歌曲),列表非常有用。
借助列表模板,您可以:
- 指示加载状态。
- 使用子列表将列表分成多个部分。
- 将行用作开关或单选按钮。
您还可以通过在标签页模板中嵌入列表来提供标签页式导航,并使用地图 + 内容模板在地图上显示列表。



包括:
- 可选的标头:当此模板嵌入到标签页模板中时,标头会被替换为标签页。
- 列表项(其中每行的项数和文本量可能会有所不同):
- 列表项的数量。允许显示的商品数量取决于车辆。如需检索给定车辆的列表行限制,请使用 ConstraintManager API。
- 每个商品的文本量。在停靠状态下,列表行中的辅助文本可以超过 2 行。请参阅停车时显示更多列表文本。
- 可选的悬浮操作按钮
如需详细了解如何处理列表模板中的行,请参阅仅适用于列表模板的行选项以及示例流程中的示例。
停车时显示更多列表文字
每个列表行中允许的辅助文本量因车辆是停放还是行驶而异。为尽量减少干扰,驾车时文本会被截断成 2 行。任何要在驾驶时阅读的文本都应显示在辅助文本的开头。


列出模板用户体验要求
最低要求 | 如果存在部分,则包含部分标题。 |
不得 | 将可选择的列表行(带有单选按钮的行)与其他类型的行混合,或使用部分将它们分开。 |
应该 | 在可选择的列表中显示默认选择。 |
应该 | 让每个列表项都关联一个操作(不建议使用仅包含信息的行)。 |
应该 | 将要在驾驶时阅读的次要文本内容放在开头附近,以避免被截断。 |
应该 | 应当包含一个标头,其中可选择性地添加标题以及主要和次要操作。 |
MAY | 将列表内容划分为多个部分。 |
MAY | 根据需要将包含切换开关的行与其他行混合。 |
MAY | 当用户更改切换开关状态时,更新行文本和图片或图标资源。 |
资源
类型 | 链接 |
API 参考文档 | ListTemplate, ListTemplate.Builder
|