ورقة الغش لأدوار ARIA: مقارنة أفضل الاختيارات

تعد ورقة مرجعية لأدوار ARIA مرجعًا لتعيين كل دور ARIA لعنصر HTML الأصلي المعادل لها، وفئتها (عنصر واجهة المستخدم، أو المعالم، أو البنية، أو المنطقة الحية أو النافذة) والممتلكات والحالات المصاحبة لها. يحدد WAI-ARIA 1.2 82 دورًا، ويحتاج معظم المشاريع فقط إلى ما بين 15 و20 شكلًا متكررًا. تعيد هذه المقارنة أفضل المرجعيات المتوفرة في عام 2026 وتشرح أيها الأنسب لتدفق عملك.

لماذا ورقة الغش لأدوار ARIA ستكون ضرورية

إن المواصفات مثل WAI-ARIA 1.2 وWAI-ARIA 1.3 هي مستندات كثيفة، مصممة لمنفذي المتصفحات وتقنيات المساعدة، وليس لمن يقوم بتصميم نموذج (form) في ظهيرة يوم الثلاثاء. أول نظام لـ ARIA - استخدام HTML الأصلي الذي يظل موجودًا - يعرض معظم الحالات، ولكن هناك أنماط ليس لها مكافئ أصلي: أشجار، أشجار، شبكات تفاعلية، قوائم مشتركة (comboboxes) مع إكمال تلقائي، قوائم بقوائم فرعية. حسنًا، هناك حاجة إلى مرجع في الوقت الحالي، وعن كل شيء، تجنب الأخطاء.

الخطأ الأكثر شيوعًا لا يخلف دورًا، لكنه يضيف شيئًا غير ضروري. لا يقدم <button> مع role="button" أي فائدة وقد يكسر السلوك الأصلي في بعض قراء الشاشة. تشرح ورقة مرجعية مُعدة جيدًا بوضوح أن الأدوار زائدة عن العناصر الأصلية، وما هي الأدوار التي تتطلب إدارة التركيز بواسطة JavaScript، وما هي السمات الإلزامية أمام الاختيارية.

السبب الثاني هو التحقق. تتضمن الأدوار علاقات خاصة بالملكية: “aria-labelledby” بمثابة معرف، و”aria-activedescendant” التي تشير إلى أن العنصر المرجعي موجود ومرئي تمامًا، و”aria-owns” فقط يتم تبريرها عندما لا يتطابق ترتيب DOM مع الترتيب المرئي. تكشف اللوحة التي تقوم بالدور والصفات المطلوبة والسمات المحظورة عن السقوط قبل أن تدخل في عملية التدقيق.

يجب أن يتضمن هذا ورقة غش جيدة لأدوار ARIA

مرجع مفيد لتطوير الواجهة الأمامية بخمسة معايير. لأن القائمة هي بالضبط ما تم استخدامه لتقييم خيارات هذه المقارنة.

• **تغطية جميع فئات الأدوار الخمس. ** تقوم WAI-ARIA بتجميع الأدوار في الملخصات والأدوات وبنية المستند والمعالم والمناطق الحية. لا يتم استخدام الملخصات (roletype، widget، input) في إطار العمل؛ مرجع جيد لبيانات الشكل المرئي.
• مكافئ HTML الأصلي للدور. بدون هذا العمود، يطالب المرجع باستخدام ARIA هناك دون لمس.
• السمات المطلوبة والمدعمة والمحظورة. role="checkbox" يتطلب aria-checked؛ role = "heading" يتطلب aria-level؛ الدور = "العرض التقديمي" غير مسموح به.
• نمط لوحة المفاتيح المرتبط. الدور بدون إدارة اللوحة هو وعد متضمن. يتضمن role="tablist" عناصر مختلفة/derecha وHome وEnd.
• تنسيق قابل للبحث. محرك بحث، التصفية حسب الفئة، إصدار المواصفات والقدرة على نسخ جزء من التعليمات البرمجية.

المقارنة: أفضل مراجع أدوار ARIA في عام 2026

تستأنف اللوحة التالية الخيارات الأكثر صلابة. Ninguna es de pago؛ يتم الحفاظ على جميع الأنشطة واذكر إصدار المواصفات التي تغطيها.

ذات صلة: UserWay — ويدجت إمكانية الوصول بخطة مجانية للتمكن من ذلك بنفس الطريقة.

المصدر	انفوك	الفئات كوبيرتاس	يعادل الأصل	راعي اللوحة	الفقرة المثالية
دليل ممارسات التأليف WAI-ARIA (APG)، W3C	المستفيدون مكتملون بالنماذج	الحاجيات والمعالم والبنية التحتية والمناطق الحية	نعم، في كل راعي	نعم، التفاصيل	تنفيذ قطعة محددة
MDN Web Docs، مرجع الأدوار ARIA	فيشا بور رول	كل شيء، بما في ذلك الملخصات	نعم	جزئي	استشارة دور بونتوال
ممارسات تأليف ARIA، فهرس الأدوار	الطبلة رول → السمات	الحاجيات والبنية التحتية	جزئي	لا	التحقق من السمات المطلوبة
جامعة ديك، مرجع ARIA	ملاحظات مع ملاحظات الدعم	الحاجيات والمعالم	نعم	جزئي	كونسر دعم حقيقي للقارئ
قائمة مراجعة المشروع A11Y	قائمة التحقق	مستعرضة	لا يوجد تطبيق	لا	التدقيق قبل النشر
HTML-ARIA (W3C)، جدول المعادلات	الدور المسموح به للعنصر	توداس	نعم، هذا هو الاقتراح	لا	قرر ما إذا كانت ARIA ضرورية

