ComplicationSlot

<ph type="x-smartling-placeholder"></ph>

复杂功能显示槽是表盘上的一个区域,用户可在此区域内添加复杂功能。复杂功能显示槽包含 Complication 元素,这些元素用于定义针对不同复杂功能类型和不同表盘模式呈现复杂功能的方式。

此元素在 Wear OS 4 中推出。

语法

<ComplicationSlot x="integer" y="integer" width="integer"
             height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer" slotId="integer"
             name="string" displayName="string" scaleX="float" scaleY="float"
             supportedTypes="string" isCustomizable="boolean"
             tintColor="argb-color | rgb-color" />

属性

ComplicationSlot 具有以下属性。

必需属性

以下属性是必需属性:

xywidthheight
用于指定元素的尺寸和位置的整数集合。
slotId
槽的唯一数字标识符。
supportedTypes
可用于填充槽的支持的复杂功能类型的列表。 支持的值包括 SHORT_TEXTLONG_TEXTMONOCHROMATIC_IMAGESMALL_IMAGEPHOTO_IMAGERANGED_VALUEEMPTY。可以支持多种复杂功能类型,只需以空格进行分隔即可(例如,SHORT_TEXT RANGED_VALUE)。

可选属性

以下属性是可选属性:

pivotXpivotY
表示元素围绕其旋转的二维轴心点。这两个值都是浮点数,且均会经过调整以符合 $ [0, 1] $ 这一范围。
angle
表示元素围绕轴心点顺时针旋转时应遵循的角度值。
alpha
用于设置此元素应具有的透明度。值 0 表示此元素应是完全透明的。值 255 表示此元素应是完全不透明的。
scaleX
要应用于此元素的横向缩放比例。
scaleY
要应用于此元素的纵向缩放比例。
tintColor
对此元素应用色调滤镜。您必须使用 ARGB 格式(#ff000000 = 不透明的黑色)或 RGB 格式(#000000 = 黑色)指定颜色。
displayName
与复杂功能显示槽的本地化名称对应的资源 ID,此 ID 会显示在表盘编辑器中。
isCustomizable
决定用户是否可以在表盘编辑器中更改此槽的提供程序。默认设置为 TRUE

内部元素

ComplicationSlot 元素必须只包含一个边界区域元素。

对于每个支持的复杂功能类型,ComplicationSlot 元素必须至少包含一个 Complication 元素。ComplicationSlot 元素可以选择包含更多 Complication 元素,以支持使用 Variant 元素更改外观。

ComplicationSlot 元素还可以包含以下内部元素:

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