萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 動態控制狀態欄顯示/隱藏 (沉浸式全螢幕) 兩種方案實戰

方案一:View.setSystemUiVisibility() (API 11-29 推薦)

利用 View 系統 UI 旗標組合,精細控制狀態欄、導航欄顯示行為。

// 隱藏狀態欄與導航欄 (全螢幕沉浸)
view.setSystemUiVisibility(
    View.SYSTEM_UI_FLAG_LAYOUT_STABLE
    | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
    | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
    | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
    | View.SYSTEM_UI_FLAG_FULLSCREEN
    | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY); // 粘性沉浸:用戶滑動邊緣暫時顯示

// 顯示狀態欄與導航欄
view.setSystemUiVisibility(View.SYSTEM_UI_FLAG_VISIBLE);

旗標含義速查

旗標行為
SYSTEM_UI_FLAG_FULLSCREEN隱藏狀態欄,內容區域延伸至頂部
SYSTEM_UI_FLAG_HIDE_NAVIGATION隱藏導航欄 (虛擬鍵/手勢條)
SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN佈局延伸至狀態欄區域 (狀態欄半透明蓋在佈局上)
SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION佈局延伸至導航欄區域
SYSTEM_UI_FLAG_IMMERSIVE_STICKY粘性沉浸:用戶從邊緣滑動暫時顯示系統欄,無操作自動隱藏
SYSTEM_UI_FLAG_LOW_PROFILE低檔模式:導航欄圖示變暗 (舊版專用)

方案二:WindowManager.LayoutParams.FLAG_FULLSCREEN (傳統、簡單)

直接操作 Window 屬性,**需在 setContentView() 前調用**,動態切換較麻煩。

private void setFullScreen(boolean enable) {
    Window window = getWindow();
    WindowManager.LayoutParams attrs = window.getAttributes();

    if (enable) {
        attrs.flags |= WindowManager.LayoutParams.FLAG_FULLSCREEN;
        window.setAttributes(attrs);
        // 讓佈局延伸至狀態欄區域 (配合 fitsSystemWindows)
        window.addFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS);
    } else {
        attrs.flags &= ~WindowManager.LayoutParams.FLAG_FULLSCREEN;
        window.setAttributes(attrs);
        window.clearFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS);
    }
}

現代最佳實踐:WindowInsetsController (API 30+)

Android 11 (R) 棄用 setSystemUiVisibility,統一使用 WindowInsetsController:

// 隱藏狀態欄與導航欄
WindowInsetsControllerCompat controller = WindowCompat.getInsetsController(window, window.decorView);
controller.hide(WindowInsetsCompat.Type.statusBars() | WindowInsetsCompat.Type.navigationBars());
controller.setSystemBarsBehavior(WindowInsetsControllerCompat.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE);

// 顯示
controller.show(WindowInsetsCompat.Type.statusBars() | WindowInsetsCompat.Type.navigationBars());

依賴:implementation "androidx.core:core:1.9.0+" (含 WindowInsetsControllerCompat 回溯支援)。

配合佈局避免內容被遮擋

  • 根佈局設定 android:fitsSystemWindows="true" (傳統) 或使用 WindowInsetsAnimationCompat。
  • 子 View 使用 android:paddingTop="?attr/actionBarSize" 或 WindowInsetsCompat.getInsets(ime()) 動態調整內邊距。
  • BottomNavigationView / NavigationBarView 已內建處理導航欄內邊距。

總結選型建議

API 等級推薦方案
11 ~ 29View.setSystemUiVisibility() + IMMERSIVE_STICKY
30+ (Android 11+)WindowInsetsControllerCompat (AndroidX 回溯相容)
需在 setContentView 前決定Window.FLAG_FULLSCREEN (簡單場景)
copyright © 萬盛學電腦網 all rights reserved