列表配置允许用户在表盘编辑器中自定义表盘时从列表中选择一项。
在 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。