دليل ممارسات التأليف WAI-ARIA (APG)

APG لـ W3C هو المرجع القانوني للمستفيدين. يشتمل كل نمط على بنية HTML والأدوار والحالات وتفاعل الجهاز ونموذج وظيفي. النقطة القصوى هي عدم تحديد قائمة الأدوار: توضيح السلوك المتوقع. النقطة الصعبة هي أنها ليست لوحة سريعة؛ للاستشارة «qué atributos lleva role='slider'» يمكنك تصفح النمط المقابل.

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

MDN Web Docs: المرجع الخاص بـ rol

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

يستحق نظرة: AudioEye — إمكانية الوصول إلى الإدارة: أتمتة مجمعة مع مراجعة بشرية.

تمرين تفصيلي: تحدد MDN ما هي الأدوار التي أصبحت قديمة أو يمكن التخلص منها في الإصدارات المستقبلية من المواصفات. مستشار هذه العلامة التجارية يتجنب اتخاذ دور يختفي.

HTML-ARIA: اللوحة التي تتجنب ARIA غير الضرورية

تحدد مواصفات HTML-ARIA من W3C، لكل عنصر من عناصر HTML، ما هي أدوار ARIA التي يمكن تطبيقها وكلها زائدة عن الحاجة. إنها الأداة الحاسمة عندما يستخدم الأشخاص عنصرًا أصليًا أو عنصرًا مع دور. إذا ظهر الدور الذي تريد تطبيقه كتكرار لهذا العنصر، فلن تتم إضافة الرد.

جامعة ديكي ومشروع A11Y

تقدم Deque University أوراقًا تحتوي على ملاحظات حول الدعم الحقيقي لقراء الشاشة، على الرغم من أن المواصفات ليست مكعبة لأنها ليست رائعة. القائمة المرجعية لمشروع A11Y ليست ورقة غش للأدوار، ولكنها تعمل كقائمة تحقق مسبقة منشورة ومكملة للإصدارات السابقة.

Cómo elegir según tu caso

القرار يعتمد على ثلاثة أسئلة. أولا، هل تعرف ما هو المطلوب؟ إذا كان الرد صحيحًا، فإن MDN هي الطريقة الأفضل. ثانيًا، هل تريد إنشاء عنصر واجهة مستخدم بتفاعل كامل؟ لذا فإن الأمر يحتاج إلى APG، لأن الدور لأنه لا يصف فقط أداء اللوحة. ثالثًا، هل تريد الدخول إلى HTML الأصلي وARIA؟ راجع HTML-ARIA قبل أي شيء آخر.

بالنسبة للمعدات التي تعمل مع أطر عمل XHTML وCSS، تكون المجموعة الأكثر كفاءة هي: HTML-ARIA للاختيار، وAPG للتنفيذ، وMDN للتحقق من السمات. يتم توفير ورقة غش من صفحة واحدة كذاكرة قصيرة في الساحة، ولكن لا يمكنك استبدال هذه الثلاثة فوانيس عندما تظهر حالة محدودة.

معيار إضافي يمكن تطبيقه: إذا كانت الوظيفة تتطلب JavaScript للتشغيل بشكل صحيح (إدارة التركيز، تحديث الأغنية الموسعة، مزامنة الأغنية المحددة)، يتم استخدامها كقرار للهندسة، وليس كخاصية تزيينية. تؤدي أدوار عنصر واجهة المستخدم بدون المنطق المرتبط إلى إنشاء حواجز أكبر من استخدام الدور.

ذات صلة: IAAP CPACC / WAS Certification — الشهادة المهنية التي تمنحك الخبرة والقدرة على الوصول إليها.

الأخطاء المتكررة التي لا تحتوي على ورقة الغش يمكن تجنبها بمفردها

تؤدي أدوار المعالم المكررة إلى إعاقة التنقل بين المناطق. إن role = "main" حول <main> زائد عن الحاجة؛ Dos role = "navigation" ليس لها آداب مميزة فهي غامضة. الحل هو “تسمية الأغنية” أو “تسمية الأغنية” في كل علامة بارزة متكررة.

أدوار القطعة المتعلقة بالعناصر لا تعزز التفاعل. role="button" حول <div> exige tabindex="0" وطريقة Enter وEspacio. ومع ذلك، تعلن الأسطوانة عن زر لا يمكن تفعيله باستخدام لوحة المفاتيح.

