TextCircular

指定圆形或曲线文本配置。

此元素在 Wear OS 4 中推出。

语法

<TextCircular centerX="float" centerY="float"
              direction="CLOCKWISE | COUNTER_CLOCKWISE" width="float"
              height="float" startAngle="float-degrees"
              endAngle="float-degrees" align="START | CENTER | END"
              ellipsis="boolean" >
    <!-- Possible inner elements. The PartText element syntax shows a
         more complete example. -->
    <Transform .../>
    <Font ... />
    <BitmapFont ... />
</TextCircular>

属性

TextCircular 元素具有以下属性。某些属性是必需属性,其他则是可选属性。

必需属性

以下属性是必需属性:

centerXcenterY
一对浮点值,用于指定元素中心的位置。
widthheight
一对浮点值,用于指定元素的尺寸。
startAngleendAngle

一对浮点值,分别用于指定文本起始侧的角度和文本结束侧的角度。角度为 0 表示表盘上的 12 点位置。

例如,如需围绕表盘的顶部四分之一圆显示曲线文本,请将 startAngle 设为 335.0并将 endAngle 设为 45.0

可选属性

以下属性是可选属性:

direction

指示文本的书写方向:

  • CLOCKWISE(默认):按顺时针方向显示文本。
  • COUNTER_CLOCKWISE:按逆时针方向显示文本。
align

确定文本在其父元素中的对齐方式:

  • START:左对齐或上对齐(当前语言使用 RTL 文本方向时为右对齐)
  • CENTER:居中对齐
  • END:右对齐或下对齐(当前语言使用 RTL 文本方向时为左对齐)

默认值为 CENTER

ellipsis

一个布尔值,用于指示在文本过长,不适合父元素时,是否显示省略号。默认值为 FALSE

内部元素

Text 元素可以包含任意数量的以下内部元素:

  • 注意:当 JavaScript 处于关闭状态时,系统会显示链接文字
  • TextCircular
  • Arc
  • Text