Elementele editabile dintr-o aplicație ajută utilizatorii să introducă text. Fiecare element editabil trebuie să aibă o etichetă descriptivă care să indice scopul acestuia.
Android oferă dezvoltatorilor mai multe modalități de a eticheta Views
în interfața de utilizare a unei aplicații. Pentru elementele editabile dintr-o interfață, anumite modalități de etichetare pot îmbunătăți accesibilitatea.
Implementare
Pentru a eticheta un câmp editabil TextView
sau EditText
, folosiți android:hint
pentru a afișa o etichetă text descriptivă în elementul respectiv când acesta este necompletat.
<EditText
android:id="@+id/email_subject"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:hint="@string/email_subject_hint" />
Dacă interfața de utilizare a unei aplicații oferă deja o etichetă text pentru elementul editabil, definiți android:labelFor
pentru View
din etichetare, pentru a indica elementul descris de etichetă.
<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>
Sfat: TextInputLayout
din Android Design Support Library oferă o modalitate simplă de a gestiona un câmp EditText
și o etichetă text asociată și funcționează bine cu serviciile de accesibilitate Android.
Dacă definiți android:contentDescription
pentru orice câmp EditText
sau câmp editabil TextView
, puteți să influențați capacitatea unui serviciu de accesibilitate de a descrie, naviga și interacționa cu textul pe care utilizatorul îl introduce în elementul respectiv.
Design
Când utilizatorii navighează la elemente editabile cu un cititor de ecran, o interfață de utilizare bine implementată are următoarele elemente:
- în cazul în care câmpul editabil este necompletat, acesta are o etichetă descriptivă pe care o rostește cititorul de ecran;
- dacă un utilizator a introdus text în câmpul editabil, cititorul de ecran rostește textul, pe lângă eticheta descriptivă.
Când un utilizator navighează la un nivel de detaliere mai scăzut, de exemplu, caracter cu caracter, cititorul de ecran rostește textul introdus sau indiciul când este gol.
Testare
Pentru a verifica manual dacă o aplicație conține elemente editabile corect etichetate:
- activați TalkBack;
- în aplicație, mutați focalizarea pentru accesibilitate pe elementul editabil gol;
- verificați dacă descrierea rostită de TalkBack a elementului editabil gol conține o etichetă și dacă eticheta descriptivă se potrivește cu orice etichetă vizuală din aplicație;
- introduceți un text în elementul editabil;
- mutați focalizarea pentru accesibilitate pe elementul editabil;
- pentru a verifica dacă descrierea rostită include textul tastat, ascultați descrierea TalkBack a elementului editabil.
Instrumentele Android de testare automată pot detecta un câmp contentDescription
completat pentru elementele editabile. Vă recomandăm să folosiți Accessibility Scanner pentru Android pentru testarea manuală a aplicațiilor de pe dispozitiv. Pentru testările automate, activați verificarea accesibilității în Espresso și Robolectric.