تعد حالات التوقف هي السبب الأكثر شيوعًا لانخفاض الجمهور. aria-expanded الذي لا يتغير لفتح نغمة وترية، aria-select الذي لا يتم تحديثه عند تغيير البيستانيا أو aria-checked في `role=“switch"" الذي تم إصلاحه. Ninguna table the Detector: hace falta probar with thekeyboard and with قارئ شاشة حقيقي.

إذا كنت تتسوق: accessiBe — Superposición de IA الذي يعزز إطراء WCAG خلال 48 ساعة.

الأدوار المجردة في السوق خطأ من حيث المبدأ. يجب ألا يظهر role = "widget" أو role = “input” أو `role = “section” في HTML؛ توجد وحدها ل jerarquía من المواصفات.

الوجبات السريعة الرئيسية

• يحدد WAI-ARIA 1.2 82 دورًا، ولكن معظم المشاريع يتم تنفيذها فقط بين 15 و20 شكلًا متكررًا.
• يقوم أول نظام ARIA - باستخدام HTML الأصلي عند وجوده - بتحويل جدول HTML-ARIA من W3C إلى مرجع أكثر أهمية قبل كتابة أي دور.
• لا يمكن التغلب على APG لـ W3C لمحترفي عناصر واجهة المستخدم لأنه يتضمن تفاعل اللوحة؛ MDN هو الأسرع للحصول على دور ملموس.
• دور لا يحتوي على إدارة تركيز ولا يؤدي إلى تحديث الأوضاع مما يؤدي إلى زيادة حواجز الوصول التي لا تسمح باستخدام ARIA.
• ورقة الغش في Ninguna تقوم باستبدال اختبار لوحة المفاتيح وقارئ الشاشة: يتم اكتشاف الحالات غير المتزامنة فقط باستخدام حقيقي.

أسئلة متكررة

¿أدوار كوانتوس ARIA موجودة؟

يحدد WAI-ARIA 1.2 82 دورًا، مقسمة إلى خمس فئات: الملخصات والأدوات وبنية المستندات والمعالم والمناطق الحية. الأدوار المجردة لا تنطبق مرة أخرى على السوق؛ Sirven لتنظيم عملية المواصفات. من الناحية العملية، يستخدم المشروع النموذجي ما بين 15 و20 دورًا مختلفًا.

¿ما هي أفضل ورقة غش لأدوار ARIA؟

يعتمد ذلك على الاستخدام. لتنفيذ عنصر واجهة مستخدم على لوحة المفاتيح، يعد دليل ممارسات التأليف WAI-ARIA لـ W3C هو المرجع الأكثر اكتمالاً. من أجل استشارة خصائص دور محدد، فإن MDN Web Docs هو الأسرع. لتحديد ما إذا كانت هناك حاجة إلى دور يتعلق بعنصر HTML، فإن جدول HTML-ARIA لـ W3C هو العامل الحاسم.

هل تريد استخدام ARIA إذا كان هناك عنصر HTML أصلي؟

لا، تم تحديد القاعدة الأولى لـ ARIA في وجود عنصر HTML مع الدلالة والسلوك الذي تحتاجه، إذا تم استخدامه بدلاً من “قسم” مع دور. يعد إضافة role="button" إلى <button> زائدًا عن الحاجة ويمكنه تغيير السلوك الأصلي في بعض قراء الشاشة.

ما هو الفرق بين بكرة القطعة ولفة المعالم؟

تصف أدوار عناصر واجهة المستخدم عناصر التحكم التفاعلية — الزر، مربع الاختيار، الشريط التمرير، قائمة التبويب ​​- وتتطلب إدارة التركيز واللوحة. يتم وصف أدوار المعالم في مناطق الصفحة - الرئيسية، والتنقل، والشعار، والمحتوى - و صفارة الإنذار للتنقل حسب المناطق. عنصر واحد لا يجب أن يكمل الوظائف.

هل تختلف أدوار ARIA بين إصدارات المواصفات؟

نعم. WAI-ARIA 1.2 أدوار إضافية مثل “الاقتباس” و”التسمية التوضيحية” و”الرمز” و”الحذف” و”التأكيد” و”الإدراج” و”المقياس” و”الفقرة” و”القوي” و”المنخفض” و”النص المرتفع”. لقد أصبحت بعض الأدوار قديمة في الإصدارات الأحدث. يمكنك التحقق من MDN أو من خلال المواصفات الخاصة إذا كانت ستستمر في العمل قبل اعتمادها.

¿ورقة غش لأدوار ARIA basta لإكمال WCAG؟

لا، أدوار ARIA هي جزء من المعيار 4.1.2 الاسم والدور والشجاعة، لكن WCAG 2.2 تتضمن الكثير من المتطلبات الأخرى: التباين، البؤرة المرئية، حجم الهدف، النص البديل، الهيكل المغطى. تساعد ورقة الغش على تنفيذ الأدوار بشكل صحيح، ولا تكمل مجموعة معايير المطابقة.

المصادر ومزيد من القراءة

• ورقة الغش - ويكيبيديا: ورقة الغش (ورقة الغش أيضًا) أو ورقة سرير الأطفال أو المساعدة الوظيفية عبارة عن مجموعة موجزة من الملاحظات المستخدمة كمرجع سريع. تم استخدام أوراق الغش تاريخياً من قبل الطلاب دون…