ЦветКонфигурация

ColorConfiguration дает пользователю возможность изменить цвет элементов циферблата с помощью редактора циферблата.

Когда ColorConfiguration определен, любой цветной атрибут другого элемента, например, tintColor , может ссылаться на цвет из конфигурации с помощью выражения, которое использует значения идентификаторов ColorConfiguration и ColorOption . Полную демонстрацию смотрите в примере .

Представлено в 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>

Пример

Предположим, что определена следующая цветовая конфигурация со значением идентификатора 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
Уникальный идентификатор значения конфигурации.
displayName
Идентификатор ресурса, соответствующий тексту, отображаемому в редакторе циферблата.
defaultValue
Значение конфигурации по умолчанию, используемое, если пользователь не меняет конфигурацию явным образом в редакторе циферблатов. Должен быть установлен id одного из внутренних элементов ColorOption .

Дополнительные атрибуты

Следующие атрибуты являются необязательными:

icon
Идентификатор ресурса, соответствующий доступному ресурсу, который отображается в редакторе циферблатов. Максимальный размер должен составлять 400x400 пикселей.
screenReaderText
Идентификатор ресурса, соответствующий тексту, который используется, если у пользователя включен TalkBack.

Внутренние элементы

Элемент ColorConfiguration может содержать от 1 до 100 внутренних элементов ColorOption .

Атрибуты ColorOption

Элемент ColorOption должен содержать следующие атрибуты:

id
Уникальный идентификатор значения опции.
displayName
Идентификатор ресурса, соответствующий тексту, отображаемому в редакторе циферблата.

Элемент ColorOption должен содержать один из следующих атрибутов:

colors
Список значений цветов ARGB, разделенный пробелами.

Элемент ColorOption может дополнительно содержать следующие атрибуты:

icon
Идентификатор ресурса, соответствующий доступному ресурсу, который отображается в редакторе циферблатов.
screenReaderText
Идентификатор ресурса, соответствующий тексту, который используется, если у пользователя включен TalkBack.
{% дословно %} {% дословно %} {% дословно %} {% дословно %}