Düzenlenebilir View etiketleri

Uygulamalardaki düzenlenebilir öğeler, kullanıcıların metin girmesine olanak tanır. Her düzenlenebilir öğenin amacını belirten bir açıklayıcı etiketi olmalıdır.

Geliştiriciler, bir uygulamanın kullanıcı arayüzündeki View öğelerini etiketlemek için Android'de birçok yola başvurabilir. Arayüzdeki düzenlenebilir öğelere yönelik bu etiketleme yöntemlerinden bazıları erişilebilirliği iyileştirebilir.

Kullanım

Düzenlenebilir bir TextView veya EditText öğesini etiketlemek için android:hint'i kullanın. Bu sayede öğe boşken, içinde açıklayıcı bir metin gösterilir.

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

Uygulamanın kullanıcı arayüzü, düzenlenebilir öğeler için zaten metin etiketi sağlıyorsa View etiketlerinde android:labelFor'u tanımlayarak etiketin hangi öğeyle ilgili olduğunu belirtin.

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

İpucu: Android Tasarım Destek Kitaplığı'nda belirtilen TextInputLayout'u kullanarak EditText'i ve ilişkili bir metin etiketini kolayca yönetebilirsiniz. Bu özellik Android'in erişilebilirlik hizmetleriyle uyumlu biçimde çalışır.

Herhangi bir EditText veya düzenlenebilir TextView'da android:contentDescription tanımlanırsa erişilebilirlik hizmeti, kullanıcının öğe içine girdiği metni açıklama, metne gitme ve metinle etkileşimde bulunma işlemlerini yapamayabilir.

Tasarım

Kullanıcılar bir ekran okuyucuyla düzenlenebilir öğelere gittiğinde, iyi tasarlanmış bir kullanıcı arayüzünde aşağıdaki öğelerle karşılaşır:

• Düzenlenebilir alan boşsa alanda ekran okuyucunun sesli olarak okuyacağı açıklayıcı bir etiket olur.
• Kullanıcı düzenlenebilir alana metin girdiyse ekran okuyucu, açıklayıcı etikete ek olarak metni de okur.

Kullanıcı daha düşük ayrıntı düzeyinde (ör. karakter bazında) gezinirken ekran okuyucu, girilen metni veya boş olduğunda ipucunu okur.

Test

Bir uygulamanın doğru şekilde etiketlenmiş düzenlenebilir öğeler içerdiğini manuel olarak doğrulamak için:

1. TalkBack'i açın.
2. Uygulamada, erişilebilirlik odağını boş düzenlenebilir öğeye taşıyın.
   • TalkBack'in boş düzenlenebilir öğe hakkındaki sesli açıklamasının etiket içerip içermediğini ve bu açıklayıcı etiketin uygulamadaki görsel etiketlerle eşleşip eşleşmediğini kontrol edin.
3. Düzenlenebilir öğenin içine bir şeyler yazın.
4. Erişilebilirlik odağını düzenlenebilir öğeye getirin.
   • Okunan açıklamanın yazdığınız metni içerdiğinden emin olmak için TalkBack'in düzenlenebilir öğe açıklamasını dinleyin.

Android'in otomatik test araçları, düzenlenebilir öğelerde boş olmayan contentDescription öğelerini algılayabilir. Uygulamanızı cihazda manuel olarak test etmek istiyorsanız Android için Erişilebilirlik Tarayıcısı'nı kullanabilirsiniz. Otomatik testler için Espresso ve Robolectric'te erişilebilirlik kontrolünü etkinleştirin.