التركيز

Interactive elements, including form controls, links, and buttons, are by default focusable and tabbable. تكون العناصر القابلة للتبويب جزءًا من ترتيب التنقّل المتسلسل للتركيز في المستند. العناصر الأخرى خاملة، مما يعني أنها ليست تفاعلية. باستخدام سمات HTML، يمكن جعل العناصر التفاعلية خاملة والعناصر الخاملة تفاعلية.

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

لا تغيِّر ترتيب علامات التبويب الظاهر والفعلي باستخدام CSS وHTML. كما يوضح المثالان التاليان، فإن ترتيبات علامات التبويب التي تختلف عن الترتيب المتوقع بصريًا تكون مربكة للمستخدمين وسيئة لتجربة المستخدم.

في المثال التالي، جعلت قيمة السمة tabindex ترتيب علامات التبويب فوضويًا:

في هذا المثال، أنشأت CSS تباعدًا بين ترتيب علامات التبويب والترتيب المرئي للمحتوى:

أدّى تعريف flex-flow: row-reverse; إلى عكس الترتيب المرئي. بالإضافة إلى ذلك، تم تطبيق سمة order في CSS على الكلمة السادسة، "This"، ما أدى إلى نقل هذه الكلمة الواحدة بشكل مرئي. تسلسل علامات التبويب هو ترتيب الرمز، والذي لم يعد يطابق الترتيب المرئي. يؤدي هذا إلى حدوث انقطاع لمستخدمي لوحة المفاتيح.

يمكن لبعض ميزات CSS، بما في ذلك نموذج flexbox والشبكة وتحديد الموضع والتحويلات والأعمدة المتعددة، تغيير الترتيب المرئي للمحتوى. اختبِر المحتوى من خلال التنقّل فيه باستخدام مفتاح Tab في لوحة المفاتيح: مع shift + tab للتنقّل للخلف في المحتوى. استخدِم CSS للإشارة إلى العنصر الذي يتم التركيز عليه. لا تُعِد ترتيب العناصر التي يمكن التركيز عليها باستخدام CSS.

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

جعل العناصر الخاملة تفاعلية

يمكن إضافة السمتَين contenteditable وtabindex إلى أي عنصر، لأنّهما سمتان عامتان، ما يجعلهما قابلتَين للتركيز عليهما أثناء العملية. يمكن أيضًا التركيز على العناصر التي يمكن التركيز عليها باستخدام الماوس أو المؤشر، من خلال ضبط السمة autofocus أو من خلال نص برمجي، مثل element.focus().

سمة tabindex

تتيح السمة العامة tabindex التي تم تقديمها في السمات للعناصر التي لا يمكنها تلقّي التركيز أن يتم التركيز عليها، عادةً باستخدام مفتاح التبويب (Tab)، ومن هنا جاء الاسم.

تأخذ السمة tabindex عددًا صحيحًا كقيمة لها. تجعل القيمة السالبة العنصر قابلاً للتركيز ولكن ليس قابلاً للتبويب. تؤدي قيمة 0 للسمة tabindex إلى جعل العنصر قابلاً للتركيز عليه والتنقّل إليه باستخدام مفتاح Tab، ما يضيف العنصر الذي تم تطبيق السمة عليه إلى ترتيب التنقّل المتسلسل للتركيز حسب ترتيب الرمز المصدر. القيمة 1 أو أكبر تجعل العنصر قابلاً للتركيز والجدولة، ولكنها تضيفه إلى تسلسل جدولة ذات أولوية ويجب تجنبها.

في هذه الصفحة، زر المشاركة <share-action> هو عنصر مخصّص. يضيف tabindex="0" هذا العنصر إلى ترتيب علامات التبويب التلقائي في لوحة المفاتيح:

<share-action authors="@front-end.social/@estellevw" data-action="click"
  data-category="web.dev" data-icon="share" data-label="share, mastodon"
  role="button" tabindex="0">
  <svg aria-label="share" role="img" xmlns="http://www.w3.org/2000/svg">
    <use href="#shareIcon" />
  </svg>
  <span>Share</span>
</share-action>

بالإضافة إلى ذلك، يحتوي التنقّل المحلي على عنصر مخصّص بقيمة tabindex سالبة:

<web-navigation-drawer type="standard" tabindex="-1">

