HTML/Global Attributes

الخاصيات العامة هي الخاصية التي يمكن استعمالها في جميع عناصر HTML، على الرغم من أنَّها قد لا يكون لها تأثير إن استعملت على بعض العناصر.

يمكن أن تستعمل الخاصيات العامة على جميع عناصر HTML حتى لو لم تكن هذه العناصر موجودةً في المعيار، وهذا يعني أنَّ العناصر غير المعيارية يجب أن تسمح باستخدام هذه الخاصية، حتى لو كان استخدام هذه العناصر سيؤدي إلى جعل المستند غير متوافق مع معيار HTML5. فمثلًا ستخفي المتصفحات التي تدعم HTML5 المحتوى الموجود ضمن العنصر <foo hidden>...</foo> حتى لو كان العنصر <foo> ليس موجودًا في المعيار.

إضافةً إلى العناصر المذكورة في هذه الصفحة، فإنَّ الخاصيات الآتية متوافرة:

• الخاصيتان xml:lang و xml:base، المأخوذتان من مواصفة XHTML، لكنهما ما تزالان مدعومتنا لغرض التوافقية.
• خاصيات aria-*‎ الموجودة لغرض زيادة قابلية الوصول.
• الخاصيات التي تستعمل للتعامل مع الأحداث: onabort، و onautocomplete، و onautocompleteerror، و onblur، و oncancel، و oncanplay، و oncanplaythrough، و onchange، و onclick، و onclose، و oncontextmenu، و oncuechange، و ondblclick، و ondrag، و ondragend، و ondragenter، و ondragexit، و ondragleave، و ondragover، و ondragstart، و ondrop، و ondurationchange، و onemptied، و onended، و onerror، و onfocus، و oninput، و oninvalid، و onkeydown، و onkeypress، و onkeyup، و onload، و onloadeddata، و onloadedmetadata، و onloadstart، و onmousedown، و onmouseenter، و onmouseleave، و onmousemove، و onmouseout، و onmouseover، و onmouseup، و onmousewheel، و onpause، و onplay، و onplaying، و onprogress، و onratechange، و onreset، و onresize، و onscroll، و onseeked، و onseeking، و onselect، و onshow، و onsort، و onstalled، و onsubmit، و onsuspend، و ontimeupdate، و ontoggle، و onvolumechange، و onwaiting.

الخاصيات

accesskey

تحديد اختصار للوحة المفاتيح للعنصر الحالي، وقيمة هذه الخاصية تتألف من محارف مفصولٌ بينها بفراغ، وسيستعمل المتصفح أوّل محرف موجود في تخطيط لوحة المفاتيح المستخدم في الحاسوب.

class

قائمة مفصولة بفراغات تُشير إلى الأصناف المستخدمة في العنصر، إذ تسمح الأصناف لشيفرات CSS و JavaScript بتحديد والوصول إلى عناصر معيّنة.

contenteditable

تُشير هذه الخاصية إذا كان العنصر قابلًا للتعديل من المستخدم، وإذا كان كذلك فسيتخذ المتصفح الإجراءات اللازمة للسماح بالتعديل. تأخذ هذه الخاصية إحدى القيمتين الآتيتين:

• true أو سلسلة نصية فارغة، تُشير إلى أنَّ العنصر يمكن تعديله.
• false، تُشير إلى أنَّ العنصر لا يجوز تعديله.

contextmenu

تأخذ هذه الخاصية قيمة الخاصية id لعنصر <menu> لكي يُستعمَل ككقائمة خاصة بهذا العنصر.

data-*‎

فئة من الخاصيات المخصصة التي تسمح بتبادل المعلومات بين HTML و DOM مما يسمح باستخدامها في السكربتات.

جميع هذه البيانات متوافرة عبر واجهة HTMLElement البرمجية للعنصر المضبوطة عليه، وتسمح لنا الخاصية HTMLElement.dataset بالوصول إليها.

dir

تُشير قيمة هذه الخاصية إلى اتجاه النص في العنصر، وتأخذ إحدى القيم الآتية:

