A Complication element defines how a particular Complication Type is displayed on the watch face.
For each type of complication, you can use the following in expressions. This lets you access the data provided to the complication:
- All types, and
EMPTY
:[COMPLICATION.TYPE]
[COMPLICATION.TAP_ACTION]
LONG_TEXT
:[COMPLICATION.MONOCHROMATIC_IMAGE]
[COMPLICATION.MONOCHROMATIC_IMAGE_AMBIENT]
[COMPLICATION.TEXT]
[COMPLICATION.TITLE]
MONOCHROMATIC_IMAGE
:[COMPLICATION.MONOCHROMATIC_IMAGE]
[COMPLICATION.MONOCHROMATIC_IMAGE_AMBIENT]
PHOTO_IMAGE
:[COMPLICATION.PHOTO_IMAGE]
RANGED_VALUE
:[COMPLICATION.MONOCHROMATIC_IMAGE]
[COMPLICATION.MONOCHROMATIC_IMAGE_AMBIENT]
[COMPLICATION.TEXT]
[COMPLICATION.TITLE]
[COMPLICATION.RANGED_VALUE_MIN]
[COMPLICATION.RANGED_VALUE_MAX]
[COMPLICATION.RANGED_VALUE_VALUE]
SHORT_TEXT
:[COMPLICATION.MONOCHROMATIC_IMAGE]
[COMPLICATION.MONOCHROMATIC_IMAGE_AMBIENT]
[COMPLICATION.TEXT]
[COMPLICATION.TITLE]
SMALL_IMAGE
:[COMPLICATION.SMALL_IMAGE]
[COMPLICATION.SMALL_IMAGE_AMBIENT]
[COMPLICATION.IMAGE_STYLE]
- (corresponds to theSmallImageType
ordinal values)
For a complete demonstration, see the example.
Introduced in Wear OS 4.
Syntax
<Complication type="string"> <!-- Only the most common inner element is shown here. --> <Group> </Group> </Complication>
Example
The following example shows a complication that contains image, title, and text components:
<Complication type="SHORT_TEXT">
<PartImage x="35" y="16" width="22" height="22" pivotX="0.5" pivotY="0.5"
name="SomeIcon" alpha="255">
<Image resource="[COMPLICATION.MONOCHROMATIC_IMAGE]"/>
</PartImage>
<PartText x="18" y="39" width="56" height="22" pivotX="0.5" pivotY="0.5"
name="SomeText" alpha="255">
<Text align="CENTER" ellipsis="TRUE">
<Font family="SYNC_TO_DEVICE" size="20" weight="NORMAL"
slant="NORMAL" color="#ffffffff">
<Template>
%s
<Parameter expression="[COMPLICATION.TEXT]"/>
</Template>
</Font>
</Text>
</PartText>
<PartText x="19" y="62" width="54" height="14" pivotX="0.5" pivotY="0.5"
name="SomeTitle" alpha="255">
<Text align="CENTER" ellipsis="TRUE">
<Font family="SYNC_TO_DEVICE" size="12" weight="NORMAL"
slant="NORMAL" color="#ffadadad">
<Template>
%s
<Parameter expression="[COMPLICATION.TITLE]"/>
</Template>
</Font>
</Text>
</PartText>
</Complication>
Attributes
The ComplicationSlot
element must contain a type
attribute. The element is
rendered if the user chooses a matching complication type. Supported values are
SHORT_TEXT
, LONG_TEXT
, MONOCHROMATIC_IMAGE
, SMALL_IMAGE
, PHOTO_IMAGE
,
RANGED_VALUE
, and EMPTY
Inner elements
The Complication
element can contain any number of the following inner
elements:
Recommended for you
- Note: link text is displayed when JavaScript is off
- ComplicationSlot
- DefaultProviderPolicy
- BooleanConfiguration