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

Если ваше приложение ориентировано на 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.

Назад
Используйте вставки в представлениях и компоновке
Далее
О вырезах