ColorConfiguration

ColorConfiguration 可讓使用者運用錶面編輯器變更錶面元素的顏色。

如已定義 ColorConfiguration，其他元素的顏色屬性 (例如 tintColor) 就可以透過採用 ColorConfiguration 和 ColorOption ID 值的運算式，參照設定中的顏色。如需完整示範，請參閱「範例」一節。

這項元素已在 Wear OS 4 推出。

語法

<ColorConfiguration id="string" displayName="string" icon="string"
                    screenReaderText="string" defaultValue="string">
  <ColorOption id="string" displayName="string" screenReaderText="string"
               icon="string" colors="argb-color-list" />
  ...
</ColorConfiguration>

範例

假設已定義下列顏色設定 (ID 值為 themeColor)：

<ColorConfiguration id="themeColor" defaultValue="0"
                    displayName="color_selector_display_name">
    <ColorOption id="0" displayName="color_theme_0" colors="#ff000000 #ff888888 #ffffffff"/>
    <ColorOption id="1" displayName="color_theme_1" colors="#ffff0000 #ffff8800 #ffffff00"/>
    <ColorOption id="2" displayName="color_theme_2" colors="#ff00ff00 #ff00ff88 #ff00ffff"/>
    <ColorOption id="3" displayName="color_theme_3" colors="#ff0000ff #ff8800ff #ffff00ff"/>
</ColorConfiguration>

這項設定代表可選擇四個調色盤，每個調色盤包含三種顏色。

如果 colors 屬性只包含單一值，請按照以下方式參照主題，例如，設定 tintColor 的方式如下：

<PartText ... tintColor="[CONFIGURATION.themeColor]">

如果 colors 屬性的調色盤含有多個值，請按照以下範例所示參照索引。具體而言，這個範例說明如何在所選 ColorOption 中選取第二個顏色：

<PartText ... tintColor="[CONFIGURATION.themeColor.1]">

屬性

ColorConfiguration 元素的屬性如下：

必要屬性

必要屬性包括：

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

選用屬性

選用屬性包括：

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

內部元素

ColorConfiguration 元素可包含 1 到 100 個內部 ColorOption 元素。

ColorOption 屬性

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

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

ColorOption 元素必須包含下列其中一個屬性：

colors
以空格分隔的 ARGB 顏色值清單。

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

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