關於系統資訊列保護

如果應用程式指定 SDK 35 以上版本，系統會強制採用無邊框模式。系統狀態列和手勢操作列為透明，但三按鈕導覽列為半透明。呼叫 enableEdgeToEdge，確保回溯相容。

不過，系統預設值可能不適用於所有用途。請參閱 Android 系統資訊列設計指南和無邊框設計指南，概略瞭解何時應考慮使用透明或半透明系統資訊列。

建立透明系統資訊列

如要建立透明手勢操作導覽列，請指定 Android 15 以上版本，或在舊版中呼叫 enableEdgeToEdge() 並使用預設引數。如果是三按鈕導覽列，請將 Window.setNavigationBarContrastEnforced 設為 false，否則系統會套用半透明遮罩。

建立半透明系統資訊列

如要建立半透明狀態列，請建立自訂可組合函式，與主要內容重疊，並在插邊覆蓋的區域繪製漸層。

class SystemBarProtectionSnippets : ComponentActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // enableEdgeToEdge sets window.isNavigationBarContrastEnforced = true
        // which is used to add a translucent scrim to three-button navigation
        enableEdgeToEdge()

        setContent {
            MyTheme {
                // Main content
                MyContent()

                // After drawing main content, draw status bar protection
                StatusBarProtection()
            }
        }
    }
}

@Composable
private fun StatusBarProtection(
    color: Color = MaterialTheme.colorScheme.surfaceContainer,
) {
    Spacer(
        modifier = Modifier
            .fillMaxWidth()
            .height(
                with(LocalDensity.current) {
                    (WindowInsets.statusBars.getTop(this) * 1.2f).toDp()
                }
            )
            .background(
                brush = Brush.verticalGradient(
                    colors = listOf(
                        color.copy(alpha = 1f),
                        color.copy(alpha = 0.8f),
                        Color.Transparent
                    )
                )
            )
    )
}
SystemBarProtectionSnippets.kt

圖 1. 半透明狀態列。

如果是自動調整式應用程式，請插入與各窗格顏色相符的自訂可組合項，如無邊框設計所示。如要建立半透明導覽列，請將 Window.setNavigationBarContrastEnforced 設為 true。