ListConfiguration

Cấu hình danh sách cho phép người dùng chọn một mục trong danh sách khi tuỳ chỉnh mặt đồng hồ trong trình chỉnh sửa mặt đồng hồ.

Ra mắt trong Wear OS 4.

Cú pháp

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

Thuộc tính

Phần tử ListConfiguration có các thuộc tính như sau:

Thuộc tính bắt buộc

Các thuộc tính sau đây là bắt buộc:

id

Mã nhận dạng duy nhất của giá trị cấu hình.

displayName

Mã tài nguyên tương ứng với văn bản xuất hiện trong trình chỉnh sửa mặt đồng hồ.

defaultValue

Giá trị cấu hình mặc định được sử dụng nếu người dùng không thể hiện rõ ràng việc thay đổi cấu hình trong trình chỉnh sửa mặt đồng hồ. Bạn nên đặt thuộc tính này thành id của một trong các phần tử ListOption bên trong.

Thuộc tính không bắt buộc

Các thuộc tính sau đây là không bắt buộc:

icon

Mã tài nguyên tương ứng với tài nguyên có thể vẽ xuất hiện trong trình chỉnh sửa mặt đồng hồ.

screenReaderText

Mã tài nguyên tương ứng với văn bản được sử dụng nếu người dùng bật TalkBack.

Phần tử bên trong

Phần tử ListConfiguration có thể chứa từ 1 đến 100 phần tử ListOption bên trong.

Thuộc tính ListOption

Phần tử ListOption phải có các thuộc tính sau:

id

Giá trị nhận dạng duy nhất của giá trị tuỳ chọn.

displayName

Mã tài nguyên tương ứng với văn bản xuất hiện trong trình chỉnh sửa mặt đồng hồ.

Phần tử ListOption có thể tuỳ ý chứa các thuộc tính sau:

icon

Mã tài nguyên tương ứng với tài nguyên có thể vẽ xuất hiện trong trình chỉnh sửa mặt đồng hồ. Hình ảnh này phải có kích thước tối đa là 400 x 400 pixel.

screenReaderText

Mã tài nguyên tương ứng với văn bản được sử dụng nếu người dùng bật TalkBack.