Мітки представлення View, які можна редагувати

Завдяки елементам у додатку, які можна редагувати, користувачі можуть вводити текст. Кожен із таких елементів повинен мати описову мітку, що пояснює його призначення.

Існує кілька способів додавати мітки для представлень View в інтерфейсі користувача додатка Android. Деякі з цих способів допомагають зробити елементи інтерфейсу, які можна редагувати, зручнішими для користувачів з обмеженими можливостями.

Застосування

Щоб додати описову текстову мітку до порожнього елемента TextView або EditText, який можна редагувати, скористайтесь атрибутом android:hint.


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

Якщо в інтерфейсі користувача додатка вже є текстова мітка для елемента, який можна редагувати, зв’яжіть його з відповідним представленням View за допомогою атрибута android:labelFor.


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

Підказка. За допомогою макета TextInputLayout із бібліотеки Android Design Support Library можна легко керувати елементом EditText і зв’язаною з ним текстовою міткою. Крім того, цей макет підтримує сервіси спеціальних можливостей Android.

Якщо вказати атрибут android:contentDescription для будь-якого елемента EditText або доступного для редагування елемента TextView, це може завадити сервісу спеціальних можливостей обробляти текст (зокрема описувати його, переміщатися ним і взаємодіяти з ним), який користувач вводить у такий елемент.

Дизайн

Переконайтеся, що під час переходу до елементів, які можна редагувати, за допомогою програми зчитування з екрана в інтерфейсі користувача, відбуваються наведені нижче дії.

Якщо поле, яке можна редагувати, порожнє, програма зчитування з екрана відтворює його описову мітку.
Якщо користувач ввів текст у поле, яке можна редагувати, програма зчитування з екрана озвучує його, а також описову мітку.

Якщо користувач здійснює навігацію з меншою деталізацією (наприклад, по символах), програма зчитування з екрана озвучує введений текст або, якщо поле порожнє, підказку.

Тестування

Щоб вручну перевірити, чи елементи додатка, які можна редагувати, мають правильні мітки:

Увімкніть TalkBack.
Виділіть порожній елемент, який можна редагувати.
- Перевірте, чи озвучує TalkBack описову мітку для порожнього елемента, який можна редагувати, і чи збігається вона з міткою, що показується в додатку.
Введіть текст в елемент, який можна редагувати.
Виділіть елемент, який можна редагувати.
- Послухайте, чи озвучений TalkBack опис елемента, який можна редагувати, містить введений вами текст.

Автоматизовані інструменти тестування в ОС Android можуть виявляти заповнений атрибут contentDescription в елементах, які можна редагувати. Щоб перевірити додаток на пристрої вручну, скористайтеся Сканером доступності для Android. Щоб здійснювати автоматизовані тестування, увімкніть перевірку спеціальних можливостей в Espresso й Robolectric.