列表模板

列表模板以垂直滚动方式显示或对话项的集合。当用户需要以文本格式快速浏览项目时(例如最近浏览过的地方或队列中的歌曲),列表非常有用。

借助列表模板,您可以:

  • 指示加载状态。
  • 使用子列表将列表分成多个部分。
  • 用作开关或单选按钮。

您还可以通过在标签页模板中嵌入列表来提供标签页式导航,并使用地图 + 内容模板在地图上显示列表。

列表模板
带有版块的列表模板
地图中的列表模板

包括:

  • 可选的标头:当此模板嵌入到标签页模板中时,标头会被替换为标签页。
  • 列表项(其中每行的项数和文本量可能会有所不同):
    • 列表项的数量。允许显示的商品数量取决于车辆。如需检索给定车辆的列表行限制,请使用 ConstraintManager API
    • 每个商品的文本量。在停靠状态下,列表行中的辅助文本可以超过 2 行。请参阅停车时显示更多列表文本
  • 可选的悬浮操作按钮

如需详细了解如何处理列表模板中的行,请参阅仅适用于列表模板的行选项以及示例流程中的示例。

停车时显示更多列表文字

每个列表行中允许的辅助文本量因车辆是停放还是行驶而异。为尽量减少干扰,驾车时文本会被截断成 2 行。任何要在驾驶时阅读的文本都应显示在辅助文本的开头。

驾驶中
停车后

列出模板用户体验要求

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

资源

类型 链接
API 参考文档 ListTemplate, ListTemplate.Builder