Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

エッジツーエッジを設定する

エッジツーエッジ表示により、アプリはシステムバー（ステータスバー、キャプションバー、ナビゲーションバー）の背後に UI を描画して、没入感のあるユーザーエクスペリエンスを実現できます。Android 15（API レベル 35）以降を搭載しているデバイスをターゲットとする場合、デフォルトでエッジツーエッジが適用されます。

すべての Android バージョンでコンテンツをエッジツーエッジで正しく表示するには、次の設定手順に沿って操作します。これらの手順を行わないと、アプリがシステムバーの背後に単色を描画したり、画面キーボード（IME）の切り替えと同期してコンテンツをアニメーション表示しなかったりする可能性があります。

Android スキル

GitHub で表示

Edge-to-Edge のサポートを追加

エッジツーエッジの Android スキルを使用して、Jetpack Compose アプリにアダプティブエッジツーエッジのサポートを追加します。

Android CLI からスキルをインストールするには、次のコマンドを実行します。

android skills add edge-to-edge

1. エッジツーエッジ表示を有効にする

以前の Android バージョンでエッジツーエッジを有効にするには、Activity.onCreate() メソッドで enableEdgeToEdge() を呼び出します。

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    enableEdgeToEdge()
    // ...
}EdgeToEdgeSnippets.kt

デフォルトでは、enableEdgeToEdge() はシステムバーを透明にします。ただし、3 ボタンナビゲーションモードでは、ナビゲーションバーに半透明のスクリムを適用してコントラストを高めます。システムアイコンとスクリムの色は、システムのライトモードまたはダークモードに合わせて調整されます。

2. windowSoftInputMode を構成する

アクティビティの AndroidManifest.xml エントリで android:windowSoftInputMode="adjustResize" を設定します。この設定により、アプリは IME インセットを受け取ることができ、画面キーボードの表示 / 非表示時にパディングでレイアウトを調整できます。

<!-- In your AndroidManifest.xml file: -->
<activity
  android:name=".ui.MainActivity"
  android:label="@string/app_name"
  android:windowSoftInputMode="adjustResize"
  android:theme="@style/Theme.MyApplication"
  android:exported="true">
  ...
</activity>

3. インセットを使用してオーバーラップを処理する

エッジツーエッジを有効にすると、アプリのコンテンツと UI 要素の一部がシステムバーの背後に描画されることがあります。重要な要素やインタラクティブな要素がシステムバーで隠れたり、システムジェスチャーと重なったりしないようにするには、インセットを処理する必要があります。

インセットは、システム UI またはシステムジェスチャーと交差する画面の部分を表します。エッジツーエッジ表示で考慮すべき主なインセットの種類は次のとおりです。

システムバーインセット: システムバーが表示される領域を表します。これらを使用して、システムバーによって UI が隠れないようにします。
ディスプレイカットアウトインセット: デバイスの画面に物理的なカットアウト（カメラノッチなど）が存在する領域を表します。

Compose では、ルーラー、パディング修飾子、インセットサイズ修飾子のいずれかを使用してインセットを処理できます。詳細なガイダンスについては、ウィンドウインセットについてをご覧ください。

高度なトピック

より高度なエッジツーエッジのユースケースについては、以下を検討してください。

没入モード

動画や地図などのコンテンツでは、システムバーを非表示にして完全に没入できるエクスペリエンスが適しています。WindowInsetsControllerCompat を使用してシステムバーを非表示にできます。

val windowInsetsController = WindowCompat.getInsetsController(window, window.decorView)

// Hide the system bars.
windowInsetsController.hide(WindowInsetsCompat.Type.systemBars())

// Show the system bars.
windowInsetsController.show(WindowInsetsCompat.Type.systemBars())EdgeToEdgeSnippets.kt

システムバーの色とアイコン

エッジツーエッジにすると、アプリの背景がシステムバーの背後に表示されることがあるため、コントラストを高めるためにシステムバーのアイコンの色を調整する必要があるかもしれません。

ステータスバーのアイコンを明るい色または暗い色に変更するには、WindowInsetsControllerCompat を使用します。

// Set status bar icons to dark.
WindowCompat.getInsetsController(window, window.decorView)
    .isAppearanceLightStatusBars = true

// Set status bar icons to light.
WindowCompat.getInsetsController(window, window.decorView)
    .isAppearanceLightStatusBars = falseEdgeToEdgeSnippets.kt

システムバーの保護

enableEdgeToEdge() はデフォルトで透明または半透明のシステムバーを提供しますが、カスタマイズが必要になる場合があります。透明なバーと半透明のバーのどちらを使用するかは、Android システムバーの設計に関するガイダンスとエッジツーエッジの設計に関するガイダンスを参照して判断してください。

3 ボタンナビゲーションバーを半透明ではなく完全に透明にするには、コントラストの強制適用を無効にします。

window.isNavigationBarContrastEnforced = falseEdgeToEdgeSnippets.kt

詳しくは、システムバーの保護についてをご覧ください。

WindowInsetsRulers について