Android Lint 内容描述警告

Question

我收到警告 imageview 的“[辅助功能] 图像上缺少 contentDescription 属性”。而使用 android lint

是什么意思？

Answer 1

通过为我的 ImageView 设置属性 android:contentDescription 解决了此警告

android:contentDescription="@string/desc"

ADT 16 中的 Android Lint 支持会抛出此警告以确保图像小部件提供 contentDescription。

这定义了简要描述视图内容的文本。该属性主要用于辅助功能。由于某些视图没有文本表示，因此该属性可用于提供此类表示。

像 ImageViews 和 ImageButtons 这样的非文本小部件应该使用 contentDescription 属性来指定小部件的文本描述，以便屏幕阅读器和其他辅助工具可以充分描述用户界面。

Answer 2

禁用 Lint 警告很容易给您带来以后的麻烦。您最好只为所有 ImageView 指定 contentDescription。如果您不需要描述，则只需使用：

android:contentDescription="@null"

Answer 3

另一种选择是单独抑制警告：

xmlns:tools="http://schemas.android.com/tools"  (usually inserted automatically)
tools:ignore="contentDescription"

示例：

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent" 
    tools:ignore="contentDescription" >

       <ImageView
            android:layout_width="50dp"
            android:layout_height="match_parent"
            android:adjustViewBounds="true"
            android:padding="5dp"
            android:src="@drawable/icon" />

Answer 4

我建议您添加内容描述。

android:contentDescription="@string/contentDescriptionXxxx"

但是，让我们现实一点。大多数人不会为了可访问性而维护文字。
不过，只需付出很少的努力，您就可以实施一些措施来帮助残疾人。

<string name="contentDescriptionUseless">deco</string>
<string name="contentDescriptionAction">button de action</string>
<string name="contentDescriptionContent">image with data</string>
<string name="contentDescriptionUserContent">image from an other user</string>

。

盲人用户需要知道的最重要的事情是“我需要点击才能继续的按钮在哪里”

对任何可点击的内容使用 contentDescriptionAction。

对图像使用 contentDescriptionContent information (graph, textAsImage, ...)

使用 contentDescriptionUserContent 来表示所有用户提供的内容。

使用 contentDescriptionUseless 来处理其余的内容。

Answer 5

由于这只是一个警告，您可以抑制它。转到 XML 的图形布局并执行以下操作：

1. 单击右上角的红色按钮

   

2. 选择“禁用问题类型”（例如）

   

Answer 6

转到 Gradle 文件（模块应用程序），添加以下代码块

android {
    ... 
    lintOptions {
        disable 'ContentDescription'
    }
    ...
}

不再有警告！快乐编码

Answer 7

如果您想以优雅的方式抑制此警告（因为您确定此特定 ImageView 不需要可访问性），您可以使用特殊属性：

android:importantForAccessibility="no"

Answer 8

Android 可访问性所需的 ContentDescription。
特别是对于屏幕阅读器功能。
如果您不支持 Android 辅助功能，可以忽略它
通过设置Lint。

因此只需创建 lint.xml 即可。

<?xml version="1.0" encoding="UTF-8"?>
<lint>

    <issue id="ContentDescription" severity="ignore" />

</lint>

并将其放入 app 文件夹中。

Answer 9

对于纯粹装饰性的图形元素，请将其各自的 android:contentDescription XML 属性设置为“@null”。

如果您的应用仅支持运行 Android 4.1（API 级别 16）或更高版本的设备，您可以将这些元素的 android:importantForAccessibility XML 属性设置为“no”

Answer 10

非文本小部件需要以某种方式进行内容描述来以文本方式描述图像，以便屏幕阅读器能够描述用户界面。您可以忽略属性 xmlns:tools="http://schemas.android.com/tools"
tools:ignore="contentDescription" 或定义属性 android:contentDescription="your description"

Answer 11

由于我需要 ImageView 添加一个图标只是为了美观，所以我在 xml 文件中的每个 ImageView 中添加了 tools:ignore="ContentDescription" 。

我不再收到任何错误消息