ComplicationSlot

小工具版位是使用者可以新增小工具的錶面區域，包含小工具元素，可定義不同小工具類型和不同錶面模式下的小工具算繪方式。

這項元素已在 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 包含下列屬性：

必要屬性

必要屬性包括：

x、y、width、height
這是一組指定元素大小和位置的整數。
slotId
版位的專屬數字 ID。
supportedTypes
可填入版位的所支援小工具類型清單。支援的值為 SHORT_TEXT、LONG_TEXT、MONOCHROMATIC_IMAGE、SMALL_IMAGE、PHOTO_IMAGE、RANGED_VALUE 和 EMPTY。系統支援多種小工具類型，以空格分隔即可，例如 SHORT_TEXT RANGED_VALUE。

選用屬性

選用屬性包括：

pivotX、pivotY
與元素旋轉方向相關的 2D 樞紐點。兩個值都是浮點數，可在 $ [0, 1] $ 範圍內視需求調整。
angle
元素應以順時針方向從樞紐點旋轉的角度數值。
alpha
此屬性可設定元素應具備的透明度。如果值為 0，表示元素應完全透明；如果值為 255，則表元素應完全不透明。
scaleX
要套用至此元素的水平縮放比例係數。
scaleY
要套用至此元素的垂直縮放比例係數。
tintColor
為元素套用色調顏色濾鏡。必須使用 ARGB 格式 (#ff000000 = 不透明黑) 或 RGB 格式 (#000000 = 黑) 指定顏色。
displayName
與小工具版位的本地化名稱相對應的資源 ID，會顯示在錶面編輯器中。
isCustomizable
決定使用者是否可在錶面編輯器中變更版位的供應器。預設為 TRUE。

內部元素

ComplicationSlot 元素必須只包含一個邊界區域元素。

對於每個支援的小工具類型，ComplicationSlot 元素必須包含至少一個小工具元素。ComplicationSlot 元素可視需要包含更多小工具元素，支援採用 Variant 元素的可變動外觀。

ComplicationSlot 元素也可包含下列內部元素：