• ltr: التي تعني left to right أي اتجاه النص من اليسار إلى اليمين، مثل اللغة الإنكليزية.
• rtl: التي تعني right to left أي اتجاه النص من اليمين إلى اليسار، مثل اللغة العربية.
• auto: ترك القرار إلى المتصفح إذ يستعمل خوارزمية بسيطة لتحديد اتجاه النص.

draggable

تُشير هذه الخاصية إلى أنَّ العنصر يمكن سحبه باستخدام الواجهة البرمجية Drag and Drop.

هذه الخاصية منطقية (Boolean) أي تأخذ true أو false.

dropzone

تُشير هذه الخاصية إلى الذي سيحدث للعنصر الذي سيُفلَت باستخدام الواجهة البرمجية Drag and Drop، وتأخذ إحدى القيم الآتية:

• copy: التي تشير إلى أنَّ الإفلات سيؤدي إلى إنشاء نسخة من العنصر المسحوب.
• move: التي تشير إلى أنَّ الإفلات سيؤدي إلى نقل العنصر المسحوب إلى مكانٍ جديد.
• link: إنشاء رابط إلى البيانات المسحوبة.

hidden

خاصية منطقية (Boolean) تُشير إلى أنَّ العنصر لم تعد له أهمية أو ليس له أهمية حاليًا.

فمثلًا يمكن أن تستعمل هذه الخاصية لإخفاء عناصر في الصفحة التي لا يمكن استخدامها إلا بعد تعبئة نموذج ما، ولن يعرض المتصفح هذه العناصر.

id

تُمثِّل هذه الخاصية مُعرِّفًا فريدًا (unique identifier) أي أنَّ قيمة هذه الخاصية لا يجوز أن تتكرر في أيّ عنصر آخر، والغرض من هذه الخاصية هو القدرة على التعامل مع العنصر باستخدام السكربتات أو عبر لغة CSS.

lang

تساهم هذه الخاصية في تعريف لغة العنصر، وهي اللغة التي كُتِبَت فيها محتويات العنصر، ويجب أن تكون قيمة هذه الخاصية بصيغة BCP47.

لاحظ أنَّ الخاصية xml:lang لها أولوية عليها.

spellcheck

تُعرِّف هذه الخاصية إذا كان يجب التحقق من الأخطاء الإملائية في العنصر.

هذه الخاصية منطقية (Boolean) أي تأخذ true أو false.

style

تحتوي على تعليمات التنسيق بلغة CSS التي يجب تطبيقها على العنصر، لاحظ أنَّ من المستحسن تعريف الأنماط في ملف أو ملفات منفصلة.

الغرض الرئيسي من توفير هذه الخاصية (إضافةً إلى العنصر <style>) هو السماح بتنسيق العناصر بسرعة لأغراض مثل التجربة.

tabindex

تأخذ هذه الخاصية قيمةً عدديةً صحيحةً تُشير إذا كان هذا العنصر يساهم في التنقل عبر لوحة المفاتيح، ويمكن أن تأخذ هذه الخاصية عدِّة قيم:

• القيم السالبة تعني أنَّ العنصر يمكن التركيز عليه (focusable) لكن لا يمكن الوصول إليه عبر لوحة المفاتيح.
• القيمة 0 تعني أنَّ العنصر يمكن التركيز عليه وقابل للوصول عبر لوحة المفاتيح، لكن ترتيبه يخضع للمتصفح.
• القيم الموجبة تعني أنَّ العنصر يمكن التركيز عليه وقابل للوصول عبر لوحة المفاتيح، وترتيبه النسبي يخضع لقيمة هذه الخاصية، فعند زيادة العدد ستزداد أولوية هذا العنصر، والعناصر التي لها نفس القيمة لخاصية tabindex سيكون ترتيب الوصول إليها في المستند اعتمادًا على ترتيب ورودها في المستند.

title

تحتوي هذه الخاصية على معلومات نصية تُمثِّل العنصر الذي تنتمي إليه، ومثل هذه المعلومات تُعرَض عادةً على شكل tooltip (لكن ذلك ليس إلزاميًا).

translate

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

تأخذ هذه الخاصية القيم الآتية:

• سلسلة نصية فارغة أو yes، التي تُشير إلى أنَّ العنصر يجب ترجمته.
• no التي تشير إلى أنَّ العنصر لا تجوز ترجمته.