Compose BottomSheetDialogFragment 应用标签跳过通报问题详解

2024-03-01 18:32:08

问题描述

在使用 Jetpack Compose 框架构建的应用中，当通过 BottomSheetDialogFragment 展示 Compose 内容时，可能会遇到应用标签被意外通报的问题。这种状况会干扰到无障碍服务的正确运行，导致视障用户无法顺利获取信息。

原因分析

该问题的核心在于如何恰当地处理无障碍服务（Accessibility Service）对 BottomSheetDialogFragment 中嵌入 Compose 内容时的应用标签通告。默认情况下，Compose 生成的视图可能与传统的 View 系统在无障碍特性上有细微差别，导致无障碍服务在遍历时出现不必要的应用标签通报。

解决方案一：自定义 ViewStub

针对上述问题，一种有效的方法是采用自定义的 ViewStub 来包裹 Compose 内容。这样做的好处在于避免了直接添加额外视图到布局中，同时解决了无障碍服务对应用标签的意外通告。

实现步骤：

在需要展示 Compose 的布局文件中使用一个 ViewStub。
通过代码动态加载并绑定 Compose 内容至这个 ViewStub 中。
调整 ViewStub 的无障碍属性，确保其在无障碍服务遍历时不会引发不必要的应用标签通报。

示例代码：

class CustomBottomSheetDialogFragment : BottomSheetDialogFragment() {
    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        val view = inflater.inflate(R.layout.dialog_fragment_layout, container, false)

        // 获取 ViewStub
        val viewStub = view.findViewById<ViewStub>(R.id.view_stub)
        viewStub.layoutResource = R.layout.compose_content

        // 设置 ViewStub 的无障碍属性
        viewStub.isFocusable = true
        viewStub.contentDescription = "Compose Content"

        return view
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        val composeView = requireView().findViewById<ComposeView>(R.id.compose_view)
        setContentToComposeView(composeView)
    }

    private fun setContentToComposeView(composeView: ComposeView) {
        composeView.setContent {
            // 在这里添加你的 Compose 内容
            Text(text = "Hello, Compose!")
        }
    }
}

布局文件 `dialog_fragment_layout.xml`:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content">

    <ViewStub
        android:id="@+id/view_stub"
        android:inflatedId="@+id/compose_view"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</LinearLayout>

布局文件 `compose_content.xml`:

<androidx.compose.ui.platform.ComposeView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/compose_view"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" />

通过上述方法，可以有效地避免在无障碍服务遍历时发生应用标签的意外通报问题。