Grid と mediaQuery を使用した卓上姿勢レイアウト

4 つ星評価アイコン

折りたたみ式デバイスのテーブルトップ ポスチャーでは、1 つの画面が物理的な折り目(またはヒンジ)で区切られた 2 つの機能的なディスプレイ領域に分割されます。テーブルトップ ポスチャーでは、アプリのメイン コンテンツ(動画プレーヤーやゲーム キャンバスなど)を上半分に配置し、インタラクティブ要素(メディア コントロールやコントロール パッドなど)を下半分に配置できます。

テーブルトップ モードの折りたたみ式デバイス。上部の画面に動画コンテンツ、下部の画面に再生コントロールが表示されている。
図 1. テーブルトップ ポスチャーでは、コンテンツとインタラクティブなコントロールが物理的な折り目に沿って分割されます。

ベスト プラクティス

アプリにテーブルトップのサポートを追加するには、Grid API を使用して 2 行 1 列のレイアウトを定義し、テーブルトップ ウィンドウの姿勢のメディアクエリを適用します。

  • テーブルトップの形状をリアクティブに検出する: mediaQuery コンポーザブルを使用して、デバイスの状態を監視します。デバイスがテーブルトップ ポスチャー(windowPosture == Posture.Tabletop)に折りたたまれたときに、アクティビティの再起動や複雑なライフサイクル処理を必要とせずに、レイアウトを動的にシフトします。
  • Grid を使用してレイアウトを構造化する: テーブルトップの姿勢では、Grid API(2 rows、1 column)を使用して、メインのビジュアル コンテンツをスクロールせずに見える範囲の上段に、インタラクティブなコントロールをスクロールしなければ見えない範囲の下段に、きれいに分割します。
  • オーバーレイに暗黙的な z インデックスを使用する: 標準(テーブルトップ以外)の形状では、同じセルに複数のエリア ID を割り当てて、プレーヤーにコントロールをオーバーレイします。Grid は、宣言順にアイテムを背面から前面に自動的にレンダリングします。
  • スムーズな移行を実現する: 標準の全画面レイアウトとテーブルトップ ポスチャーの間で移行する際に、状態とスクロール位置が保持されるようにします。

材料

  • Grid: 構成可能な行と列にアイテムを配置できるアダプティブ レイアウト コンテナ。コンテンツを異なる画面領域に分割するのに最適です。
  • mediaQuery: コンポーザブル内でアプリの現在のウィンドウ ポスチャー、サイズクラス、ハードウェア特性を直接クエリするために使用される Jetpack Compose API。

手順

mediaQuery() を使用してデバイスのポスチャーをクエリします。デバイスがテーブルトップ形状の場合、アプリのコンテンツを 2 行 1 列の縦型グリッドに配置し、メイン コンテンツが上部に表示され、コントロールが下部でアクセスできるようにします。

1. テーブルトップ モードのグリッド構成を定義する

コンポーズ可能な関数内で、列挙型を使用してレイアウト領域 ID を定義し、デフォルトとテーブルトップの姿勢用に GridConfigurationScope ブロックを設定します。

defaultConfig では、両方の領域が同じセル(row = 1, column = 1)に割り当てられます。Grid は暗黙的な Z インデックスを使用します。このインデックスでは、レイアウト内で後に宣言されたコンポーザブルが、前に宣言されたコンポーザブルの上にレンダリングされます。これにより、コントローラは、追加のコンテナ ネストなしでプレーヤーをオーバーレイできます(詳細については、Grid を使用した UI 要素のオーバーレイをご覧ください)。

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. テーブルトップの姿勢を検出し、グリッドに設定を適用する

mediaQuery を使用して、windowPosture に基づいてアクティブな構成を選択し、config を Grid に渡して、コンポーズ可能なコンテンツをエリア ID にバインドします。VideoPlayerArea.Controller の前に VideoPlayerArea.Player を宣言すると、両方が defaultConfig のセルを共有している場合に、コントロールがプレーヤーの上にレンダリングされます。

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
    }
}

結果

mediaQuery と Grid を組み合わせることで、折りたたみ式デバイスがテーブルトップの姿勢に部分的に折りたたまれたことをアプリが動的に検出し、折りたたみ部分で分割された 2 つの機能的な表示領域に UI を自動調整します。

参考情報