Szerkeszthető megjelenéscímkék

A felhasználók szöveget vihetnek be az alkalmazáson belüli szerkeszthető elemekbe. Mindegyik szerkeszthető elemnek rendelkeznie kell az elem célját közlő leíró címkével.

Az Android rendszer különféle lehetőségeket kínál a fejlesztők számára az alkalmazás kezelőfelületén található View elemek címkézéséhez. A kezelőfelületen lévő szerkeszthető elemek esetében a következő címkézési módszerek némelyike javíthatja a kisegítő lehetőségek hatékonyságát.

Megvalósítás

A szerkeszthető TextView és EditText objektumok címkézéséhez használja az android:hint attribútumot, amellyel leíró jellegű szöveges címke jeleníthető meg az elemen belül, ha az üres.

<EditText
    android:id="@+id/email_subject"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:hint="@string/email_subject_hint" />

Ha az alkalmazás kezelőfelületén már van szöveges címke a szerkeszthető elemhez, határozza meg az android:labelFor attribútumot a címkézési View objektumon, így jelezve, hogy a címke melyik elemet írja le.

<LinearLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="@string/email_subject_label"
        android:labelFor="@id/email_subject" />
    <EditText
        android:id="@+id/email_subject"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />
</LinearLayout>

Tipp: Az Android Design Support Library függvénytárban található TextInputLayout segítségével egyszerűen kezelhető az EditText objektum és a társított szöveges címke, és jól működik együtt az Android kisegítő lehetőségeinek szolgáltatásaival.

Ha android:contentDescription attribútumot határoz meg az EditText vagy a szerkeszthető TextView objektum esetén, ezzel megzavarhatja a kisegítő lehetőség szolgáltatásának azt a képességét, hogy a felhasználó által az elemen belül bevitt szöveget leírja, azzal navigáljon, illetve azt használja.

Kialakítás

Amikor a felhasználók szerkeszthető elemekhez navigálnak a képernyőolvasó használatával, a megfelelően kialakított kezelőfelület a következő elemeket tartalmazza:

• Ha a szerkeszthető mező üres, akkor leíró címkével rendelkezik, amelyet a képernyőolvasó kimond.
• Ha a felhasználó szöveget írt be a szerkeszthető mezőbe, akkor a képernyőolvasó a leíró címke mellett a szöveget is felolvassa.

Amikor a felhasználó kisebb részletességgel (például karakterről karakterre) navigál, akkor a képernyőolvasó kimondja a bevitt szöveget (vagy a tippet, ha nincs szöveg).

Tesztelés

A következőképpen ellenőrizhető manuálisan, hogy az alkalmazás helyesen címkézett szerkeszthető elemeket tartalmaz-e:

1. Kapcsolja be a TalkBack funkciót.
2. Az alkalmazásban helyezze át a kisegítő lehetőségek fókuszát az üres, szerkeszthető elemre.
   • Ellenőrizze, hogy a szerkeszthető elem TalkBack által kimondott leírása tartalmaz-e címkét, és hogy a leíró címke egyezik-e az alkalmazásban található valamelyik vizuális címkével.
3. Írjon be valamit a szerkeszthető elembe.
4. Vigye a kisegítő lehetőség fókuszát a szerkeszthető elemre.
   • Annak ellenőrzéséhez, hogy a kimondott leírás tartalmazza-e a beírt szöveget, hallgassa meg a szerkeszthető elemet tartalmazó TalkBack-leírást.

Az Android automatizált tesztelőeszközei képesek a szerkeszthető elemek nem üres contentDescription attribútumának észlelésére. Fontolja meg az androidos Accessibility Scanner használatát az alkalmazás manuális tesztelésére valamely eszközön. Automatizált tesztek elvégzéséhez kapcsolja be a kisegítő lehetőségek ellenőrzését az Espresso és a Robolectric eszközökben.