HTMLالموسوعةواجهات برمجة تطبيقات HTML
61- مرجع سمات HTML
جميع سمات HTML والعناصر التي يمكن استخدامها ضمنها:
السمة | ينتمي إلى | الوصف |
---|---|---|
accept | <input> | يحدد أنواع الملفات التي يقبلها الخادم (فقط لنوع “file”) |
accept-charset | <form> | يحدد ترميزات الأحرف التي سيتم استخدامها لإرسال النموذج |
accesskey | سمات عامة | يحدد مفتاح اختصار لتنشيط/تركيز عنصر |
action | <form> | يحدد مكان إرسال بيانات النموذج عند تقديم النموذج |
align | غير مدعوم في HTML5 | يحدد المحاذاة وفقًا للعناصر المحيطة. استخدم CSS بدلاً من ذلك |
alt | <area>, <img>, <input> | يحدد نصًا بديلًا عندما يفشل العنصر الأصلي في العرض |
async | <script> | يحدد أن البرنامج النصي يتم تنفيذه بشكل غير متزامن (فقط للبرامج النصية الخارجية) |
autocomplete | <form>, <input> | يحدد ما إذا كان يجب تمكين الإكمال التلقائي لعنصر <form> أو <input> |
autofocus | <button>, <input>, <select>, <textarea> | يحدد أن العنصر يجب أن يحصل على التركيز تلقائيًا عند تحميل الصفحة |
autoplay | <audio>, <video> | يحدد أن الصوت/الفيديو سيبدأ التشغيل بمجرد أن يصبح جاهزًا |
bgcolor | غير مدعوم في HTML5 | يحدد لون خلفية العنصر. استخدم CSS بدلاً من ذلك |
border | غير مدعوم في HTML5 | يحدد عرض حدود العنصر. استخدم CSS بدلاً من ذلك |
charset | <meta>, <script> | يحدد ترميز الأحرف |
checked | <input> | يحدد أنه يجب تحديد عنصر <input> مسبقًا عند تحميل الصفحة (لنوع “checkbox” أو “radio”) |
السمة | ينتمي إلى | الوصف |
---|---|---|
cite | <blockquote>, <del>, <ins>, <q> | يحدد عنوان URL يشرح الاقتباس/النص المحذوف/المُدرج |
class | سمات عامة | يحدد واحدًا أو أكثر من أسماء الفئات لعنصر (يشير إلى فئة في ورقة الأنماط) |
color | غير مدعوم في HTML5 | يحدد لون النص للعنصر. استخدم CSS بدلاً من ذلك |
cols | <textarea> | يحدد العرض المرئي لمنطقة النص |
colspan | <td>, <th> | يحدد عدد الأعمدة التي يجب أن تمتد الخلية عبرها |
content | <meta> | يعطي القيمة المرتبطة بسمة http-equiv أو name |
contenteditable | سمات عامة | يحدد ما إذا كان محتوى العنصر قابلاً للتحرير أم لا |
controls | <audio>, <video> | يحدد أنه يجب عرض عناصر التحكم في الصوت/الفيديو (مثل زر التشغيل/الإيقاف المؤقت وما إلى ذلك) |
coords | <area> | يحدد إحداثيات المنطقة |
data | <object> | يحدد عنوان URL للمورد الذي سيتم استخدامه بواسطة الكائن |
data-* | سمات عامة | تُستخدم لتخزين البيانات المخصصة الخاصة بالصفحة أو التطبيق |
datetime | <del>, <ins>, <time> | يحدد التاريخ والوقت |
default | <track> | يحدد أنه سيتم تمكين المسار إذا كانت تفضيلات المستخدم لا تشير إلى أن مسارًا آخر سيكون أكثر ملاءمة |
defer | <script> | يحدد أنه يتم تنفيذ البرنامج النصي عند انتهاء المتصفح من تحليل الصفحة (فقط للبرامج النصية الخارجية) |
dir | سمات عامة | يحدد اتجاه النص للمحتوى في عنصر |
dirname | <input>, <textarea> | يحدد أنه سيتم إرسال اتجاه النص |
disabled | <button>, <fieldset>, <input>, <optgroup>, <option>, <select>, <textarea> | يحدد أنه يجب تعطيل العنصر/مجموعة العناصر المحددة |
download | <a>, <area> | يحدد أنه سيتم تنزيل الهدف عند نقر المستخدم على الرابط التشعبي |
draggable | سمات عامة | يحدد ما إذا كان العنصر قابلاً للسحب أم لا |
enctype | <form> | يحدد كيفية ترميز بيانات النموذج عند إرسالها إلى الخادم (فقط لطريقة “post”) |
السمة | ينتمي إلى | الوصف |
---|---|---|
enterkeyhint | سمات عامة | يحدد نص مفتاح الإدخال على لوحة المفاتيح الافتراضية |
for | <label>, <output> | يحدد عنصر (عناصر) النموذج الذي ترتبط به التسمية/الحساب |
form | <button>, <fieldset>, <input>, <label>, <meter>, <object>, <output>, <select>, <textarea> | يحدد اسم النموذج الذي ينتمي إليه العنصر |
formaction | <button>, <input> | يحدد مكان إرسال بيانات النموذج عند تقديمه. فقط لنوع “submit” |
headers | <td>, <th> | يحدد خلية رأس واحدة أو أكثر مرتبطة بخلية |
height | <canvas>, <embed>, <iframe>, <img>, <input>, <object>, <video> | يحدد ارتفاع العنصر |
hidden | سمات عامة | يحدد أن العنصر لم يعد أو لم يعد ذا صلة |
high | <meter> | يحدد النطاق الذي يعتبر قيمة عالية |
href | <a>, <area>, <base>, <link> | يحدد عنوان URL للصفحة التي ينتقل إليها الرابط |
hreflang | <a>, <area>, <link> | يحدد لغة المستند المرتبط |
http-equiv | <meta> | يوفر رأس HTTP للمعلومات/القيمة لسمة المحتوى |
id | سمات عامة | يحدد معرفًا فريدًا لعنصر |
inert | سمات عامة | يحدد أنه ينبغي للمتصفح تجاهل هذا القسم |
inputmode | سمات عامة | يحدد وضع لوحة المفاتيح الافتراضية |
ismap | <img> | يحدد صورة كخريطة صورة من جانب الخادم |
kind | <track> | يحدد نوع مسار النص |
label | <track>, <option>, <optgroup> | يحدد عنوان مسار النص |
lang | سمات عامة | يحدد لغة محتوى العنصر |
list | <input> | يشير إلى عنصر <datalist> الذي يحتوي على خيارات محددة مسبقًا لعنصر <input> |
loop | <audio>, <video> | يحدد أن الصوت/الفيديو سيبدأ من جديد في كل مرة ينتهي فيها |
low | <meter> | يحدد النطاق الذي يعتبر قيمة منخفضة |
max | <input>, <meter>, <progress> | يحدد القيمة القصوى |
maxlength | <input>, <textarea> | يحدد الحد الأقصى لعدد الأحرف المسموح به في عنصر |
media | <a>, <area>, <link>, <source>, <style> | يحدد الوسائط/الجهاز الذي تم تحسين المستند المرتبط له |
method | <form> | يحدد طريقة HTTP لاستخدامها عند إرسال بيانات النموذج |
min | <input>, <meter> | يحدد قيمة دنيا |
multiple | <input>, <select> | يحدد أنه يمكن للمستخدم إدخال أكثر من قيمة واحدة |
muted | <video>, <audio> | يحدد أنه ينبغي كتم صوت إخراج الفيديو |
name | <button>, <fieldset>, <form>, <iframe>, <input>, <map>, <meta>, <object>, <output>, <param>, <select>, <textarea> | يحدد اسم العنصر |
novalidate | <form> | يحدد أنه لا ينبغي التحقق من صحة النموذج عند تقديمه |
onabort | <audio>, <embed>, <img>, <object>, <video> | البرنامج النصي الذي سيتم تشغيله عند الإجهاض |
onafterprint | <body> | البرنامج النصي الذي سيتم تشغيله بعد طباعة المستند |
onbeforeprint | <body> | البرنامج النصي الذي سيتم تشغيله قبل طباعة المستند |
onbeforeunload | <body> | البرنامج النصي الذي سيتم تشغيله عندما يكون المستند على وشك التفريغ |
onblur | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند فقد العنصر للتركيز |
oncanplay | <audio>, <embed>, <object>, <video> | البرنامج النصي الذي سيتم تشغيله عندما يكون الملف جاهزًا لبدء |
السمة | ينتمي إلى | الوصف |
---|---|---|
oncanplaythrough | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عندما يمكن تشغيل ملف حتى النهاية دون التوقف للتخزين المؤقت |
onchange | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند تغيير قيمة العنصر |
onclick | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند النقر فوق العنصر |
oncontextmenu | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند تشغيل قائمة السياق |
oncopy | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند نسخ محتوى العنصر |
oncuechange | <track> | البرنامج النصي الذي سيتم تشغيله عند تغير الإشارات في عنصر <track> |
oncut | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند قطع محتوى العنصر |
ondblclick | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند النقر المزدوج فوق العنصر |
ondrag | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند سحب العنصر |
ondragend | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله في نهاية عملية السحب |
ondragenter | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند سحب عنصر إلى هدف إسقاط صالح |
ondragleave | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند مغادرة عنصر لهدف إسقاط صالح |
ondragover | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند سحب عنصر فوق هدف إسقاط صالح |
ondragstart | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله في بداية عملية السحب |
ondrop | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند إسقاط العنصر المسحوب |
ondurationchange | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند تغير طول الوسائط |
onemptied | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند حدوث خطأ ما ويصبح الملف غير متاح فجأة (مثل الانفصال غير المتوقع) |
onended | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند وصول الوسائط إلى النهاية (حدث مفيد لرسائل مثل “شكرًا على الاستماع”) |
onerror | <audio>, <body>, <embed>, <img>, <object>, <script>, <style>, <video> | البرنامج النصي الذي سيتم تشغيله عند حدوث خطأ |
onfocus | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند حصول العنصر على التركيز |
onhashchange | <body> | البرنامج النصي الذي سيتم تشغيله عند حدوث تغييرات في جزء الربط من عنوان URL |
oninput | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند حصول العنصر على إدخال من المستخدم |
oninvalid | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند كون العنصر غير صالح |
onkeydown | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند الضغط على مفتاح |
onkeypress | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند الضغط على مفتاح |
onkeyup | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند تحرير مفتاح |
onload | <body>, <iframe>, <img>, <input>, <link>, <script>, <style> | البرنامج النصي الذي سيتم تشغيله عند انتهاء تحميل العنصر |
onloadeddata | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند تحميل بيانات الوسائط |
onloadedmetadata | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند تحميل البيانات الوصفية (مثل الأبعاد والمدة) |
onloadstart | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله بمجرد بدء تحميل الملف قبل تحميل أي شيء فعليًا |
onmousedown | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند الضغط على زر الماوس فوق عنصر |
onmousemove | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله طالما أن مؤشر الماوس يتحرك فوق عنصر |
onmouseout | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند خروج مؤشر الماوس من عنصر |
السمة | ينتمي إلى | الوصف |
---|---|---|
onmouseover | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند تحرك مؤشر الماوس فوق عنصر |
onmouseup | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند تحرير زر الماوس فوق عنصر |
onmousewheel | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند تمرير عجلة الماوس فوق عنصر |
onoffline | <body> | البرنامج النصي الذي سيتم تشغيله عند بدء تشغيل المتصفح في وضع عدم الاتصال |
ononline | <body> | البرنامج النصي الذي سيتم تشغيله عند بدء تشغيل المتصفح في وضع الاتصال |
onpagehide | <body> | البرنامج النصي الذي سيتم تشغيله عند مغادرة المستخدم لصفحة |
onpageshow | <body> | البرنامج النصي الذي سيتم تشغيله عند انتقال المستخدم إلى صفحة |
onpaste | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند لصق المستخدم لبعض المحتوى في عنصر |
onpause | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند إيقاف الوسائط مؤقتًا إما بواسطة المستخدم أو برمجيًا |
onplay | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند بدء تشغيل الوسائط |
onplaying | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند بدء تشغيل الوسائط |
onpopstate | <body> | البرنامج النصي الذي سيتم تشغيله عند تغيير محفوظات النافذة |
onprogress | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عندما يكون المتصفح في عملية الحصول على بيانات الوسائط |
onratechange | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله في كل مرة يتغير فيها معدل التشغيل (مثل عندما ينتقل المستخدم إلى وضع الحركة البطيئة أو وضع التقديم السريع) |
onreset | <form> | البرنامج النصي الذي سيتم تشغيله عند النقر فوق زر إعادة تعيين في نموذج |
onresize | <body> | البرنامج النصي الذي سيتم تشغيله عند تغيير حجم نافذة المتصفح |
onscroll | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند تمرير شريط تمرير العنصر |
onsearch | <input> | البرنامج النصي الذي سيتم تشغيله عندما يكتب المستخدم شيئًا في حقل بحث (لـ <input type=”search”>) |
onseeked | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند تعيين السمة “seeking” إلى “false” للإشارة إلى انتهاء البحث |
onseeking | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند تعيين السمة “seeking” إلى “true” للإشارة إلى أن البحث نشط |
onselect | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند تحديد العنصر |
onstalled | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عندما يتعذر على المتصفح إحضار بيانات الوسائط لأي سبب من الأسباب |
onstorage | <body> | البرنامج النصي الذي سيتم تشغيله عند تحديث منطقة Web Storage |
onsubmit | <form> | البرنامج النصي الذي سيتم تشغيله عند إرسال نموذج |
onsuspend | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند إيقاف جلب بيانات الوسائط قبل تحميلها بالكامل لأي سبب من الأسباب |
السمة | ينتمي إلى | الوصف |
---|---|---|
ontimeupdate | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند تغيير موضع التشغيل (مثل عندما يقوم المستخدم بالترجيع السريع إلى نقطة مختلفة في الوسائط) |
ontoggle | <details> | البرنامج النصي الذي سيتم تشغيله عند فتح المستخدم أو إغلاق عنصر <details> |
onunload | <body> | البرنامج النصي الذي سيتم تشغيله عند إلغاء تحميل صفحة (أو إغلاق نافذة المتصفح) |
onvolumechange | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله في كل مرة يتغير فيها حجم الفيديو/الصوت |
onwaiting | <audio>, <video> | البرنامج النصي الذي سيتم تشغيله عند إيقاف الوسائط مؤقتًا ولكن من المتوقع استئنافها (مثل عندما تتوقف الوسائط مؤقتًا لتحميل المزيد من البيانات) |
onwheel | جميع العناصر المرئية | البرنامج النصي الذي سيتم تشغيله عند تمرير عجلة الماوس لأعلى أو لأسفل فوق عنصر |
open | <details> | يحدد أنه يجب أن تكون التفاصيل مرئية (مفتوحة) للمستخدم |
optimum | <meter> | يحدد القيمة المثلى لمقياس القياس |
pattern | <input> | يحدد تعبيرًا عاديًا يتم التحقق من قيمة عنصر <input> مقابلها |
placeholder | <input>, <textarea> | يحدد تلميحًا قصيرًا يصف القيمة المتوقعة للعنصر |
popover | سمات عامة | يحدد عنصر popover |
popovertarget | <button>, <input> | يحدد عنصر popover الذي يجب استدعاؤه |
popovertargetaction | <button>, <input> | يحدد ما يحدث لعنصر popover عند النقر فوق الزر |
poster | <video> | يحدد صورة يتم عرضها أثناء تنزيل الفيديو، أو حتى يضغط المستخدم على زر التشغيل |
preload | <audio>, <video> | يحدد ما إذا وكيف يعتقد المؤلف أنه يجب تحميل الصوت/الفيديو عند تحميل الصفحة |
readonly | <input>, <textarea> | يحدد أن العنصر للقراءة فقط |
rel | <a>, <area>, <form>, <link> | يحدد العلاقة بين المستند الحالي والمستند المرتبط |
required | <input>, <select>, <textarea> | يحدد أنه يجب ملء العنصر قبل إرسال النموذج |
reversed | <ol> | يحدد أن ترتيب القائمة يجب أن يكون تنازليًا (9، 8، 7 …) |
rows | <textarea> | يحدد العدد المرئي من الأسطر في منطقة النص |
rowspan | <td>, <th> | يحدد عدد الصفوف التي يجب أن يمتد إليها خلية الجدول |
sandbox | <iframe> | يمكّن مجموعة إضافية من القيود على المحتوى في <iframe> |
scope | <th> | يحدد ما إذا كانت خلية الرأس هي رأس لعمود أو صف أو مجموعة من الأعمدة أو الصفوف |
selected | <option> | يحدد أنه يجب تحديد خيار مسبقًا عند تحميل الصفحة |
shape | <area> | يحدد شكل المنطقة |
size | <input>, <select> | يحدد العرض، بالحرف (لـ <input>) أو يحدد عدد الخيارات المرئية (لـ <select>) |
sizes | <img>, <link>, <source> | يحدد حجم المورد المرتبط |
span | <col>, <colgroup> | يحدد عدد الأعمدة التي يجب أن تمتد |
spellcheck | سمات عامة | يحدد ما إذا كان سيتم فحص هجاء العنصر وقواعده أم لا |
src | <audio>, <embed>, <iframe>, <img>, <input>, <script>, <source>, <track>, <video> | يحدد عنوان URL لملف الوسائط |
srcdoc | <iframe> | يحدد محتوى HTML للصفحة المراد إظهارها في <iframe> |
srclang | <track> | يحدد لغة بيانات نص المسار (مطلوب إذا كان النوع “subtitles”) |
srcset | <img>, <source> | يحدد عنوان URL للصورة المراد استخدامها في مواقف مختلفة |
start | <ol> | يحدد قيمة |
السمة | ينتمي إلى | الوصف |
---|---|---|
step | <input> | يحدد الفواصل الرقمية القانونية لحقل الإدخال |
style | سمات عامة | يحدد نمط CSS مضمن لعنصر |
tabindex | سمات عامة | يحدد ترتيب التنقل بين العناصر باستخدام المفتاح Tab |
target | <a>, <area>, <base>, <form> | يحدد الهدف لمكان فتح المستند المرتبط أو مكان إرسال النموذج |
title | سمات عامة | يحدد معلومات إضافية حول عنصر |
translate | سمات عامة | يحدد ما إذا كان ينبغي ترجمة محتوى عنصر أم لا |
type | <a>, <button>, <embed>, <input>, <link>, <menu>, <object>, <script>, <source>, <style> | يحدد نوع العنصر |
usemap | <img>, <object> | يحدد صورة كخريطة صورة من جانب العميل |
value | <button>, <input>, <li>, <option>, <meter>, <progress>, <param> | يحدد قيمة العنصر |
width | <canvas>, <embed>, <iframe>, <img>, <input>, <object>, <video> | يحدد عرض العنصر |
wrap | <textarea> | يحدد كيفية لف النص في منطقة النص عند إرساله في نموذج |