Label Tampilan yang dapat diedit

Item yang dapat diedit dalam aplikasi memungkinkan pengguna memasukkan teks. Setiap item yang dapat diedit harus memiliki label deskriptif yang menyatakan tujuannya.

Android menawarkan beberapa cara bagi developer untuk memberi label Views di antarmuka pengguna aplikasi. Untuk item yang dapat diedit di antarmuka, beberapa cara pemberian label ini dapat meningkatkan aksesibilitas.

Penerapan

Untuk memberi label TextView atau EditText yang dapat diedit, gunakan android:hint untuk menampilkan label teks deskriptif dalam item ketika kosong.

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

Jika antarmuka pengguna aplikasi sudah memberikan label teks untuk item yang dapat diedit, tentukan android:labelFor pada pemberian label View untuk menunjukkan item yang dijelaskan oleh label.

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

Tips: TextInputLayout pada bagian Support Library Desain Android memberikan cara mudah untuk mengelola EditText dan label teks terkait, dan berfungsi baik dengan layanan aksesibilitas Android.

Menentukan android:contentDescription di EditText atau TextView yang dapat diedit dapat mengganggu kemampuan layanan aksesibilitas untuk mendeskripsikan, membuka, dan berinteraksi dengan teks yang dimasukkan pengguna dalam item tersebut.

Desain

Saat pengguna membuka item yang dapat diedit dengan pembaca layar, antarmuka pengguna yang diterapkan dengan baik akan memiliki elemen berikut:

• Jika kolom yang dapat diedit ternyata kosong, kolom tersebut memiliki label deskriptif yang diucapkan pembaca layar.
• Jika pengguna telah memasukkan teks di kolom yang dapat diedit, pembaca layar mengucapkan teks selain label deskriptif.

Saat pengguna membuka tingkat perincian yang lebih rendah, seperti karakter demi karakter, pembaca layar mengucapkan teks yang dimasukkan, atau petunjuk saat kolomnya kosong.

Pengujian

Untuk memverifikasi secara manual bahwa aplikasi berisi item yang dapat diedit dan diberi label dengan benar:

1. Aktifkan TalkBack.
2. Di aplikasi, pindahkan fokus aksesibilitas ke item kosong yang dapat diedit.
   • Periksa apakah deskripsi lisan TalkBack dari item kosong yang dapat diedit berisi sebuah label, dan apakah label deskriptif cocok dengan label visual apa pun yang ada dalam aplikasi.
3. Ketik beberapa teks di item yang dapat diedit.
4. Pindahkan fokus aksesibilitas ke item yang dapat diedit.
   • Untuk memastikan deskripsi lisan menyertakan teks yang diketik, dengarkan deskripsi TalkBack dari item yang dapat diedit.

Alat pengujian otomatis Android dapat mendeteksi contentDescription yang tidak kosong di item yang dapat diedit. Pertimbangkan untuk menggunakan Accessibility Scanner untuk Android guna menguji aplikasi di perangkat secara manual. Untuk pengujian otomatis, aktifkan pemeriksaan aksesibilitas di Espresso dan Robolectric.