Štítky upravitelných zobrazení

Upravitelné položky v aplikacích uživatelům umožňují zadávat text. Každá upravitelná položka by měla mít štítek s popisem účelu.

Systém Android vývojářům poskytuje několik způsobů označení objektů View v uživatelském rozhraní aplikace. V případě upravitelných položek v rozhraní některé z těchto způsobů označení mohou vylepšit přístupnost.

Implementace

Pokud chcete označit upravitelný objekt TextView nebo EditText, použijte atribut android:hint. Tento atribut umožňuje zobrazit v položce štítek s popisným textem, když je prázdná.

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

Pokud již v uživatelském rozhraní aplikace máte textový štítek označující upravitelnou položku, pomocí atributu android:labelFor u popisného objektu View uveďte, kterou položku štítek popisuje.

<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: Třída TextInputLayout v knihovně Android Design Support Library poskytuje snadný způsob správy objektů EditText a přidružených textových štítků a dobře podporuje službu systému Android pro usnadnění přístupu.

Definování atributu android:contentDescription u objektů EditText nebo upravitelných objektů TextView může narušovat schopnost služby přístupnosti poskytovat popis a navigaci a interagovat s textem, který uživatel do prvku zadává.

Návrh

Když je uživatelské prostředí dobře implementované a uživatel přejde na upravitelnou položku pomocí čtečky obrazovky, stane se následující:

• Pokud je upravitelné pole prázdné, obsahuje popisný text, který čtečka obrazovky přečte.
• Pokud uživatel do upravitelného pole zadal text, čtečka obrazovky po přečtení popisného textu přečte také zadaný text.

Pokud uživatel používá nižší úroveň podrobnosti, například čtení po jednotlivých znacích, čtečka obrazovky vysloví zadaný text nebo přečte popisný štítek, pokud je pole prázdné.

Testování

Pokud chcete ručně ověřit, že aplikace obsahuje správně označené upravitelné položky:

1. Zapněte čtečku obrazovky TalkBack.
2. V aplikaci přesuňte zaměření přístupnosti na prázdnou upravitelnou položku.
   • Zkontrolujte, zda hlasový popis aplikace TalkBack obsahuje název popisného štítku a zda tento popisný název odpovídá vizuálním štítkům obsaženým v aplikaci.
3. Zadejte do upravitelné položky nějaký text.
4. Přesuňte zaměření přístupnosti na upravitelnou položku.
   • Pokud chcete zkontrolovat, zda mluvený popis zahrnuje zadaný text, poslouchejte popis upravitelné položky od aplikace TalkBack.

Neprázdný atribut contentDescription u upravitelných položek lze odhalit pomocí automatických testovacích nástrojů systému Android. K ručnímu testování aplikace v zařízení doporučujeme použít nástroj Kontrola přístupnosti pro Android. Chcete-li spustit automatické testy, zapněte kontrolu přístupnosti v nástrojích Espresso a Robolectric.