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

زر بلا اسم يقرؤه قارئ الشاشة

a11y-button-nameحرِج
في هذه الصفحة

لماذا يهم

  • أزرار الأيقونات، مثل الإضافة إلى السلة أو إلى المفضلة والبحث والإغلاق، تعرض صورة فقط. وبلا اسم يعلن قارئ الشاشة عن كل منها زراً، فلا يعرف المستخدم أيها يفعل ماذا.
  • تطلب WCAG 2.2 أن يكون لكل عنصر تحكّم اسم تقرؤه التقنيات المساعدة (المعيار 4.1.2، المستوى A).

مثال

خطأ
<button id="wishlist" type="button"><svg aria-hidden="true" width="16" height="16" viewBox="0 0 16 16"><circle cx="8" cy="8" r="8" /></svg></button>
صحيح
<button id="wishlist" type="button" aria-label="أضف إلى المفضلة"><svg aria-hidden="true" width="16" height="16" viewBox="0 0 16 16"><circle cx="8" cy="8" r="8" /></svg></button>

كيف تُصلح

  • أعطِ كل زر أيقونة اسماً بلغة الصفحة: <button type="button" aria-label="أضف إلى المفضلة">…</button>.
  • أو ضع في الزر نصاً ظاهراً بجانب الأيقونة.
  • أبقِ aria-hidden="true" على الأيقونة نفسها، فلا تُقرأ مرتين.

كيف نكشف

  1. نعرض الصفحة ونشغّل قاعدة button-name في axe-core 4.13.0 في كل محرّك.
  2. تبلّغ عن كل عنصر <button> اسمه فارغ: بلا نص، وبلا aria-label أو aria-labelledby أو title. أما الأزرار المكتوبة <input type="button"> وأمثالها فلها قاعدة أخرى في axe، input-button-name، يقرؤها Arablyzer أيضاً.
  3. لا تنطبق على الصفحات التي بلا أزرار.