行是可自定义的组件,用于构建各种列表类型,例如包含数据或图片的列表。它们受模板支持,可以显示少量文本以及其他元素。

行变体

您可以通过添加图片、图标、按钮等来自定义行,从而为驾驶员解锁更多功能。以下示例展示了每个可用选项。

标题:必填。最多 2 行,第二行换行或在换行符后显示。

辅助文本:可选。最多 2 行,文本颜色可自定义。

内嵌图标:可选。位于主要文本或辅助文本中。

数字装饰:可选。通常用于指示未查看内容的数量,例如未读消息。

图片:可选

操作:在某些模板中使用时,行最多可以包含两个操作 按钮。

可浏览:如果将某行标记为可浏览,系统会提供一个 图标来指示这一点。可浏览的行还必须可点击(见下文),并且不能包含操作。

进度条

行的行为方式

  • 可点击:可选。可以标记行
  • 已启用:默认情况下,所有行都被视为已启用。您可以将某行标记为已停用,使其不可用,并且
  • 可编入索引:默认情况下,所有行都会按其标题文本编入索引,以便在支持此功能的模板中使用时按 字母顺序排序。您可以标记行

模板支持

以下模板支持行:

行项目

除了主要文本和辅助文本以及图片或图标之外,列表模板中的行还可以包含以下任何内容:

切换开关:可选

单选按钮:可选。仅在可选择的列表中使用,这些列表的所有行都必须包含单选按钮。

较长的辅助文本:如果辅助文本超过 2 行,则在驾驶时会被 截断。只有在停车时才会显示全文。

指南

包含切换开关的行不能包含单选按钮,反之亦然。此外,在包含切换开关或单选按钮的列表中,不会使用尖角号。不过,包含其中任一选项的行也可以包含图片或图标以及换行文本。

停车时的行

停车时,您可以在行中添加较长的文本,如以下示例所示。

资源

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