Layout für die Tischposition mit „Grid“ und „mediaQuery“

Symbol für 4-Sterne-Bewertung

Im Tischmodus wird das Display eines faltbaren Geräts in zwei funktionale Anzeigebereiche aufgeteilt, die durch das Scharnier getrennt sind. Im Tischmodus können Sie die Hauptinhalte Ihrer App (z. B. einen Videoplayer oder einen Spielbereich) in der oberen Hälfte platzieren, während interaktive Elemente (z. B. Mediensteuerung oder Steuerpads) in der unteren Hälfte positioniert werden.

Ein faltbares Gerät im Modus „Auf dem Tisch“, auf dem Videoinhalte auf dem oberen Bildschirm und die Wiedergabesteuerung auf dem unteren Bildschirm angezeigt werden.
Abbildung 1. Im Tischmodus werden Inhalte und interaktive Steuerelemente auf die beiden Seiten des Falzes aufgeteilt.

Best Practices

Wenn Sie Ihre App für den Tischmodus optimieren möchten, verwenden Sie die Grid API, um ein Layout mit zwei Zeilen und einer Spalte zu definieren, und wenden Sie die Medienabfrage für den Tischmodus an.

  • Auf dem Tisch-Modus reaktiv erkennen:Verwende das Composeable mediaQuery, um den Gerätestatus zu beobachten. Wenn das Gerät in den Modus „Auf dem Tisch“ (windowPosture == Posture.Tabletop) gefaltet wird, kannst du das Layout dynamisch ändern, ohne dass Aktivitäten neu gestartet werden müssen oder eine komplexe Lebenszyklusverwaltung erforderlich ist.
  • Layouts mit Grid strukturieren:Verwende im Tabletop-Modus die Grid API (2 rows, 1 column), um primäre visuelle Inhalte in der oberen Zeile über dem Falz und interaktive Steuerelemente in der unteren Zeile unter dem Falz sauber zu trennen.
  • Implizite Z-Indexierung für Overlays nutzen:Weisen Sie in Standardpositionen (nicht auf dem Tisch) derselben Zelle mehrere Bereichs-IDs zu, um Steuerelemente über dem Player einzublenden. Grid rendert Elemente automatisch in der Reihenfolge ihrer Deklaration von hinten nach vorne.
  • Für flüssige Übergänge sorgen:Achte darauf, dass der Status und die Scrollpositionen beim Wechsel zwischen Standard-Vollbildlayouts und dem Tischmodus beibehalten werden.

Zutaten

  • Grid: Ein adaptiver Layoutcontainer, mit dem Sie Elemente in konfigurierbaren Zeilen und Spalten positionieren können. Er eignet sich ideal, um Inhalte auf verschiedene Bildschirmbereiche aufzuteilen.
  • mediaQuery: Eine Jetpack Compose API, mit der die aktuelle Fensterposition, die Größenklassen und die Hardwaremerkmale der App direkt in Ihren Composables abgefragt werden können.

Schritte

Fragen Sie den Gerätestatus mit mediaQuery() ab. Wenn sich das Gerät im Modus „Auf dem Tisch“ befindet, ordne die Inhalte deiner App in einem vertikalen Raster mit zwei Zeilen und einer Spalte an. Achte darauf, dass die primären Inhalte oben bleiben und die Steuerelemente unten zugänglich sind.

1. Rasterkonfigurationen für den Modus „Auf dem Tisch“ definieren

Definiere in einer zusammensetzbaren Funktion Layoutbereich-IDs mithilfe eines Enums und richte GridConfigurationScope-Blöcke für die Standard- und die Tisch-Haltung ein.

In defaultConfig werden beide Bereiche derselben Zelle (row = 1, column = 1) zugewiesen. Grid verwendet einen impliziten Z-Index, bei dem später im Layout deklarierte Composables über früheren gerendert werden. So kann der Controller den Player ohne zusätzliche Containerverschachtelung überlagern (weitere Informationen finden Sie unter UI-Element-Overlays mit Grid).

enum class VideoPlayerArea { Player, Controller }

object PlayerGridConfig {
    // Default: Single area layout with overlay (controls on top of player)
    val defaultConfig: GridConfigurationScope.() -> Unit = {
        row(1f)
        column(1f)
        area(areaId = VideoPlayerArea.Player, row = 1, column = 1)
        area(areaId = VideoPlayerArea.Controller, row = 1, column = 1)
    }

    // Tabletop: Two rows splitting content across the fold
    val tabletopConfig: GridConfigurationScope.() -> Unit = {
        row(0.5f)
        row(0.5f)
        column(1f)
        area(areaId = VideoPlayerArea.Player, row = 1, column = 1) // Top half above fold
        area(areaId = VideoPlayerArea.Controller, row = 2, column = 1) // Bottom half below fold
    }
}

2. „Auf dem Tisch“-Modus erkennen und Konfiguration auf Grid anwenden

Verwenden Sie mediaQuery, um die aktive Konfiguration basierend auf windowPosture auszuwählen, übergeben Sie config an Grid und binden Sie zusammensetzbare Inhalte an die Bereichs-IDs. Wenn Sie VideoPlayerArea.Player vor VideoPlayerArea.Controller deklarieren, werden die Steuerelemente über dem Player gerendert, wenn beide eine Zelle in defaultConfig teilen:

val config = mediaQuery {
    when (windowPosture) {
        Posture.Tabletop -> PlayerGridConfig.tabletopConfig
        else -> PlayerGridConfig.defaultConfig
    }
}

Grid(config = config) {
    Box(
        modifier = Modifier
            .gridItem(areaId = VideoPlayerArea.Player)
    ) {
        // VideoPlayerContent
    }

    Box(
        modifier = Modifier
            .gridItem(areaId = VideoPlayerArea.Controller)
    ) {
        // PlaybackControlsContent
    }
}

Ergebnisse

Durch die Kombination von mediaQuery und Grid erkennt Ihre App dynamisch, wenn ein faltbares Gerät teilweise in den Tischmodus gefaltet wird, und passt die Benutzeroberfläche automatisch in zwei funktionale Anzeigebereiche an, die durch die Falte getrennt sind.

Zusätzliche Ressourcen