列表配置

在手表表盘编辑器中自定义表盘时，列表配置允许用户从列表中选择一项。

Wear OS 4 中引入。

语法

<ListConfiguration id="string" displayName="string" icon="string"
                         screenReaderText="string" defaultValue="string"
>
  <ListOption id="string" displayName="string" screenReaderText="string"
                  icon="string" />
  ...
</ListConfiguration>

属性

ListConfiguration 元素具有以下属性

必需属性

以下属性是必需的

id
配置值的唯一标识符。
displayName
对应于在手表表盘编辑器中显示的文本的资源 ID。
defaultValue
如果用户未在手表表盘编辑器中显式更改配置，则使用的默认配置值。这应设置为内部 ListOption 元素之一的 id。

可选属性

以下属性是可选的

icon
对应于在手表表盘编辑器中显示的可绘制资源的资源 ID。
screenReaderText
如果用户启用了 TalkBack，则使用的文本的资源 ID。

内部元素

ListConfiguration 元素可以包含 1 到 100 个内部 ListOption 元素。

ListOption 属性

ListOption 元素必须包含以下属性

id
选项值的唯一标识符。
displayName
对应于在手表表盘编辑器中显示的文本的资源 ID。

ListOption 元素可以选择包含以下属性

icon
对应于在手表表盘编辑器中显示的可绘制资源的资源 ID。其最大尺寸应为 400x400 像素。
screenReaderText
如果用户启用了 TalkBack，则使用的文本的资源 ID。