تصنيفات العرض القابلة للتعديل

من خلال العناصر القابلة للتعديل المتوفرة في تطبيق، يمكن للمستخدمين إدخال نص. ويجب أن يحتوي كل عنصر قابل للتعديل على تصنيف وصفي يوضّح الغرض منه.

يقدّم 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 />

إذا كانت واجهة المستخدم في التطبيق توفّر تصنيفًا نصيًا للعنصر القابل للتعديل، حدِّد 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 طريقة سهلة لإدارة EditText وتصنيف نص مرتبط بها، كما يعمل بشكل جيد مع خدمات تسهيل الاستخدام في Android.

إن تحديد android:contentDescription في أي عنصر EditText أو عنصر TextView قابل للتعديل قد يتعارض مع قدرة خدمة تسهيل الاستخدام على وصف النص الذي يُدخله المستخدم في العنصر والانتقال إليه والتفاعل معه.

التصميم

عندما ينتقل المستخدمون إلى عناصر قابلة للتعديل باستخدام قارئ شاشة، من المفترض أن تتضمّن واجهة المستخدم التي تم تنفيذها بشكل صحيح العناصر التالية:

• إذا كان الحقل القابل للتعديل فارغًا، ستحتوي الواجهة على تصنيف وصفي يقرأه قارئ الشاشة.
• إذا أدخل المستخدم نصًا في الحقل القابل للتعديل، يقرأ قارئ الشاشة النص بالإضافة إلى التصنيف الوصفي.

عندما يتنقّل المستخدم بدرجة دقة أدنى، مثلاً بحرف تلو الآخر، يقرأ قارئ الشاشة النص الذي تم إدخاله أو التلميح عندما يكون الحقل فارغًا.

الاختبار

للتحقّق يدويًا من أنّ التطبيق يحتوي على عناصر قابلة للتعديل مصنَّفة بشكل صحيح، يجب اتّباع الخطوات التالية:

1. فعِّل ميزة TalkBack.
2. في التطبيق، انقل تركيز ميزة تسهيل الاستخدام إلى العنصر الفارغ القابل للتعديل.
   • تحقَّق مما إذا كان الوصف الذي تقرأه ميزة TalkBack للعنصر الفارغ القابل للتعديل يتضمن تصنيفًا، وما إذا كان هذا التصنيف الوصفي يطابق أي تصنيفات مرئية في التطبيق.
3. اكتب نصًا داخل العنصر القابل للتعديل.
4. انقل تركيز ميزة تسهيل الاستخدام إلى العنصر القابل للتعديل.
   • للتأكد من أنّ الوصف المقروء يشمل النص المكتوب، استمِع إلى وصف TalkBack للعنصر القابل للتعديل.

يمكن لأدوات الاختبار المبرمَجة في Android رصد عنصر contentDescription غير الفارغ ضمن العناصر القابلة للتعديل. ويمكنك استخدام Accessibility Scanner لنظام التشغيل Android من أجل اختبار تطبيقك يدويًا على الجهاز. لإجراء اختبارات مبرمجة، يجب تفعيل فحص سهولة الاستخدام في Espresso وRobolectric.