Upraviteľné štítky zobrazenia

Upraviteľné položky v aplikácii umožňujú používateľom zadávať text. Všetky upraviteľné položky by mali mať popisný štítok uvádzajúci ich účel.

Android ponúka vývojárom niekoľko spôsobov, ako v používateľskom rozhraní aplikácie označiť zobrazenia. Niektoré spôsoby označenia upraviteľných položiek v používateľskom rozhraní môžu vylepšiť dostupnosť.

Implementácia

Na označenie upraviteľných položiek typu TextView a EditText použite atribút android:hint, ktorý umožňuje zobrazenie štítka s opisným textom, keď je položka prázdna.

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

Ak už používateľské rozhranie aplikácie poskytuje textový štítok upraviteľnej položky, definujte atribút android:labelFor v zobrazení označenia, čím určíte, ktorú položku štítok opisuje.

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

Tip: Trieda TextInputLayout v knižnici Android Design Support Library poskytuje jednoduchý spôsob spravovania atribútov EditText a priradených textových štítkov. Dobre funguje so službami dostupnosti v Androide.

Definovanie atribútu android:contentDescription pre prvok typu EditText alebo upraviteľný prvok typu TextView môže narušiť funkčnosť služby dostupnosti pri opisovaní, navigácii a interakcii s textom zadaným používateľom v rámci príslušnej položky.

Dizajn

Keď používatelia prejdú na upraviteľné položky pomocou čítačky obrazovky, dobre implementované používateľské rozhranie obsahuje tieto prvky:

• Ak je upraviteľné pole prázdne, obsahuje opisný štítok, ktorý vysloví čítačka obrazovky.
• Ak používateľ zadal do upraviteľného poľa text, čítačka obrazovky okrem opisného štítka prečíta aj tento text.

Keď používateľ prejde na podrobnejšiu úroveň, napríklad na čítanie znak po znaku, čítačka obrazovky prečíta nahlas zadaný text alebo tip, ak nie je zadaný žiadny text.

Testovanie

Ak chcete ručne overiť, či aplikácia obsahuje správne označené upraviteľné položky, postupujte takto:

1. Zapnite aplikáciu TalkBack.
2. V aplikácii presuňte zameranie dostupnosti na prázdnu upraviteľnú položku.
   • Skontrolujte, či vyslovený opis prázdnej upraviteľnej položky v aplikácii TalkBack obsahuje štítok a či sa tento opisný štítok zhoduje s vizuálnymi štítkami v aplikácii.
3. Zadajte do upraviteľnej položky ľubovoľný text.
4. Presuňte zameranie dostupnosti na upraviteľnú položku.
   • Ak chcete skontrolovať, či vyslovený opis obsahuje zadaný text, vypočujte si opis upraviteľnej položky v aplikácii TalkBack.

Automatizované testovacie nástroje Androidu dokážu rozpoznať atribút contentDescription upraviteľných položiek, ktorý nie je prázdny. Skúste manuálne otestovať aplikáciu v zariadení pomocou Kontroly dostupnosti pre Android. V prípade automatizovaných testov zapnite kontrolu dostupnosti v nástrojoch Espresso a Robolectric.