تصنيفات المحتوى

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

كيفية توفير تصنيفات المحتوى

android:contentDescription

عند استخدام ImageView أو ImageButton أو CheckBox أو عنصر View آخر يعرض المعلومات في رسم بياني، استخدِم السمة android:contentDescription لتوفير تصنيف للمحتوى لعنصر View هذا.

يعتمد تصنيف المحتوى في بعض الأحيان على معلومات لا تتوفّر إلا في وقت التشغيل، أو قد يتغير معنى عنصر View بمرور الوقت. على سبيل المثال، قد يتغير زر التشغيل إلى زر إيقاف مؤقت أثناء تشغيل الموسيقى. في هذه الحالات، استخدِم View#setContentDescription(CharSequence contentDescription) لتعديل تصنيف المحتوى في الوقت المناسب.

عندما تصف الخدمة المخصّصة لتسهيل الاستخدام عنصر ViewGroup، إنّها تضم عادةً تصنيفات المحتوى من عناصر View الثانوية. لإلغاء هذا السلوك وإظهار أنّك تريد توفير وصفك الخاص لهذا العنصر وعناصر View الثانوية غير القابلة للتركيز، يجب ضبط contentDescription على ViewGroup. وقد تحتاج إلى تضمين تصنيفات المحتوى من عناصر View الثانوية داخل contentDescription عند ضبطه على ViewGroup.

android:hint

بالنسبة إلى EditTexts أو TextViews القابلة للتعديل، استخدِم السمة android:hint للإشارة إلى الغرض من الحقل النصي. ويجب عدم استخدام android:contentDescription باعتبارها تصنيف محتوى لعناصر View القابلة للتعديل.

android:labelFor

استخدِم السمة android:labelFor للإشارة إلى أنّ أحد عناصر View سيعمل كتصنيف محتوى لعنصر View آخر.

الحالات التي لا تتطلب توفير تصنيفات المحتوى

يجب عدم توفير تصنيفات المحتوى بشكل محدد في بعض الحالات، مثلاً:

• إذا كان النص المعروض في TextView (أو فئاته الفرعية) مقدَّمًا تلقائيًا للخدمات المخصصة لتسهيل الاستخدام. وعادةً ما تكون تصنيفات المحتوى الإضافية غير ضرورية.
• إذا كانت الصور الزخرفية أو الصور لا تحمل معلومات مفيدة، وبالتالي لا تتطلب تصنيفات محتوى من الناحية البيانية. في هذه الحالات، يجب ضبط السمة android:contentDescription على القيمة "‎@null" أو السمة android:importantForAccessibility على القيمة "no".

للمزيد من المعلومات، يمكنك الاطّلاع على تطبيق تصنيفات المحتوى في تدريب مطورّي برامج Android وأدلة واجهات برمجة التطبيقات.

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

كيفية توفير تصنيفات المحتوى

مواصفات المحتوى

يجب ضبط وصف المحتوى لتوفير تصنيف المحتوى المخصص للعنصر Image أو Icon أو عنصر آخر قابل للإنشاء منخفض المستوى يعرض معلومات بيانية.

• قد يعتمد تصنيف المحتوى على معلومات وقت التشغيل وقد يتغير معنى العنصر القابل للإنشاء. على سبيل المثال، قد يتغير زر التشغيل إلى زر إيقاف مؤقت أثناء تشغيل الموسيقى.
  • في هذه الحالات، يجب استخدام State حتى يتمكن Jetpack Compose من الاطّلاع على التغييرات في وصف المحتوى وإعادة إنشائه بالقيمة الجديدة. كيفية استخدام State وJetpack Compose

• في بعض الحالات، قد تحتاج إلى دمج العناصر في عنصر واحد يمكن التركيز عليه ويجمع تصنيفات المحتوى من العناصر التابعة له. كيفية دمج العناصر

مَعلمة التصنيف

بعض العناصر القابلة للإنشاء، مثل TextField، تتوافق مع مَعلمة label الاختيارية. وعند ضبط التصنيف، يعرض العنصر المحتوى القابل للإنشاء الذي تم ضبطه على label. يمكن استخدام الخدمات المخصصة لتسهيل الاستخدام من أجل وصف العنصر القابل للإنشاء.

الحالات التي لا تتطلب توفير تصنيفات المحتوى

في بعض الحالات، يجب عدم إضافة تصنيفات المحتوى:

• إذا كان النص المعروض في Text، أو عناصر أخرى قابلة للإنشاء تحتوي على Text، مقدّمًا تلقائيًا لخدمات تسهيل الاستخدام
• إذا كانت الصور الزخرفية أو الصور لا تحمل معلومات ذات معنى موضّحة في رسم بياني
  • في هذه الحالات، يجب ضبط المعلمة contentDescription أو السمة Modifier.semantics#contentDescription على null أو طلب Modifier#clearAndSetSemantics.