Tata letak widget kanonis
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Buat tata letak widget yang efektif dengan mengidentifikasi konten inti Anda terlebih dahulu. Tata letak
Anda menentukan cara informasi dan elemen interaktif diatur dalam
widget Anda. Android menawarkan beberapa tata letak bawaan untuk toolbar, teks, daftar,
dan widget jenis petak untuk menyederhanakan proses ini.
Teks
Tata letak teks sangat ideal untuk menampilkan informasi yang ringkas. Tingkatkan daya tarik
visual widget Anda dengan menyertakan gambar di samping teks secara opsional.
Hanya teks
Ideal untuk judul, pembaruan status, deskripsi singkat, atau skenario apa pun
yang menggunakan satu baris teks untuk menyampaikan pesan secara efektif. Lihat
Contoh tata letak kanonis
untuk mendapatkan panduan tentang penskalaan konten teks secara dinamis berdasarkan ukuran widget.
Teks dan gambar
Sertakan gambar untuk menambah dampak visual. Untuk informasi selengkapnya, lihat
Titik henti sementara
untuk mempelajari cara menyesuaikan tata letak ini untuk berbagai ukuran layar.
Gunakan tata letak toolbar untuk memberi pengguna akses cepat ke tugas yang sering digunakan
di aplikasi Anda, dalam tata letak fleksibel yang beradaptasi di seluruh ukuran widget.
Toolbar Penelusuran
Tata letak toolbar penelusuran sengaja dirancang untuk menarik fokus ke penelusuran
sebagai tindakan utama di toolbar. Tombol praktis tambahan dapat memberikan
akses cepat ke fungsi yang sering digunakan.
Toolbar
Toolbar menampilkan branding aplikasi, diikuti dengan tombol untuk tugas yang paling sering digunakan
yang ideal untuk setelan atau link tugas yang dapat diaktifkan. Saat mengubah ukuran, opsi yang kurang
umum digunakan dapat disembunyikan untuk mendukung tindakan yang lebih umum. Gunakan
Titik henti sementara
untuk menambahkan tombol baru yang dapat diketuk dengan ukuran minimum 48 dp jika ada ruang.
Daftar
Gunakan tata letak daftar untuk mengatur beberapa item dalam format yang jelas dan dapat dipindai. Hal ini
ideal untuk judul berita, daftar tugas, atau pesan. Atur konten ke dalam
daftar terstruktur yang mudah dipindai. Pilih antara presentasi dengan penampung atau tanpa penampung
berdasarkan kebutuhan konten Anda.
Daftar teks dan gambar
Daftar teks dan gambar yang mudah dipindai sangat cocok untuk menampilkan beberapa
jenis konten, seperti judul berita, playlist dengan sampul album, atau
pesan.
Checklist
Tata letak checklist sangat cocok untuk menampilkan tugas, memberikan target ketuk
yang jelas bagi pengguna untuk menandai item sebagai selesai dengan mudah.
Daftar tindakan
Berikan pengelompokan kontrol yang intuitif dengan daftar tindakan, dengan status aktif/nonaktif
visual yang menawarkan masukan langsung tentang status item.
Grid
Menampilkan gambar dalam petak yang rapat, fleksibel, dan kaya secara visual dengan label opsional.
Gunakan kolom dan baris yang beradaptasi dengan berbagai ukuran layar.
Image only
Buat galeri gambar yang dapat di-scroll dan berdampak visual menggunakan petak khusus
gambar. Baris dan kolom secara otomatis menyesuaikan dengan berbagai ukuran layar untuk
presentasi yang optimal.
Gambar dan teks
Anda juga dapat menyertakan label dan deskripsi teks, yang memperkaya
konten petak gambar dengan konteks dan informasi tambahan.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[null,null,["Terakhir diperbarui pada 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."]]
