ColorConfiguration

ColorConfiguration memberi pengguna opsi untuk mengubah warna elemen tampilan jam melalui editor tampilan jam.

Saat ColorConfiguration ditentukan, atribut berbasis warna dari elemen lain, seperti tintColor, dapat merujuk ke warna dari konfigurasi menggunakan ekspresi yang menggunakan nilai ID ColorConfiguration dan ColorOption. Untuk demonstrasi lengkap, lihat contoh.

Diperkenalkan di Wear OS 4.

Sintaksis

<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>

Contoh

Misalkan konfigurasi warna berikut, dengan nilai ID themeColor, ditentukan:

<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>

Konfigurasi ini mewakili pilihan empat palet, yang setiap paletnya berisi tiga warna.

Jika atribut colors hanya berisi satu nilai, referensikan tema seperti berikut, misalnya, untuk menyetel tintColor:

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

Jika atribut colors berisi palet yang memiliki lebih dari satu nilai, referensikan indeks seperti yang ditunjukkan dalam contoh berikut. Secara khusus, contoh ini menunjukkan pemilihan warna kedua dalam ColorOption yang dipilih:

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

Atribut

Elemen ColorConfiguration memiliki atribut berikut:

Atribut wajib

Atribut berikut wajib diisi:

id
ID unik untuk nilai konfigurasi.
displayName
ID resource yang sesuai dengan teks yang ditampilkan di editor tampilan jam.
defaultValue
Nilai konfigurasi default yang digunakan jika pengguna tidak secara eksplisit mengubah konfigurasi di editor tampilan jam. Nilai ini harus disetel ke id dari salah satu elemen ColorOption bagian dalam.

Atribut opsional

Atribut berikut bersifat opsional:

icon
ID resource yang sesuai dengan resource drawable yang ditampilkan di editor tampilan jam. Gambar ini harus memiliki ukuran maksimum 400x400 piksel.
screenReaderText
ID resource yang sesuai dengan teks yang digunakan jika pengguna telah mengaktifkan TalkBack.

Elemen dalam

Elemen ColorConfiguration dapat berisi antara 1 hingga 100 elemen dalam ColorOption.

Atribut ColorOption

Elemen ColorOption harus berisi atribut berikut:

id
ID unik untuk nilai opsi.
displayName
ID resource yang sesuai dengan teks yang ditampilkan di editor tampilan jam.

Elemen ColorOption harus berisi salah satu atribut berikut:

colors
Daftar nilai warna ARGB yang dipisahkan spasi.

Secara opsional, elemen ColorOption dapat berisi atribut berikut:

icon
ID resource yang sesuai dengan resource drawable yang ditampilkan di editor tampilan jam.
screenReaderText
ID resource yang sesuai dengan teks yang digunakan jika pengguna telah mengaktifkan TalkBack.