如何解决Android Studio添加FloatingActionButton的无可用朗读文本错误

这个提示是Android无障碍合规检查的要求，FloatingActionButton作为交互组件，必须提供屏幕阅读器可识别的文本，帮助视障用户理解按钮功能，以下是三种修复方式：

方法一：在XML布局中添加属性 #

直接给FloatingActionButton加上android:contentDescription属性，推荐使用字符串资源以适配多语言：

<com.google.android.material.floatingactionbutton.FloatingActionButton
    android:id="@+id/floatbutnID"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:contentDescription="@string/fab_function_desc"
    app:srcCompat="@drawable/your_fab_icon" />

如果不需要多语言，也可以直接写文本：

android:contentDescription="新建项目"

方法二：在Java代码中动态设置 #

如果需要根据业务逻辑动态修改描述，可在Activity或Fragment中设置：

FloatingActionButton fab = findViewById(R.id.floatbutnID);
// 直接设置文本
fab.setContentDescription("新建项目");
// 或者使用字符串资源
fab.setContentDescription(getString(R.string.fab_function_desc));

方法三：通过图形化界面设置 #

在Android Studio的Layout Editor中操作：

• 选中布局中的FloatingActionButton
• 打开右侧的Attributes面板，找到Accessibility分类
• 在contentDescription输入框中填写文本，或点击右侧的资源图标选择已定义的字符串资源

注：Android 8.0及以上版本还可以搭配app:tooltipText属性，给按钮添加长按提示，但核心还是contentDescription解决无障碍提示问题。

内容的提问来源于stack exchange，提问作者jhone luky