Android Lint contentDescription-Warnung

Ich bekomme eine Warnung als “[Accessibility] Fehlendes contentDescription-Attribut auf Bild” für Bildansicht. bei Verwendung von Android Lint

Was bedeutet das?

Diese Warnung wurde durch Setzen des Attributs behoben android:contentDescription für meine ImageView

android:contentDescription="@string/desc"

Die Android Lint-Unterstützung in ADT 16 gibt diese Warnung aus, um sicherzustellen, dass Bild-Widgets eine contentDescription bereitstellen.

Dies definiert Text, der den Inhalt der Ansicht kurz beschreibt. Diese Eigenschaft wird hauptsächlich für die Barrierefreiheit verwendet. Da einige Ansichten keine Textdarstellung haben, kann dieses Attribut verwendet werden, um eine solche bereitzustellen.

Nicht-Text-Widgets wie ImageViews und ImageButtons sollten das contentDescription-Attribut verwenden, um eine Textbeschreibung des Widgets anzugeben, sodass Bildschirmleseprogramme und andere Barrierefreiheitstools die Benutzeroberfläche angemessen beschreiben können.

Das Deaktivieren von Lint-Warnungen wird Sie später leicht in Schwierigkeiten bringen. Sie sind besser dran, wenn Sie einfach contentDescription für alle Ihre ImageViews angeben. Wenn Sie keine Beschreibung benötigen, verwenden Sie einfach:

android:contentDescription="@null"

Eine weitere Möglichkeit besteht darin, die Warnung individuell zu unterdrücken:

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

Beispiel:

<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="https://stackoverflow.com/questions/8500544/@drawable/icon" />

Ich empfehle Ihnen, die contentDescription hinzuzufügen.

android:contentDescription="@string/contentDescriptionXxxx"

aber seien wir realistisch. Die meisten Leute pflegen nicht wörtlich für die Zugänglichkeit. Still, man kann mit wenig aufwand etwas umsetzen, was menschen mit behinderung hilft.

<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>

.

Das Wichtigste, was der blinde Benutzer wissen muss, ist “Wo ist die Schaltfläche, auf die ich klicken muss, um fortzufahren?”

Verwenden Sie contentDescriptionAction für alles, was anklickbar ist.

use contentDescriptionContent für Bild mit Informationen (graph, textAsImage, …)

Verwenden Sie contentDescriptionUserContent für alle vom Benutzer bereitgestellten Inhalte.

Verwenden Sie contentDescriptionUseless für den Rest.

Da es sich nur um eine Warnung handelt, können Sie diese unterdrücken. Gehen Sie zum grafischen Layout Ihres XML und tun Sie dies:

1. Klicken Sie auf die rote Schaltfläche in der rechten oberen Ecke

   

2. Wählen Sie „Problemtyp deaktivieren“ (z. B.)

   

Gehe zu Gradle Datei (Modul-App), fügen Sie den Codeblock unten hinzu

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

Keine Warnung mehr! Viel Spaß beim Codieren

Wenn Sie diese Warnung elegant unterdrücken möchten (weil Sie sicher sind, dass die Barrierefreiheit für diese bestimmte ImageView nicht erforderlich ist), können Sie das spezielle Attribut verwenden:

android:importantForAccessibility="no"