ListConfiguration

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:

 Optional attributes

Each ListOption inner element can have the following optional attributes:

childSettingIds
Defines a list of User Style Setting IDs that become modifiable only when this ListOption is selected. This creates a nested hierarchy with a maximum allowed depth of two levels (Parent → Child → Grandchild).
complicationSlotIds
Defines which complication slots are active for this option. If a ComplicationSlot is linked to specific ListOptions, it is only enabled when those options are selected. If a slot is not linked to any ListOption, it remains enabled by default across all choices.