Konfiguracja listy

Konfiguracja listy umożliwia użytkownikowi wybranie 1 elementu 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, gdy użytkownik nie zmieni konfiguracji w edytorze tarczy zegarka. Powinna być ustawiona na id jednego z wewnętrznych elementów ListOption.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

icon
Identyfikator zasobu odpowiadający obiektowi rysowalnemu, który jest wyświetlany w edytorze tarczy 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 obiektowi rysowalnemu, który jest wyświetlany w edytorze tarczy zegarka. Jego maksymalny rozmiar to 400 x 400 pikseli.
screenReaderText
Identyfikator zasobu odpowiadający tekstowi używanemu, gdy użytkownik ma włączoną funkcję TalkBack.