小工具
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
小工具是錶面上的 UI 元素,可透過一目瞭然的方式顯示使用者一整天需要查看的資訊。舉例來說,您可以建立目前天氣小工具,或心率小工具。

使用者體驗原則
以下各節說明建立小工具需要注意的原則。
一目瞭然 |
以內容為主 |
注意隱私安全 |
小工具是小型元件,目的在協助使用者快速完成經常性操作。因此,請力求內容精簡易懂。 |
小工具最大的價值,就是讓使用者抬起手腕就能看到所需內容,不用進行其他操作。 |
由於手錶屬於隨身佩戴物件,在思考小工具內容時,請設身處地考量使用者所處環境與使用情境。 |
用途
使用者輕觸小工具後,小工具即可協助他們存取應用程式的特定部分。此外,小工具也能執行獨立操作。舉例來說,可以藉由輕觸喝水計數器小工具變更喝水杯數。

WearOS 會自動加入應用程式捷徑小工具,因此您不必自行建立這類內容,請改將重心放在製作有助於使用者完成重點工作的小工具。
類型
小工具類型是指小工具上顯示的資料種類,或資料來源提供的資料類型。小工具一律設有內含必填和選填欄位的單一類型。必填欄位含有主要資料。小工具類型名稱多半取自於必填欄位。您可以決定錶面能顯示的小工具數量及支援的小工具類型。小工具共有五種類型。
類型 |
必填欄位 |
選填欄位 |
類別名稱 |
範例 |
SHORT_TEXT |
簡短文字 |
圖示、 影像烙印防護功能圖示、 簡短名稱 |
ShortTextComplicationData |
 |
ICON |
圖示 |
影像烙印防護功能圖示 |
MonochromaticImageComplicationData |
 |
RANGED_VALUE |
值 最小值 最大值 |
圖示、 影像烙印防護功能圖示、 簡短文字、 簡短名稱 |
RangedValueComplicationData |
 |
LONG_TEXT |
詳細文字 |
詳細名稱、 圖示、 影像烙印防護功能圖示、 小型圖片 |
LongTextComplicationData |
 |
SMALL_IMAGE |
小型圖片 |
|
SmallImageComplicationData |
 |
LARGE_IMAGE |
大型圖片 |
|
PhotoImageComplicationData |
 |
如要進一步瞭解小工具資料來源,請參閱「小工具類型」。
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[null,null,["上次更新時間:2025-07-27 (世界標準時間)。"],[],[],null,["# Complications\n\nA complication is a UI element on a watch face that contains highly-glanceable\ninformation that users want to see often throughout the day. For example, you\ncould create a current weather complication, or a heart rate complication.\n\nUX Principles\n-------------\n\nThe following sections describe principles to keep in mind when creating\ncomplications.\n\n|------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| Glanceable ---------- | Content forward --------------- | Privacy first ------------- |\n| Complications are small components designed to help users complete frequent tasks quickly. Make content simple and readable. | Complications are most valuable when the content that the user needs is made visible by simply raising their wrist, without needing further interaction. | The watch travels with the user everywhere they go. Consider how the content in the complications is relevant to the user's context. |\n\nUse cases\n---------\n\nWhen tapped, complications can help users access a specific part of an app.\nThey can also perform a self-contained action. For example, tapping a\nWater Count complication changes the glass count.\n\nWearOS automatically includes an app shortcut complication, so you don't need to\ncreate your own. Instead focus on creating complications that can help users\ncomplete focused tasks.\n\nTypes\n-----\n\nComplication types refer to the kinds of data shown on the complication or\nsupplied by a data source. A complication always has a single type that includes\nrequired and optional fields. A required field contains the primary data. Most\ncomplication types take their name from their required field. You can choose how\nmany complications to include in your watch face and the complication types to\nsupport. There are five complication types.\n\n| Type | Required fields | Optional fields | Class name | Example |\n|--------------|---------------------------|--------------------------------------------------------|--------------------------------------|---------|\n| SHORT_TEXT | Short text | Icon, Burn in protection icon, Short title | `ShortTextComplicationData` | |\n| ICON | Icon | Burn in protection icon | `MonochromaticImageComplicationData` | |\n| RANGED_VALUE | Value Min value Max value | Icon, Burn in protection icon, Short text, Short title | `RangedValueComplicationData` | |\n| LONG_TEXT | Long text | Long title, Icon, Burn in protection icon, Small image | `LongTextComplicationData` | |\n| SMALL_IMAGE | Small image | | `SmallImageComplicationData` | |\n| LARGE_IMAGE | Large image | | `PhotoImageComplicationData` | |\n\nFor more information about complication data sources, see\n[Complication types](/training/wearables/watch-faces/complications#types)."]]