利用 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 | 低檔模式:導航欄圖示變暗 (舊版專用) |
直接操作 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);
}
}
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。android:paddingTop="?attr/actionBarSize" 或 WindowInsetsCompat.getInsets(ime()) 動態調整內邊距。| API 等級 | 推薦方案 |
|---|---|
| 11 ~ 29 | View.setSystemUiVisibility() + IMMERSIVE_STICKY |
| 30+ (Android 11+) | WindowInsetsControllerCompat (AndroidX 回溯相容) |
| 需在 setContentView 前決定 | Window.FLAG_FULLSCREEN (簡單場景) |