Android架构示例：实现Snackbar顶部显示并适配状态栏和屏幕挖孔

在Android应用开发中，Snackbar是一种常用的轻量级反馈机制，通常默认显示在屏幕底部。但在某些场景下，我们需要将Snackbar显示在屏幕顶部，并正确处理状态栏和屏幕挖孔区域的适配问题。本文将基于android/architecture-samples项目中的实现，详细介绍如何创建一个顶部显示的Snackbar，并确保其正确避开系统UI区域。

顶部Snackbar的基本实现

首先，我们需要创建一个扩展函数，将Snackbar的位置调整为屏幕顶部。核心思路是通过修改Snackbar视图的布局参数，将其重力属性设置为TOP：

inline fun View.snackBarTop(string: String, length: Int = LENGTH_LONG, f: Snackbar.() -> Unit) {
    val snackBarTop = make(this, string, length)
    val snackBarView = snackBarTop.view
    val params: LayoutParams = snackBarView.layoutParams as LayoutParams
    params.gravity = Gravity.TOP
    snackBarView.layoutParams = params
    snackBarTop.f()
    snackBarTop.show()
}

这个基础版本已经可以实现Snackbar在顶部的显示，但还没有处理状态栏和屏幕挖孔的适配问题。

处理系统UI区域适配

现代Android设备通常有状态栏、导航栏以及可能的屏幕挖孔设计。为了确保Snackbar不会与这些系统UI元素重叠，我们需要使用WindowInsets API来获取系统UI的尺寸信息。

WindowInsetsCompat的使用

WindowInsetsCompat是AndroidX中提供的兼容性API，可以处理不同Android版本的系统UI边距问题。我们通过ViewCompat.setOnApplyWindowInsetsListener来监听窗口插入的变化：

ViewCompat.setOnApplyWindowInsetsListener(snackBarView) { _, windowInsets ->
    val insets = windowInsets.getInsets(
        WindowInsetsCompat.Type.systemBars() or WindowInsetsCompat.Type.displayCutout()
    )
    snackBarView.translationY = insets.top.toFloat()
    WindowInsetsCompat.CONSUMED
}

这段代码做了以下几件事：

1. 获取系统栏和屏幕挖孔的插入尺寸
2. 将Snackbar向下平移状态栏高度的距离
3. 返回CONSUMED表示已处理这些插入

组合完整实现

将上述两部分组合起来，就得到了完整的顶部Snackbar实现：

inline fun View.snackBarTop(string: String, length: Int = LENGTH_LONG, f: Snackbar.() -> Unit) {
    val snackBarTop = make(this, string, length)
    val snackBarView = snackBarTop.view
    val params: LayoutParams = snackBarView.layoutParams as LayoutParams
    params.gravity = Gravity.TOP
    ViewCompat.setOnApplyWindowInsetsListener(snackBarView) { _, windowInsets ->
        val insets = windowInsets.getInsets(
            WindowInsetsCompat.Type.systemBars() or WindowInsetsCompat.Type.displayCutout()
        )
        snackBarView.translationY = insets.top.toFloat()
        WindowInsetsCompat.CONSUMED
    }
    snackBarView.layoutParams = params
    snackBarTop.f()
    snackBarTop.show()
}

实现原理分析

1. 重力设置：通过修改LayoutParams的gravity属性为TOP，使Snackbar默认对齐到屏幕顶部。

2. 边距处理：WindowInsets提供了系统UI占据的空间信息，我们获取顶部插入值(insets.top)并将其作为Snackbar的垂直偏移量。

3. 屏幕挖孔适配：通过包含WindowInsetsCompat.Type.displayCutout()，确保也考虑了屏幕挖孔区域的尺寸。

4. 兼容性处理：使用AndroidX的兼容类确保在不同Android版本上都能正常工作。

使用场景建议

顶部Snackbar特别适合以下场景：

• 当屏幕底部有其他重要UI元素时
• 需要显示重要但不中断用户操作的提示信息
• 在表单验证中显示输入错误提示
• 作为操作成功/失败的轻量级反馈

注意事项

1. 边距计算时机：WindowInsets的回调可能不会立即触发，因此首次显示时可能有短暂的位置不正确。

2. 动画效果：默认的Snackbar动画是为底部显示设计的，顶部显示时可能需要调整动画效果。

3. 多Snackbar情况：如果需要同时显示多个Snackbar，需要考虑堆叠逻辑。

4. 横屏适配：在横屏模式下，可能需要额外的处理来适应不同的屏幕方向。

通过这种实现方式，开发者可以轻松创建适配各种Android设备的顶部Snackbar，提供更好的用户体验。