دليل مرجعي لحدث HTML

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

يستطيع HTML إطلاق الأحداث التي تُطلق الأفعال في المتصفح، مثل بدء JavaScript عند النقر على عنصر.

للحصول على معلومات إضافية حول أحداث البرمجة، يرجى زيارة دليل JavaScript.

هذه هي خصائص الأحداث العالمية التي يمكن إضافتها إلى عناصر HTML لتعريف عمليات الأحداث.

خصائص أحداث Window

الأحداث التي تُطلق على عنصر window (يُطبق على علامة <body>):

خصائص قيمة وصف
onafterprint script السكربت الذي يتم تشغيله بعد طباعة المستند.
onbeforeprint script السكربت الذي يتم تشغيله قبل طباعة المستند.
onbeforeunload script السكربت الذي يتم تشغيله قبل تفريغ المستند.
onerror script السكربت الذي يتم تشغيله عند حدوث خطأ.
onhaschange script السكربت الذي يتم تشغيله عند تغيير المستند.
onload script يُطلق بعد إكمال تحميل الصفحة.
onmessage script السكربت الذي يتم تشغيله عند إطلاق الرسالة.
onoffline script السكربت الذي يتم تشغيله عند انقطاع الاتصال بالمستند.
ononline script السكربت الذي يتم تشغيله عند إطلاق المستند.
onpagehide script السكربت الذي يتم تشغيله عند إخفاء النافذة.
onpageshow script السكربت الذي يتم تشغيله عند تصبح النافذة مرئية.
onpopstate script السكربت الذي يتم تشغيله عند تغيير سجل النافذة.
onredo script السكربت الذي يتم تشغيله عند تنفيذ التقدم في المستند.
onresize script يُطلق عند تغيير حجم نافذة المتصفح.
onstorage script السكربت الذي يتم تشغيله عند تحديث منطقة التخزين على الويب.
onundo script السكربت الذي يتم تشغيله عند تنفيذ التراجع في المستند.
onunload script يُطلق عند تحميل الصفحة أو إغلاق نافذة المتصفح.

أحداث النموذج

بالتأكيد، الحدث الذي يُطلق عند إجراء العملية عبر نموذج HTML (يُطبق على معظم عناصر HTML، ولكن يستخدم غالبًا في عناصر النموذج):

خصائص قيمة وصف
onblur script المسلسل البرمجي الذي يتم تشغيله عند فقدان العنصر التركيز.
onchange script المسلسل البرمجي الذي يتم تشغيله عند تغيير قيمة العنصر.
oncontextmenu script المسلسل البرمجي الذي يتم تشغيله عند إطلاق قائمة السياق.
onfocus script المسلسل البرمجي الذي يتم تشغيله عند الحصول على التركيز في العنصر.
onformchange script المسلسل البرمجي الذي يتم تشغيله عند تغيير النموذج.
onforminput script المسلسل البرمجي الذي يتم تشغيله عند الحصول على إدخال المستخدم في النموذج.
oninput script المسلسل البرمجي الذي يتم تشغيله عند الحصول على إدخال المستخدم في العنصر.
oninvalid script المسلسل البرمجي الذي يتم تشغيله عند عدم صحة العنصر.
onreset script تُطلق عند ضرب زر إعادة تعيين في النموذج. غير مدعوم في HTML5.
onselect script تُطلق عند اختيار النص في العنصر.
onsubmit script تُطلق عند تقديم النموذج.

أحداث لوحة المفاتيح

خصائص قيمة وصف
onkeydown script تُطلق عند ضغط الزر.
onkeypress script تُطلق عند ضرب الزر.
onkeyup script تُطلق عند إطلاق الضغط على الزر.

أحداث الفأرة

تُطلق الأحداث بفضل الحركات مثل فأرة المستخدم:

خصائص قيمة وصف
onclick script تُطلق عند ضرب الفأرة مرة واحدة على العنصر.
ondblclick script تُطلق عند ضرب الفأرة مزدوجًا على العنصر.
ondrag script المسلسل البرمجي الذي يتم تشغيله عند سحب العنصر.
ondragend script المسلسل البرمجي الذي يتم تشغيله عند انتهاء عملية السحب.
ondragenter script المسلسل البرمجي الذي يتم تشغيله عند وصول العنصر إلى منطقة التسليم.
ondragleave script المسلسل البرمجي الذي يتم تشغيله عند مغادرة العنصر لهدف التسليم.
ondragover script المسلسل البرمجي الذي يتم تشغيله عند سحب العنصر على هدف التسليم.
ondragstart script المسلسل البرمجي الذي يتم تشغيله عند بدء عملية السحب.
ondrop script المسلسل البرمجي الذي يتم تشغيله عند سحب العنصر.
onmousedown script تُطلق عند ضغط زر الفأرة على العنصر.
onmousemove script تُطلق عند وضع مؤشر الفأرة على العنصر.
onmouseout script تُطلق عند خروج مؤشر الفأرة من العنصر.
onmouseover script تُطلق عند وضع مؤشر الفأرة على العنصر.
onmouseup script تُطلق عند إطلاق زر الفأرة على العنصر.
onmousewheel script المسلسل البرمجي الذي يتم تشغيله عند تمرير عجلة الفأرة.
onscroll script المسلسل البرمجي الذي يتم تشغيله عند تمرير شريط التمرير للعناصر.

أحداث الوسائط

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

خصائص قيمة وصف
onabort script عند الخروج يتم تشغيل سكريبت.
oncanplay script عندما تكون الوسيلة جاهزة للبدء في اللعب يتم تشغيل سكريبت (عندما يكون التحميل كافياً للبدء).
oncanplaythrough script عندما يمكن لوسيلة الإعلام اللعب حتى النهاية دون التوقف بسبب التحميل يتم تشغيل سكريبت.
ondurationchange script عندما يتغير طول وسيلة الإعلام يتم تشغيل سكريبت.
onemptied script عند حدوث خطأ وعدم توفر الملف بشكل فجائي (مثل قطع الاتصال بشكل غير متوقع).
onended script عندما تصل وسيلة الإعلام إلى النهاية يتم تشغيل سكريبت (يمكن إرسال رسائل مثل "شكراً على المشاهدة").
onerror script عند حدوث خطأ أثناء تحميل الملف يتم تشغيل سكريبت.
onloadeddata script عندما يتم تحميل بيانات وسيلة الإعلام يتم تشغيل سكريبت.
onloadedmetadata script عندما يتم تحميل بيانات التحويل (مثل دقة الفيديو والمدة) يتم تشغيل سكريبت.
onloadstart script عند بدء تحميل الملف دون تحميل أي بيانات فعليه يتم تشغيل سكريبت.
onpause script عندما يتم إيقاف وسيلة الإعلام بواسطة المستخدم أو البرنامج يتم تشغيل سكريبت.
onplay script عندما تكون وسيلة الإعلام جاهزة للبدء في اللعب يتم تشغيل سكريبت.
onplaying script عندما تبدأ وسيلة الإعلام في اللعب يتم تشغيل سكريبت.
onprogress script عندما يحاول المتصفح الحصول على بيانات وسيلة الإعلام يتم تشغيل سكريبت.
onratechange script عندما يتغير معدل التسجيل يتم تشغيل سكريبت (مثل عند تحويل المستخدم إلى وضع التسجيل البطيء أو التسجيل السريع).
onreadystatechange script عندما يتغير حالة الجاهزية يتم تشغيل سكريبت (مراقبة حالة بيانات وسيلة الإعلام).
onseeked script عندما يتم تعيين خاصية seeking إلى false (لتعيين أن التحديد قد انتهى) يتم تشغيل سكريبت.
onseeking script عندما يتم تعيين خاصية seeking إلى true (لتعيين أن التحديد هو نشط) يتم تشغيل سكريبت.
onstalled script عندما لم يتمكن المتصفح من استعادة بيانات وسيلة الإعلام بسبب أي سبب يتم تشغيل سكريبت.
onsuspend script عندما توقف استعادة بيانات وسيلة الإعلام بسبب أي سبب قبل تحميلها بالكامل يتم تشغيل سكريبت.
ontimeupdate script عندما يتغير موقف اللعب (مثل عند تسريع المستخدم إلى موقف مختلف في وسيلة الإعلام) يتم تشغيل سكريبت.
onvolumechange script عندما يغير المستخدم مستوى الصوت (بما في ذلك تعيين الصوت إلى الصمت) يتم تشغيل سكريبت.
onwaiting script عندما تتوقف وسيلة الإعلام عن اللعب ولكنها ترغب في الاستمرار في اللعب (مثل عند إيقاف وسيلة الإعلام بعد تحميل بيانات إضافية)