تؤدي السمة tabindex ذات القيمة السالبة إلى جعل العنصر قابلاً للتركيز، ولكن لا يمكن التنقل إليه باستخدام مفتاح Tab. يمكن أن يتلقّى العنصر التركيز، مثل استخدام HTMLElement.focus()، ولكنّه ليس جزءًا من ترتيب التنقّل المتسلسل للتركيز. إنّ القاعدة المتّبعة للعناصر التي يمكن التركيز عليها ولا يمكن التنقّل إليها باستخدام مفتاح Tab هي استخدام tabindex="-1". إذا أضفت tabindex="-1" إلى عنصر تفاعلي، لن يكون قابلاً للتبويب بعد ذلك.

يمكن استخدام الطريقة element.focus() لضبط التركيز على العناصر القابلة للتركيز. تنتقل المتصفحات إلى العناصر التي تم التركيز عليها في العرض. لهذا السبب، تجنَّب استخدام element.focus({preventScroll:true})، لأنّ التركيز على عنصر غير مرئي يمثّل تجربة سيئة للمستخدم.

إذا أردت الاستعلام عن المستند لمعرفة العنصر الذي تم التركيز عليه، استخدِم السمة Document.activeElement للقراءة فقط.

يتم تضمين العناصر التي تحتوي على tabindex بقيمة 1 أو أكبر في تسلسل علامات تبويب منفصل. كما هو الحال في Codepen التالي، يبدأ التنقل باستخدام مفتاح Tab في تسلسل منفصل، بالترتيب من أدنى قيمة إلى أعلى قيمة، قبل الانتقال إلى تلك الموجودة في التسلسل العادي (لم يتم تعيين tabindex أو tabindex="0") بترتيب المصدر:

تؤدي السمة tabindex ذات القيمة الموجبة إلى وضع العنصر في تسلسل تركيز ذي أولوية، ما قد يؤدي إلى حدوث فوضى في ترتيب التركيز. تجنَّب تعديل ترتيب DOM باستخدام tabindex. يمكن أن يؤدي تغيير ترتيب التنقل باستخدام علامة التبويب إلى تجارب سيئة للمستخدم ويصعب الحفاظ عليها.

سمة contenteditable

السمة contenteditable هي سمة عامة. يؤدي تعيين contenteditable="true" على أي عنصر إلى جعله قابلاً للتحرير والتركيز وجزءًا من ترتيب علامات التبويب. يشبه سلوك التركيز ضبط السمة tabindex="0"، ولكنه ليس نفسه.

عناصر contenteditable المدمجة يمكن التركيز عليها ولكن لا يمكن التنقّل بينها باستخدام مفتاح Tab. لجعل عنصر contenteditable متداخل قابلاً للتبويب، أضِف tabindex="0"، ما يؤدي إلى إضافة العنصر إلى ترتيب التنقّل المتسلسل للتركيز.

منح autofocus للعناصر التفاعلية

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

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

الاستثناء الوحيد لاقتراح "عدم استخدام autofocus" هو تضمين السمة autofocus ضمن عناصر <dialog>. عند فتح مربّع حوار، يركّز المتصفّح تلقائيًا على أول عنصر تفاعلي يمكن التركيز عليه ضمن <dialog>، ما يعني أنّه ليس من الضروري إضافة autofocus إلى عنصر. إذا أردت التأكّد من أنّ عنصرًا تفاعليًا معيّنًا ضمن مربّع الحوار يتم التركيز عليه عند فتح مربّع الحوار، أضِف السمة autofocus إلى ذلك العنصر.

<dialog open>
  <form method="dialog">
    <button type="submit" autofocus>close</button>
  </form>
</dialog>

تسمح السمة autofocus التي تم ضبطها على الزر "إغلاق" <button> بالتركيز على الزر عند فتح مربّع الحوار. باعتباره العنصر الأول في مربع الحوار، كان من الممكن أن يحصل على التركيز في أي حال. بشكل تلقائي، عند فتح مربّع حوار، يتم التركيز على أول عنصر يمكن التركيز عليه ضمن مربّع الحوار ما لم يتم ضبط السمة autofocus لعنصر مختلف ضمن مربّع الحوار.

جعل العناصر التفاعلية خاملة

