ListConfiguration

借助列表配置,用户在表盘编辑器中自定义表盘时便可以选择列表中的项。

此元素在 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
与 打开表盘主题编辑器最大尺寸应为 400x400 像素。
screenReaderText
与用户已启用 TalkBack 时使用的文本对应的资源 ID。