ListConfiguration

This page is a fork of https://github.ecodesamsung.com/DWF/dwf-renderer/blob/develop/specification/documents/1, https://github.ecodesamsung.com/DWF/dwf-renderer/blob/develop/specification/documents/2, edited for grammatical accuracy.


Allows for conditionally showing a set of text and graphical elements based on the user's current selection from a list on a watch face options screen. This element references a user configuration ListConfiguration element that's defined elsewhere in the watch face file.

Introduced in Wear OS 4.

Syntax

<!-- The ID doesn't need to be "handColor"; this is just an example. -->
<UserConfiguration>
    <ListConfiguration id="handColor" />
</UserConfiguration>
<!-- ... -->
<ListConfiguration id="handColor">
    <ListOption id="0">
        <!-- Only the most common element is shown here -->
        <PartText ... />
    </ListOption>
    <!-- Subsequent "ListOption" elements have ID values of 1, 2, ... -->
    <ListOption id="1" ... />
</ListConfiguration>

Attributes

The ListConfiguration element has one required attribute, id. This is a string that must match the id value of a previously-defined user configuration ListConfiguration.

Inner elements

The ListConfiguration element must contain at least one ListOption inner element. Each ListOption contains an id value, and these ID values increase sequentially (0, 1, ...). Each ListOption element corresponds to the 0-based position of an item within a list of choices that the user sees on a watch face's options screen.

Each ListOption inner element can contain one of the following elements: