ColorConfiguration

ColorConfiguration은 사용자가 시계 화면 편집기를 통해 시계 화면 요소의 색상을 변경할 수 있는 옵션을 제공합니다.

ColorConfiguration이 정의된 경우 다른 요소의 색상 기반 속성(예: tintColor)은 ColorConfigurationColorOption의 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" colors="#ff000000 #ff888888 #ffffffff"/>
    <ColorOption id="1" colors="#ffff0000 #ffff8800 #ffffff00"/>
    <ColorOption id="2" colors="#ff00ff00 #ff00ff88 #ff00ffff"/>
    <ColorOption id="3" colors="#ff0000ff #ff8800ff #ffff00ff"/>
</ColorConfiguration>

이 구성은 각각 3가지 색상이 포함된 4가지 팔레트 중 하나를 나타냅니다.

colors 속성에 단일 값만 포함된 경우 다음과 같이 테마를 참조합니다. 예를 들어 tintColor로 설정합니다.

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

colors 속성에 값이 2개 이상인 팔레트가 포함된 경우 다음 예시와 같이 색인을 참조합니다. 이 예에서는 선택된 ColorOption에서 두 번째 색상을 선택하는 방법을 보여 줍니다.

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

속성

ColorConfiguration 요소는 다음과 같은 속성을 포함합니다.

필수 속성

다음 속성은 필수입니다.

id
구성 값의 고유 식별자입니다.
displayName
시계 화면 편집기에 표시되는 텍스트에 해당하는 리소스 ID입니다.
defaultValue
사용자가 시계 화면 편집기에서 구성을 명시적으로 변경하지 않는 경우 사용되는 기본 구성 값입니다. 이 값은 내부 ColorOption 요소 중 하나의 id로 설정해야 합니다.

선택사항 속성

다음 속성은 선택사항입니다.

icon
시계 화면 편집기에 표시되는 드로어블 리소스에 해당하는 리소스 ID입니다. 최대 크기는 400x400픽셀입니다.
screenReaderText
사용자가 TalkBack을 사용 설정한 경우 사용되는 텍스트에 해당하는 리소스 ID입니다.

내부 요소

ColorConfiguration 요소는 1~100개의 내부 ColorOption 요소를 포함할 수 있습니다.

ColorOption 속성

ColorOption 요소는 다음 속성을 포함해야 합니다.

id
옵션 값의 고유 식별자입니다.
displayName
시계 화면 편집기에 표시되는 텍스트에 해당하는 리소스 ID입니다.

ColorOption 요소는 다음 속성 중 하나를 포함해야 합니다.

colors
공백으로 구분된 ARGB 색상 값 목록입니다.

ColorOption 요소는 선택적으로 다음 속성을 포함할 수 있습니다.

icon
시계 화면 편집기에 표시되는 드로어블 리소스에 해당하는 리소스 ID입니다.
screenReaderText
사용자가 TalkBack을 사용 설정한 경우 사용되는 텍스트에 해당하는 리소스 ID입니다.