ListConfiguration

목록 구성을 사용하면 사용자가 시계 화면 편집기에서 시계 화면을 맞춤설정할 때 목록에서 하나의 항목을 선택할 수 있습니다.

Wear OS 4에서 도입되었습니다.

문법

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

속성

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

필수 속성

다음 속성은 필수입니다.

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

선택사항 속성

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

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

내부 요소

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

ListOption 속성

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

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

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

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