انتقل إلى المحتوى

ARIA تقول ما ليس كذلك

a11y-aria-invalidخطير
في هذه الصفحة

لماذا يهم

  • سمات ARIA وأدوارها تغيّر ما يعلنه قارئ الشاشة. فإذا أخطأت أعلن الشيء الخطأ أو لم يعلن شيئاً: قائمة تقول إنها مفتوحة وهي مغلقة، وقائمة تبويبات بلا تبويبات، ومفتاح تبديل بلا اسم.
  • لا تتحقق المتصفحات من ARIA؛ فالصفحة تبدو سليمة، ولا يقع في الخطأ إلا من يستعمل التقنيات المساعدة.
  • تطلب WCAG 2.2 أن يُظهر كل عنصر تحكّم اسمه ودوره وحالته كما هي (المعيار 4.1.2، المستوى A)، وأن تكون البنية التي تُظهرها الصفحة في وسومها (المعيار 1.3.1، المستوى A).

مثال

خطأ
<button id="categories" type="button" aria-expanded="مفتوح">التصنيفات</button>
صحيح
<button id="categories" type="button" aria-expanded="false">التصنيفات</button>

كيف تُصلح

استعمل القيم التي تعرّفها مواصفة ARIA، وقدّم العناصر الأصلية التي لا تحتاج ARIA:

html
<button id="categories" type="button" aria-expanded="false">التصنيفات</button>
  • تأخذ aria-expanded وaria-pressed وaria-checked القيمتين true وfalse بالإنجليزية أياً كانت لغة الصفحة؛ والتسمية هي ما يُكتب بالعربية.
  • عنصر التحكّم المخصّص بـrole="switch" أو role="tab" أو role="progressbar" يحتاج اسماً: نصاً ظاهراً، أو aria-label، أو aria-labelledby.
  • لا تضع aria-hidden="true" على ما يقبل التركيز، ولا على <body>.

كيف نكشف

  1. نعرض الصفحة ونشغّل في كل محرّك قواعد ARIA في axe-core 4.13.0 التي تسندها معايير WCAG: قواعد السمات (aria-allowed-attr وaria-valid-attr وaria-valid-attr-value وaria-required-attr وaria-prohibited-attr وaria-conditional-attr)، وقواعد الأدوار (aria-roles وaria-deprecated-role وaria-required-children وaria-required-parent)، وقواعد أسماء عناصر التحكّم المخصّصة، وaria-hidden-focus وaria-hidden-body.
  2. يُبلَّغ عن كل عنصر مرة لكل قاعدة من قواعد axe، مع المحرّكات التي وجدته.
  3. لا نشغّل قواعد ARIA في axe التي هي ممارسات مستحسنة فقط (aria-allowed-role وaria-dialog-name وaria-text وaria-treeitem-name).