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
設定值的專屬 ID。
displayName
與錶面編輯器所顯示文字相對應的資源 ID。
defaultValue
如果使用者未明確變更錶面編輯器的設定，系統會使用預設值。這個項目應設為其中一個內部 ListOption 元素的 id。

選用屬性

選用屬性包括：

icon
與錶面編輯器所顯示可繪製資源相對應的資源 ID。
screenReaderText
當使用者已啟用 TalkBack，與其所用文字相對應的資源 ID。

內部元素

ListConfiguration 元素可包含 1 到 100 個內部 ListOption 元素。

ListOption 屬性

ListOption 元素必須包含下列屬性：

id
選項值的專屬 ID。
displayName
與錶面編輯器所顯示文字相對應的資源 ID。

ListOption 元素可選擇包含下列屬性：

icon
與錶面編輯器所顯示可繪製資源相對應的資源 ID。此大小的大小上限為 400x400 像素。
screenReaderText
當使用者已啟用 TalkBack，與其所用文字相對應的資源 ID。