Text

Specifies a plain-text configuration.

Introduced in Wear OS 4.

Syntax

<Text align="START | CENTER | END" ellipsis="boolean"
      maxLines="integer" isAutoSize="boolean">
    <!-- Possible inner elements. The PartText element syntax shows a
         more complete example. -->
    <Font ... />
    <BitmapFont ... />
</Text>

Attributes

The Text element has the following optional attributes:

align

Determines the text's alignment within its parent element:

  • START: left- or top-aligned (right-aligned when the current language uses an RTL text direction)
  • CENTER: center-aligned
  • END: right- or bottom-aligned (left-aligned when the current language uses an RTL text direction)

The default value is CENTER.

ellipsis

A boolean value that indicates whether to show an ellipsis if the text is too long to fit in the parent element. The default is FALSE.

maxLines

A non-zero integer that indicates the maximum number of lines that the parent element can use to display the text. If this value is less than 0, the watch face arranges the text in the optimal number of lines for taking up the parent element's height.

isAutoSize

Downscales the font size to fit the bounds of the containing PartText, with a minimum font size of 12px. If used in conjunction with ellipsis, first the text is scaled down, then if the text still exceeds the bounds, the ellipsis is applied.

Inner elements

The Text element can contain any number of the following inner elements: