Widżety
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Widżet to element interfejsu na tarczy zegarka, który zawiera informacje, które użytkownicy chcą mieć na oku i chcą widzieć często w ciągu dnia. Możesz na przykład utworzyć widżet aktualnej pogody lub tętna.
Zasady UX
W sekcjach poniżej znajdziesz zasady, o których należy pamiętać podczas tworzenia widżetów.
Glanceable |
Przesyłanie treści |
Prywatność na pierwszym miejscu |
| Komplikacje to małe komponenty, które pomagają użytkownikom szybko wykonywać często wykonywane czynności. Spraw, aby treści były proste i czytelne. |
Komplikacje są najbardziej przydatne, gdy treści, których potrzebuje użytkownik, są widoczne po podniesieniu nadgarstka, bez konieczności dalszej interakcji. |
Zegarek jest zawsze przy użytkowniku. Zastanów się, czy treści w komplikacjach są odpowiednie do kontekstu użytkownika. |
Przypadki użycia
Po kliknięciu komplikacje mogą pomóc użytkownikom uzyskać dostęp do określonej części aplikacji. Mogą też wykonać samodzielne działanie. Na przykład kliknięcie widżetu Liczba szklanek zmienia liczbę szklanek.
Wear OS automatycznie zawiera widżet skrótu aplikacji, więc nie musisz tworzyć własnego. Zamiast tego skup się na tworzeniu komplikacji, które mogą pomóc użytkownikom w wykonaniu określonych zadań.
Typy
Typy widżetów dotyczą rodzajów danych wyświetlanych na widżecie lub dostarczanych przez źródło danych. Komplikacja ma zawsze jeden typ, który zawiera wymagane i opcjonalne pola. Wymagane pole zawiera podstawowe dane. Większość typów widżetów bierze swoją nazwę od wymaganego pola. Możesz wybrać, ile widżetów chcesz uwzględnić na tarczy zegarka oraz jakie typy widżetów chcesz obsługiwać. Istnieją 5 typów widżetów.
| Typ |
Pola wymagane |
Pola opcjonalne |
Nazwa zajęć |
Przykład |
| SHORT_TEXT |
Krótki tekst |
Ikona,
Ikona ochrony przed wypaleniem,
Krótki tytuł |
ShortTextComplicationData |
 |
| IKONA |
Ikona |
Ikona ochrony przed wypaleniem pikseli |
MonochromaticImageComplicationData |
 |
| RANGED_VALUE |
Wartość
Wartość minimalna
Wartość maksymalna |
Ikona,
Ikona ochrony przed wypaleniem,
Krótki tekst,
Krótki tytuł |
RangedValueComplicationData |
 |
| LONG_TEXT |
Długi tekst |
Długi tytuł,
Ikona,
Ikona ochrony przed wypaleniem,
Mały obraz |
LongTextComplicationData |
 |
| SMALL_IMAGE |
Mały obraz |
|
SmallImageComplicationData |
 |
| LARGE_IMAGE |
Duży obraz |
|
PhotoImageComplicationData |
 |
Więcej informacji o źródłach danych dotyczących powikłań znajdziesz w artykule Typy powikłań.
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-27 UTC."],[],[],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)."]]
