<br />

Watch Face Format version <button value="5" default="">Version 5</button> <button value="4">Version 4</button> <button value="3">Version 3</button> <button value="2">Version 2</button> <button value="1">Version 1</button>

*** ** * ** ***

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`](https://developer.android.com/training/wearables/wff/user-configuration/list-configuration) element
that's defined elsewhere in the watch face file.

Introduced in Wear OS 4.

## Syntax

```xml
<!-- 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`](https://developer.android.com/training/wearables/wff/user-configuration/list-configuration).

## 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:

- [`Group`](https://developer.android.com/training/wearables/wff/group/group)
- [`PartText`](https://developer.android.com/training/wearables/wff/group/part/text/part-text)
- [`PartImage`](https://developer.android.com/training/wearables/wff/group/part/image/part-image)
- [`PartAnimatedImage`](https://developer.android.com/training/wearables/wff/group/part/animated-image/part-animated-image)
- [`PartDraw`](https://developer.android.com/training/wearables/wff/group/part/draw/part-draw)
- [`Condition`](https://developer.android.com/training/wearables/wff/common/condition)
- [`AnalogClock`](https://developer.android.com/training/wearables/wff/clock/analog-clock)
- [`DigitalClock`](https://developer.android.com/training/wearables/wff/clock/digital-clock)

## Recommended for you

- Note: link text is displayed when JavaScript is off
- [Group](https://developer.android.com/training/wearables/wff/group/group)
- [BooleanConfiguration](https://developer.android.com/training/wearables/wff/group/configuration/boolean-configuration)
- [Complication](https://developer.android.com/training/wearables/wff/complication/complication)
- [ComplicationSlot](https://developer.android.com/training/wearables/wff/complication/complication-slot)