解决Android 15中WebView Edge to Edge布局夜间模式异常问题

问题根源 #

你当前代码给父布局ConstraintLayout设置了系统栏内边距，导致WebView被限制在内边距范围内，状态栏下方显示的是父布局默认的白色背景，而非WebView内容。同时未正确启用官方Edge to Edge配置，也未针对WebView做内容偏移适配。

具体修复步骤 #

1. 启用官方Edge to Edge支持 #

取消注释enableEdgeToEdge()方法，它会自动将系统状态栏、导航栏设为透明，允许应用内容延伸至屏幕边缘：

enableEdgeToEdge()

2. 将Insets监听目标改为WebView #

把setOnApplyWindowInsetsListener的监听对象从父布局切换到WebView，通过设置WebView的内边距，让网页内容避开系统栏遮挡，同时让WebView本身延伸至屏幕边缘：

ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.webView1)) { v, insets ->
    val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
    v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
    insets
}

3. 可选：设置WebView背景透明 #

如果网页背景非全屏，可给WebView添加透明背景，避免父布局背景透出：
在webview.xml中修改WebView配置：

<WebView
    android:id="@+id/webView1"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/transparent" />

4. 可选：适配系统栏图标颜色 #

夜间模式下若状态栏图标（时间、信号等）显示不清晰，可添加以下代码自动适配图标颜色：

val isDarkTheme = resources.configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK == Configuration.UI_MODE_NIGHT_YES
WindowCompat.getInsetsController(window, window.decorView).apply {
    isAppearanceLightStatusBars = !isDarkTheme
    isAppearanceLightNavigationBars = !isDarkTheme
}

完整修复后的MainActivity.kt代码 #

class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.webview)
        actionBar?.hide()

        // 启用Edge to Edge模式
        enableEdgeToEdge()

        // 适配WebView的系统栏内边距
        ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.webView1)) { v, insets ->
            val systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars())
            v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom)
            insets
        }

        // 可选：适配系统栏图标颜色
        val isDarkTheme = resources.configuration.uiMode and Configuration.UI_MODE_NIGHT_MASK == Configuration.UI_MODE_NIGHT_YES
        WindowCompat.getInsetsController(window, window.decorView).apply {
            isAppearanceLightStatusBars = !isDarkTheme
            isAppearanceLightNavigationBars = !isDarkTheme
        }
    }
}

额外注意事项 #

• 确保网页本身支持全屏布局，避免网页内部固定顶部边距导致显示异常。
• 使用WindowInsetsCompat而非旧版WindowInsets，可保证跨Android版本的兼容性。

内容的提问来源于stack exchange，提问作者Lorenz Meyer