Kanoniczne układy widżetów
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Aby utworzyć skuteczne układy widżetów, najpierw określ najważniejsze treści. Układ określa sposób porządkowania informacji i elementów interaktywnych w widżecie. Aby ułatwić ten proces, Android udostępnia kilka gotowych układów paska narzędzi, tekstu, listy i widżetów typu siatka.
Tekst
Układy tekstowe są idealne do wyświetlania zwięzłych informacji. Zwiększ atrakcyjność wizualną widżetu, dodając opcjonalnie obraz obok tekstu.
Tylko tekst
Idealne do tytułów, aktualizacji stanu, krótkich opisów lub innych sytuacji, w których jeden wiersz tekstu skutecznie przekazuje wiadomość. Aby dowiedzieć się więcej o dynamicznej zmianie rozmiaru tekstu na podstawie rozmiaru elementu Widget, zapoznaj się z przykładem kanonicznego układu.
Tekst i obraz
Dodaj obraz, aby wzmocnić przekaz wizualny. Więcej informacji znajdziesz w artykule Punkty kontrolne, w którym dowiesz się, jak dostosować ten układ do różnych rozmiarów ekranu.
Używaj układów paska narzędzi, aby zapewnić użytkownikom szybki dostęp do często wykonywanych zadań w aplikacji. Układ ten jest elastyczny i dostosowuje się do rozmiarów widżetów.
Pasek wyszukiwania
Układ paska narzędzi wyszukiwania jest celowo zaprojektowany tak, aby zwrócić uwagę na wyszukiwanie jako główne działanie na pasku narzędzi. Dodatkowe przyciski zapewniają szybki dostęp do często używanych funkcji.
Pasek narzędzi
Paski narzędzi zawierają logo aplikacji, a następnie przyciski do najczęściej wykonywanych czynności, które są idealne do przełączania ustawień lub linków do zadań. Podczas zmiany rozmiaru możesz ukryć rzadziej używane opcje, aby wyświetlić te, które są najczęściej używane. Użyj punktów kontrolnych, aby dodać nowy przycisk, który można kliknąć (o minimalnym rozmiarze 48 dp), gdy jest na to miejsce.
Listy
Użyj układów list, aby uporządkować wiele elementów w przejrzystym, łatwym do zeskanowania formacie. Jest to idealne rozwiązanie do nagłówków wiadomości, list rzeczy do zrobienia lub wiadomości. Uporządkuj treści w sposób ułatwiający ich przeglądanie. Wybierz prezentację z pojemnikiem lub bez niego na podstawie potrzeb związanych z treścią.
Lista tekstowa i obrazowa
Łatwo czytelne listy tekstów i obrazów są idealne do prezentowania wielu typów treści, takich jak nagłówki wiadomości, playlisty z okładką albumu czy wiadomości.
Lista kontrolna
Układ listy kontrolnej jest idealny do wyświetlania zadań. Zapewnia użytkownikom wyraźne miejsca do dotykania, dzięki którym mogą łatwo oznaczać elementy jako wykonane.
Lista działań
Zapewnij intuicyjne grupowanie elementów sterujących za pomocą list działań, gdzie wizualne stany włączenia/wyłączenia zapewniają natychmiastowy dostęp do stanu elementów.
Siatka
Prezentuj obrazy w kompaktowej, elastycznej i wizualnie atrakcyjnej siatce z opcjonalnymi etykietami.
Używaj kolumn i wierszy, które dostosowują się do różnych rozmiarów ekranu.
Tylko obraz
Tworzenie za pomocą siatek zawierających tylko obrazy atrakcyjnych, przewijalnych galerii obrazów. Wiersze i kolumny automatycznie dostosowują się do różnych rozmiarów ekranu, aby zapewnić optymalną prezentację.
Obraz i tekst
Możesz też dodać etykiety tekstowe i opisy, wzbogacając zawartość siatki obrazów o dodatkowy kontekst i informacje.
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,["# Canonical widget layouts\n\nCraft effective widget layouts by first identifying your core content. Your\nlayout dictates how information and interactive elements are organized within\nyour widget. Android offers several prebuilt layouts for toolbars, text, list\nand grid-type widgets to streamline this process.\n| **Note:** View detailed layout specs in our [Figma Widget Canonical Builder](https://goo.gle/widget-canonical), and find the code samples using Jetpack Glance in the [Android Platform Samples GitHub repository](https://github.com/android/platform-samples/tree/main/samples/user-interface/appwidgets/src/main/java/com/example/platform/ui/appwidgets/glance).\n\nText\n----\n\nText layouts are ideal for displaying concise information. Enhance the visual\nappeal of your widget by optionally including an image alongside the text. \n**Text only**\n\n\nIdeal for titles, status updates, short descriptions, or any scenario\nwhere a single line of text effectively conveys the message. Refer to the\n[Canonical layout sample](https://github.com/android/platform-samples/tree/main/samples/user-interface/appwidgets/src/main/java/com/example/platform/ui/appwidgets/glance)\nfor guidance on dynamically scaling text content based on widget size. \n**Text and image**\n\n\nInclude an image for added visual impact. For more information, see\n[Breakpoints](/design/ui/mobile/guides/widgets/sizing#breakpoints)\nto learn how to adapt this layout for different screen sizes.\n\nToolbars\n--------\n\nUse toolbar layouts to provide users with quick access to frequently used tasks\nin your app, in a flexible layout that adapts across widget sizes. \n**Search Toolbar**\n\n\nA search toolbar layout is intentionally designed to draw focus to search\nas a primary action in the toolbar. Additional handy buttons can provide\nquick access to frequently used functions.\n\n\n**Toolbar**\n\n\nToolbars presents app branding followed by buttons for the most used tasks\nthat are ideal for toggleable settings or task links. When resizing, less\ncommonly used options can be hidden in favor of more common actions. Use\n[Breakpoints](/design/ui/mobile/guides/widgets/sizing#breakpoints)\nto add a new minimum 48dp tappable button when there's room.\n\n\u003cbr /\u003e\n\nLists\n-----\n\nUse list layouts to organize multiple items in a clear, scannable format. This\nis ideal for news headlines, to-do lists or messages. Organize content into a\nstructured, easily scannable list. Choose between containerized or containerless\npresentation based on your content needs. \n**Text and image list**\n\n\nEasily scannable text and image lists are perfect for showcasing multiple\ncontent types, such as news headlines, playlists with album art, or\nmessages. \n**Checklist**\n\n\nThe checklist layout is perfect for displaying tasks, providing clear tap\ntargets for users to easily mark items as done. \n**Action list**\n\n\nProvide intuitive control grouping with action lists, where visual on/off\nstates offer immediate feedback on item statuses.\n\nGrid\n----\n\nPresent images in a compact, flexible, visually rich grid with optional labels.\nUse columns and rows that adapt to different screen sizes. \n**Image only**\n\n\nCreate visually impactful, scrollable image galleries using image-only\ngrids. Rows and columns automatically adapt to various screen sizes for\noptimal presentation. \n**Image and text**\n\n\nYou can also incorporate text labels and descriptions, enriching your\nimage grid content with additional context and information."]]
