English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

دليل مرجعي لـ HTML

مجموعة كاملة من عناصر HTML

أحداث HTML

قيمة معالج الأحداث هي واحدة أو سلسلة من تعبيرات JavaScript، أو طرق، أو دعوات للوظائف، مفصولة بمسافات متماثلة، ويتم تقييمها بين أقواس مزدوجة. عند حدوث الحدث، يقوم المتصفح بتنفيذ هذه الأوامر.

خصائص أحداث عالمية

واحدة من خصائص HTML4 الجديدة هي إمكانية جعل HTML تطلق سلوكًا في المتصفح، مثل بدء قطعة من JavaScript عند ضغط المستخدم على عنصر HTML.

يقدم الجدول أدناه خصائص أحداث المعايير، والتي يمكن إدراجها في عناصر HTML/XHTML لتعريف سلوك الأحداث.

HTML5: أحداث خصائص HTML5 الجديدة.

خصائص أحداث النافذة (خصائص أحداث النافذة)

باستخدام النافذة لانفجار الحدث (للمعاملات <body>):

صفةقيمةوصف
onafterprintHTML5scriptعند انتهاء طباعة المستند يتم تشغيل البرنامج النصي
onbeforeprintHTML5scriptعند طباعة المستند يتم تشغيل البرنامج النصي قبل ذلك
onbeforeonloadHTML5scriptعند تحميل المستند يتم تشغيل البرنامج النصي قبل ذلك
onblurscriptعند فقدان التركيز في النافذة يتم تشغيل البرنامج النصي
onerrorHTML5scriptعند حدوث خطأ يتم تشغيل البرنامج النصي
onfocusscriptعند الحصول على التركيز في النافذة يتم تشغيل البرنامج النصي
onhaschangeHTML5scriptعند تغيير المستند يتم تشغيل البرنامج النصي
onloadscriptعند تحميل المستند يتم تشغيل البرنامج النصي
onmessageHTML5scriptعند تفعيل الرسالة يتم تشغيل البرنامج النصي
onofflineHTML5scriptعند انقطاع الاتصال بالمستند يتم تشغيل البرنامج النصي
ononlineHTML5scriptعند وضع المستند على الإنترنت يتم تشغيل البرنامج النصي
onpagehideHTML5scriptعند إخفاء النافذة يتم تشغيل البرنامج النصي
onpageshowHTML5scriptعند وجود النافذة في الوضع المرئي يتم تشغيل البرنامج النصي
onpopstateHTML5scriptعند تغيير سجل النافذة يتم تشغيل البرنامج النصي
onredoHTML5scriptعند تنفيذ إعادة التشغيل في المستند يتم تشغيل البرنامج النصي
onresizeHTML5scriptعند تغيير حجم النافذة يتم تشغيل البرنامج النصي
onstorageHTML5scriptعند تحديث منطقة التخزين على الويب (عند تغيير بيانات التخزين في المساحة) يتم تشغيل البرنامج النصي
onundoHTML5scriptعند تنفيذ إلغاء التعديل في المستند يتم تشغيل البرنامج النصي
onunloadHTML5scriptعند مغادرة المستخدم المستند يتم تشغيل البرنامج النصي

أحداث النموذج (Form Events)

تُطلق أحداث النموذج في نموذج HTML (يُستخدم لجميع عناصر HTML، لكن العنصر يجب أن يكون داخل نموذج form):

صفةقيمةوصف
onblurscriptعند فقدان التركيز في العنصر يتم تشغيل البرنامج النصي
onchangescriptعند تغيير العنصر يتم تشغيل البرنامج النصي
oncontextmenuHTML5scriptعند تفعيل قائمة السياق يتم تشغيل البرنامج النصي
onfocusscriptعند الحصول على التركيز في العنصر يتم تشغيل البرنامج النصي
onformchangeHTML5scriptعند تغيير النموذج يتم تشغيل البرنامج النصي
onforminputHTML5scriptعند الحصول على إدخال المستخدم في النموذج يتم تشغيل البرنامج النصي
oninputHTML5scriptعند الحصول على إدخال المستخدم في العنصر يتم تشغيل البرنامج النصي
oninvalidHTML5scriptعند عدم صحة العنصر يتم تشغيل البرنامج النصي
onresetscriptعند إعادة تعيين النموذج يتم تشغيل البرنامج النصي. غير مدعوم في HTML 5.
onselectscriptعند اختيار العنصر يتم تشغيل البرنامج النصي
onsubmitscriptعند تقديم النموذج يتم تشغيل البرنامج النصي

أحداث لوحة المفاتيح (Keyboard Events)

صفةقيمةوصف
onkeydownscriptعند الضغط على المفتاح يتم تشغيل البرنامج النصي
onkeypressscriptعند الضغط والإطلاق المفتاح يتم تشغيل البرنامج النصي
onkeyupscriptعند إطلاق المفتاح يتم تشغيل البرنامج النصي

أحداث الماوس (Mouse Events)

تُطلق الأحداث بالماوس، مثل سلوك المستخدم:

صفةقيمةوصف
onclickscriptعند ضغط الماوس مرة واحدة يتم تشغيل البرنامج النصي
ondblclickscriptعند ضغط الماوس مزدوجًا يتم تشغيل البرنامج النصي
onmousedownscriptعندما يتم الضغط على زر الفأرة أثناء تشغيل السكربت
onmousemovescriptعندما يتم تحريك مؤشر الفأرة أثناء تشغيل السكربت
onmouseoutscriptعندما يتم تحريك مؤشر الفأرة خارج العنصر أثناء تشغيل السكربت
onmouseoverscriptعندما يتم تحريك مؤشر الفأرة فوق العنصر أثناء تشغيل السكربت
onmouseupscriptعندما يتم إطلاق زر الفأرة أثناء تشغيل السكربت
onmousewheelHTML5scriptعندما يتم تناول عجلة الفأرة أثناء تشغيل السكربت

أحداث السحب (Drag Events)

من خلال سحب الفأرة يتم تفعيل الحدث، مثل سلوك المستخدم:

صفةقيمةوصف
ondragHTML5scriptعندما يتم سحب العنصر أثناء تشغيل السكربت
ondragendHTML5scriptعندما يتم إنهاء عملية السحب أثناء تشغيل السكربت
ondragenterHTML5scriptعندما يتم سحب العنصر إلى وجهة التحرير الصالحة أثناء تشغيل السكربت
ondragleaveHTML5scriptعندما يترك العنصر وجهة التحرير الصالحة أثناء تشغيل السكربت
ondragoverHTML5scriptعندما يتم سحب العنصر إلى وجهة التحرير الصالحة أثناء تشغيل السكربت
ondragstartHTML5scriptعندما يتم بدء عملية السحب أثناء تشغيل السكربت
ondropHTML5scriptعندما يتم سحب العنصر أثناء التحرير أثناء تشغيل السكربت
onscrollHTML5scriptعندما يتم سحب علامة التمرير لعدد العناصر الوسائطية أثناء تشغيل السكربت

الأحداث الوسائطية (Media Events)

من خلال الفيديوهات (videos)، الصور (images) أو الأصوات (audio) يتم تفعيل هذا الحدث، ويدعى غالباً لتطبيقها على عناصر الوسائط في HTML <audio>, <embed>, <img>, <object>, و <video>):

صفةقيمةوصف
onabortscriptعندما يحدث حدث التوقف أثناء تشغيل السكربت
oncanplayHTML5scriptعندما يمكن بدء تشغيل الوسائط لكن قد يتطلب التوقف بسبب التحميل أثناء تشغيل السكربت
oncanplaythroughHTML5scriptعندما يمكن تشغيل الوسائط حتى النهاية دون التوقف بسبب التحميل أثناء تشغيل السكربت
ondurationchangeHTML5scriptعندما يتم تغيير طول الوسائط أثناء تشغيل السكربت
onemptiedHTML5scriptعندما يصبح عنصر الوسائط خالياً بشكل مفاجئ (أخطاء في الشبكة، أخطاء في التحميل، إلخ) أثناء تشغيل السكربت
onendedHTML5scriptعندما يصل الوسيط إلى نهايته أثناء تشغيل السكربت
onerrorHTML5scriptعندما يحدث خطأ أثناء تحميل العنصر أثناء تشغيل السكربت
onloadeddataHTML5scriptعندما يتم تحميل بيانات الوسائط أثناء تشغيل السكربت
onloadedmetadataHTML5scriptعندما يتم تحميل دuration لعدد العناصر الوسائطية بالإضافة إلى بيانات الوسائط الأخرى أثناء تشغيل السكربت
onloadstartHTML5scriptعندما يتم بدء تحميل بيانات الوسائط أثناء تشغيل السكربت
onpauseHTML5scriptعندما يتم إيقاف تشغيل بيانات الوسائط أثناء تشغيل السكربت
onplayHTML5scriptعندما يتم بدء تشغيل بيانات الوسائط أثناء تشغيل السكربت
onplayingHTML5scriptعندما يتم تشغيل بيانات الوسائط أثناء تشغيل السكربت
onprogressHTML5scriptعندما يتم تشغيل السكربت أثناء سحب بيانات الوسائط من قبل المتصفح
onratechangeHTML5scriptعند تغيير سرعة بيانات التشغيل المتوسط يتم تنفيذ السكربت
onreadystatechangeHTML5scriptعند تغيير حالة الاستعداد (ready-state) يتم تنفيذ السكربت
onseekedHTML5scriptعندما يصبح خاصية التركيز لعنصر التشغيل المتوسط غير صحيحة وأن التركيز قد انتهى يتم تنفيذ السكربت
onseekingHTML5scriptعندما تكون خاصية التركيز لعنصر التشغيل المتوسط صحيحة وأن التركيز قد بدأ يتم تنفيذ السكربت
onstalledHTML5scriptعند وجود خطأ في عملية استعادة بيانات التشغيل المتوسط (إرجاء) يتم تنفيذ السكربت
onsuspendHTML5scriptعند وجود بيانات التشغيل المتوسط في الاستعادة ولكن قبل استعادة ملف التشغيل كاملًا يتم تنفيذ السكربت
ontimeupdateHTML5scriptعند تغيير موقع التشغيل المتوسط يتم تنفيذ السكربت
onvolumechangeHTML5scriptعند تغيير حجم التشغيل المتوسط أو عند تعيين الصوت إلى الصمت يتم تنفيذ السكربت
onwaitingHTML5scriptعند توقف التشغيل المتوسط ولكن هناك نية لمتابعة التشغيل يتم تنفيذ السكربت

أحداث أخرى

صفةقيمةوصف
onshowHTML5scriptعند عرض عنصر <menu> في سياقه يتم تنفيذ السكربت
ontoggleHTML5scriptعند فتح أو إغلاق عنصر <details> يتم تنفيذ السكربت