هناك أيضًا سمات HTML يمكنها إزالة العناصر التفاعلية من تسلسل علامات التبويب. إنّ تضمين سمة tabindex سالبة في العناصر القابلة للتركيز عليها، وإضافة سمة disabled إلى عناصر التحكّم في النماذج الداعمة، وإضافة سمة inert العامة إلى حاوية، كل ذلك يجعل العناصر غير قابلة للتنقّل باستخدام مفتاح Tab. هذه السمات الثلاث منفصلة تمامًا ولا يمكن استخدام أي منها كبديل عن الأخرى.

قيمة سالبة للسمة tabindex

تؤدي السمة tabindex ذات القيمة السالبة إلى جعل العنصر قابلاً للتركيز عليه، ولكن لا يمكن التنقّل إليه باستخدام مفتاح Tab. على الرغم من أنّ إضافة tabindex="0" إلى عنصر يمكن التركيز عليه تلقائيًا، بما في ذلك الروابط والأزرار وعناصر التحكّم في النماذج والعناصر التي تكون contenteditable غير ضرورية، فإنّ تضمين tabindex بقيمة سالبة يؤدي إلى إزالة العناصر التي يمكن التنقّل بينها عادةً باستخدام مفتاح Tab من ترتيب التنقّل المتسلسل للتركيز.

تمنع قيمة tabindex السالبة مستخدمي لوحة المفاتيح من التركيز على العناصر التفاعلية، ولكنّها لا توقف العنصر. سيظل بإمكان مستخدمي المؤشر التركيز على العنصر. لإيقاف عنصر، استخدِم السمة disabled.

غير مفعّل

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

‫disabled ليست سمة عامة. وينطبق على <button> و<input> و<optgroup> و<option> و<select> و<textarea> والعناصر المخصّصة المرتبطة بالنماذج و<fieldset>. عند ضبطه على <optgroup> أو <fieldset>، يتم إيقاف جميع عناصر التحكّم الثانوية في النماذج، باستثناء محتوى أول <legend> في <fieldset>.

يمكن أيضًا استهداف العناصر نفسها التي تتيح استخدام disabled من خلال الفئات الزائفة :disabled و:enabled. العناصر التي تم إيقافها باستخدام السمة disabled يتم عادةً تصميمها باللون الرمادي الفاتح باستخدام ورقة أنماط وكيل المستخدم، حتى في حال ضبط السمة accent-color.

بما أنّها سمة منطقية، يؤدي توفّرها إلى إيقاف العنصر الذي يكون مفعّلاً في حال عدم توفّرها، ولا يمكنك ضبطها على false. لإعادة تفعيل عنصر غير مفعّل، يجب إزالة السمة، وذلك بشكل عام باستخدام Element.removeAttribute('disabled').

تتيح لك السمة HTMLInputElement.disabled التحقّق مما إذا كان الإدخال غير مفعَّل. بما أنّ disabled ليست سمة عامة، لا يتم اكتسابها من HTMLElement، ولكن كل واجهة عنصر متوافقة، مثل HTMLSelectElement وHTMLTextareaElement، تتضمّن السمة نفسها المخصّصة للقراءة فقط.

لا تنطبق السمة disabled على عناصر inert العادية التي يمكن التركيز عليها باستخدام tabindex أو contenteditable، ولا تنطبق أيضًا على العنصر <form>. لإيقاف هذه العناصر، يمكن استخدام السمة العامة inert.

سمة inert

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

عند تطبيق السمة disabled على عناصر التحكّم في النماذج، يوفّر المتصفّح نمطًا تلقائيًا ويمكن تنسيقه باستخدام الفئة الزائفة :disabled. لا توفّر السمة inert أي مؤشرات مرئية ولا تتضمّن أي فئة زائفة مطابقة (على الرغم من أنّ محدّد السمة [inert] يتطابق معها).

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

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

لِنختبر معلوماتكاختبري معلوماتكِاختبِر معلوماتكَ

اختبِر معلوماتك حول التركيز.

إذا لم يكن من الممكن التركيز على عنصر ما، فكيف يتم وصفه؟

فارغ
يُرجى إعادة المحاولة.
Inert.
إجابة صحيحة.
 اللغات المخفية.
يُرجى إعادة المحاولة.

ما هي العبارة الصحيحة إذا كان العنصر يحتوي على السمة disabled؟

ولا يمكن التركيز عليه.
إجابة صحيحة.
ولا يتم عرضه.
يُرجى إعادة المحاولة.
إذا كان عنصر نموذج، لن يتم إرساله.
إجابة صحيحة.