狭額縁ディスプレイを手動でセットアップする

アプリでエッジ ツー エッジ表示を有効にするには、enableEdgeToEdge を呼び出します。ほとんどのアプリでは、これで十分です。このガイドでは、アプリで enableEdgeToEdge を使用せずにエッジツーエッジを有効にする方法について説明します。

アプリを全画面でレイアウトする

WindowCompat.setDecorFitsSystemWindows(window, false) を使用する システムバーの背後にアプリを配置する 例:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  WindowCompat.setDecorFitsSystemWindows(window, false)
}

Java

@Override
public void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  WindowCompat.setDecorFitsSystemWindows(getWindow(), false);
}

システムバーの色を変更する

エッジ ツー エッジのレイアウトで動作する場合、アプリでデバイスの色を変更する必要がある。 その下のコンテンツを表示できるようになります。アプリがこのステップを実行すると、ジェスチャー ナビゲーション モードとボタン モードで、ユーザー インターフェースの視覚的保護がすべてシステムによって処理されます。

• ジェスチャー ナビゲーション モード: システムバーの色が暗くなります。 できます。次の例では、ナビゲーション バーのハンドルは、明るいコンテンツの上に表示されている場合は暗い色に、暗いコンテンツの上に表示されている場合は明るい色に変わります。

で確認できます。

<ph type="x-smartling-placeholder"> <ph type="x-smartling-placeholder">

</ph> 図 1.ジェスチャー ナビゲーション モードでの色の変更。

• ボタンモード: システムバーの背後に半透明のスクリーン（API レベル 29 以降の場合）または透明なシステムバー（API レベル 28 以前の場合）が適用されます。

図 2. システムバーの背後に半透明のスクリム。

• ステータスバーのコンテンツの色: ステータスバーなど、ステータスバーのコンテンツの色を制御します。 表示することもできます。

図 3. ステータスバーのコンテンツの色。

themes.xml ファイルを編集して、ナビゲーション バーの色を設定できます。 必要に応じて、ステータスバーを透明にし、ステータスバーのコンテンツの色を ダークモードです。

<!-- values-v29/themes.xml -->
<style name="Theme.MyApp">
  <item name="android:navigationBarColor">
     @android:color/transparent
  </item>

  <!-- Optional: set to transparent if your app is drawing behind the status bar. -->
  <item name="android:statusBarColor">
     @android:color/transparent
  </item>

  <!-- Optional: set for a light status bar with dark content. -->
  <item name="android:windowLightStatusBar">
    true
  </item>
</style>

注: Android 10（API）で自動コンテンツ保護を無効にする場合は、 レベル 29）以降の場合は、 android:enforceNavigationBarContrast, android:enforceStatusBarContrast, または両方をテーマの false に追加します。

こちらの WindowInsetsController API サポートライブラリを使用することを強くおすすめします WindowInsetsControllerCompat 必要があります。代わりに WindowInsetsControllerCompat API を使用できます。 ステータスバーのコンテンツの色を制御する theme.xml。そのためには、setAppearanceLightNavigationBars() 関数を使用して、true を渡してナビゲーションの前景色を明るい色に変更するか、false を渡してデフォルトの色に戻します。

Kotlin

val windowInsetsController =
      ViewCompat.getWindowInsetsController(window.decorView)

windowInsetsController?.isAppearanceLightNavigationBars = true

Java

WindowInsetsControllerCompat windowInsetsController =
      ViewCompat.getWindowInsetsController(getWindow().getDecorView());
if (windowInsetsController == null) {
    return;
}

windowInsetsController.setAppearanceLightNavigationBars(true);