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。
,瞭解如何調查及移除這項存取權。