Kanonische Widget-Layouts

Erstellen Sie effektive Widget-Layouts, indem Sie zuerst Ihre wichtigsten Inhalte festlegen. Ihr Layout bestimmt, wie Informationen und interaktive Elemente in Ihrem Widget angeordnet sind. Android bietet mehrere vorgefertigte Layouts für Symbolleisten, Text-, Listen- und Raster-Widgets, um diesen Prozess zu vereinfachen.

Text

Textlayouts eignen sich ideal für die Anzeige prägnanter Informationen. Sie können die visuelle Attraktivität Ihres Widgets verbessern, indem Sie optional ein Bild neben dem Text einfügen.

Nur Text

Ideal für Titel, Statusaktualisierungen, kurze Beschreibungen oder jedes Szenario in dem eine einzelne Textzeile die Botschaft effektiv vermittelt.

Text und Bild

Fügen Sie ein Bild hinzu, um die visuelle Wirkung zu erhöhen. Weitere Informationen finden Sie unter Breakpoints , um zu erfahren, wie Sie dieses Layout an verschiedene Bildschirmgrößen anpassen.

Symbolleisten

Mit Symbolleisten-Layouts können Sie Nutzern schnellen Zugriff auf häufig verwendete Aufgaben in Ihrer App ermöglichen. Das flexible Layout passt sich an verschiedene Widget-Größen an.

Suchleiste

Ein Layout für die Suchleiste ist so konzipiert, dass der Fokus auf der Suche als primäre Aktion in der Symbolleiste liegt. Zusätzliche praktische Schaltflächen können den schnellen Zugriff auf häufig verwendete Funktionen ermöglichen.

Symbolleiste

In Symbolleisten wird das App-Branding gefolgt von Schaltflächen für die am häufigsten verwendeten Aufgaben angezeigt. Sie eignen sich ideal für umschaltbare Einstellungen oder Aufgabenlinks. Beim Ändern der Größe können weniger häufig verwendete Optionen zugunsten häufigerer Aktionen ausgeblendet werden. Verwenden Sie Breakpoints , um eine neue Schaltfläche mit einer Mindestgröße von 48 dp hinzuzufügen, wenn Platz vorhanden ist.

Listen

Verwenden Sie Listenlayouts, um mehrere Elemente in einem übersichtlichen, leicht zu überfliegenden Format zu organisieren. Dies ist ideal für Schlagzeilen, To-do-Listen oder Nachrichten. Organisieren Sie Inhalte in einer strukturierten, leicht zu überfliegenden Liste. Je nach Ihren Inhaltsanforderungen können Sie zwischen einer Darstellung mit oder ohne Container wählen.

Liste mit Text und Bild

Listen mit Text und Bild, die leicht zu überfliegen sind, eignen sich perfekt für die Präsentation mehrerer Inhaltstypen wie Schlagzeilen, Playlists mit Albumcovern oder Nachrichten.

Checkliste

Das Checklisten-Layout eignet sich perfekt für die Anzeige von Aufgaben und bietet Nutzern klare Tippziele, um Elemente schnell als erledigt zu markieren.

Aktionsliste

Mit Aktionslisten können Sie intuitive Steuerelemente gruppieren. Visuelle Ein-/Aus Zustände bieten sofortiges Feedback zum Status von Elementen.

Raster

Präsentieren Sie Bilder in einem kompakten, flexiblen, visuell ansprechenden Raster mit optionalen Labels. Verwenden Sie Spalten und Zeilen, die sich an verschiedene Bildschirmgrößen anpassen.

Nur Bild

Erstellen Sie visuell ansprechende, scrollbare Bildergalerien mit Rastern, die nur Bilder enthalten. Zeilen und Spalten passen sich automatisch an verschiedene Bildschirmgrößen an, um eine optimale Präsentation zu gewährleisten.

Bild und Text

Sie können auch Textlabels und -beschreibungen einfügen, um die Inhalte Ihres Bildrasters mit zusätzlichem Kontext und Informationen zu versehen.

Codebeispiele

In der folgenden Tabelle wird jedes kanonische Layout der entsprechenden Jetpack Glance-Implementierung im GitHub-Repository für Android-Plattformbeispiele zugeordnet.

Kanonisches Layout Layoutkategorie Beispieldatei für die Implementierung
Nur Text Text LongTextAppWidget.kt
Text und Bild Text TextWithImageAppWidget.kt
Suchleiste Symbolleisten SearchToolBarAppWidget.kt
Symbolleiste (Standardeinstellung) Symbolleisten ToolBarAppWidget.kt
Liste mit Text und Bild Listen ImageTextListAppWidget.kt
Checkliste Listen CheckListAppWidget.kt
Aktionsliste Listen ActionListAppWidget.kt
Nur Bild Raster ImageGridAppWidget.kt
Bild und Text Raster ImageGridAppWidget.kt