Konfiguracja listy

Konfiguracja listy pozwala użytkownikowi wybrać jeden element z listy podczas dostosowywania tarczy zegarka w edytorze tarcz zegarka.

Wprowadzona w Wear OS 4.

Składnia

<ListConfiguration id="string" displayName="string" icon="string"
                         screenReaderText="string" defaultValue="string"
>
  <ListOption id="string" displayName="string" screenReaderText="string"
                  icon="string" />
  ...
</ListConfiguration>

Atrybuty

Element ListConfiguration ma te atrybuty:

Atrybuty wymagane

Wymagane są te atrybuty:

id
Unikalny identyfikator wartości konfiguracji.
displayName
Identyfikator zasobu odpowiadający tekstowi wyświetlanemu w edytorze tarczy zegarka.
defaultValue
Domyślna wartość konfiguracji używana w sytuacji, gdy użytkownik nie zmieni bezpośrednio konfiguracji w edytorze tarcz zegarka. Należy ustawić go na id jednego z wewnętrznych elementów ListOption.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

icon
Identyfikator zasobu odpowiadający zasobowi, który można narysować, wyświetlany w edytorze tarcz zegarka.
screenReaderText
Identyfikator zasobu odpowiadający tekstowi używanemu, gdy użytkownik ma włączoną funkcję TalkBack.

Elementy wewnętrzne

Element ListConfiguration może zawierać od 1 do 100 wewnętrznych elementów ListOption.

Atrybuty ListOption

Element ListOption musi zawierać te atrybuty:

id
Unikalny identyfikator wartości opcji.
displayName
Identyfikator zasobu odpowiadający tekstowi wyświetlanemu w edytorze tarczy zegarka.

Element ListOption może opcjonalnie zawierać te atrybuty:

icon
Identyfikator zasobu odpowiadający zasobowi, który można narysować, wyświetlany w edytorze tarczy zegarka. Powinien mieć maksymalny rozmiar 400 x 400 pikseli.
screenReaderText
Identyfikator zasobu odpowiadający tekstowi używanemu, gdy użytkownik ma włączoną funkcję TalkBack.