Защита системной панели

Если ваше приложение ориентировано на 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,
    heightProvider: () -> Float = calculateGradientHeight(),
) {

    Canvas(Modifier.fillMaxSize()) {
        val calculatedHeight = heightProvider()
        val gradient = Brush.verticalGradient(
            colors = listOf(
                color.copy(alpha = 1f),
                color.copy(alpha = .8f),
                Color.Transparent
            ),
            startY = 0f,
            endY = calculatedHeight
        )
        drawRect(
            brush = gradient,
            size = Size(size.width, calculatedHeight),
        )
    }
}

@Composable
fun calculateGradientHeight(): () -> Float {
    val statusBars = WindowInsets.statusBars
    val density = LocalDensity.current
    return { statusBars.getTop(density).times(1.2f) }
}
SystemBarProtectionSnippets.kt

Рисунок 1. Полупрозрачная строка состояния.

Для адаптивных приложений вставьте пользовательский составной элемент, соответствующий цветам каждой панели, как показано в дизайне «От края до края» . Чтобы создать полупрозрачную панель навигации, задайте для Window.setNavigationBarContrastEnforced значение true.