تتمتع HTML بالقدرة على جعل الأحداث تُنشئ إجراءات في المتصفح، مثل تشغيل JavaScript عند نقر المستخدم على أحد العناصر.
لمزيد من المعلومات حول برمجة الأحداث، يرجى زيارة دليل JavaScript الخاص بنا.
فيما يلي السمات العالمية للأحداث التي يمكن إضافتها إلى عناصر HTML لتحديد إجراءات الأحداث.
سمات أحداث النافذة
الأحداث التي يتم تشغيلها للنافذة (تنطبق على علامة <body>):
| السمة | القيمة | الوصف |
|---|---|---|
| onafterprint | نص برمجي | نص برمجي يتم تشغيله بعد طباعة المستند |
| onbeforeprint | نص برمجي | نص برمجي يتم تشغيله قبل طباعة المستند |
| onbeforeunload | نص برمجي | نص برمجي يتم تشغيله عندما يكون المستند على وشك تفريغه |
| onerror | نص برمجي | نص برمجي يتم تشغيله عند حدوث خطأ |
| onhashchange | نص برمجي | نص برمجي يتم تشغيله عند حدوث تغييرات في جزء الربط من عنوان URL |
| onload | نص برمجي | يتم تشغيله بعد انتهاء تحميل الصفحة |
| onmessage | نص برمجي | نص برمجي يتم تشغيله عند تشغيل الرسالة |
| onoffline | نص برمجي | نص برمجي يتم تشغيله عندما يبدأ المتصفح في العمل دون اتصال |
| ononline | نص برمجي | نص برمجي يتم تشغيله عندما يبدأ المتصفح في العمل عبر الإنترنت |
| onpagehide | نص برمجي | نص برمجي يتم تشغيله عندما ينتقل المستخدم بعيدًا عن الصفحة |
| onpageshow | نص برمجي | نص برمجي يتم تشغيله عندما ينتقل المستخدم إلى صفحة |
| onpopstate | نص برمجي | نص برمجي يتم تشغيله عند تغيير محفوظات النافذة |
| onresize | نص برمجي | يتم تشغيله عند تغيير حجم نافذة المتصفح |
| onstorage | نص برمجي | نص برمجي يتم تشغيله عند تحديث منطقة تخزين الويب |
| onunload | نص برمجي | يتم تشغيله بمجرد تفريغ الصفحة (أو إغلاق نافذة المتصفح) |
سمات أحداث النموذج
الأحداث التي يتم تشغيلها بواسطة الإجراءات داخل نموذج HTML (تنطبق على جميع عناصر HTML تقريبًا ، ولكنها تستخدم غالبًا في عناصر النموذج):
| السمة | القيمة | الوصف |
|---|---|---|
| onblur | نص برمجي | يتم تشغيله في اللحظة التي يفقد فيها العنصر التركيز |
| onchange | نص برمجي | يتم تشغيله في اللحظة التي يتم فيها تغيير قيمة العنصر |
| oncontextmenu | نص برمجي | نص برمجي يتم تشغيله عند تشغيل قائمة السياق |
| onfocus | نص برمجي | يتم تشغيله في اللحظة التي يحصل فيها العنصر على التركيز |
| oninput | نص برمجي | نص برمجي يتم تشغيله عندما يحصل عنصر على إدخال من المستخدم |
| oninvalid | نص برمجي | نص برمجي يتم تشغيله عندما يكون العنصر غير صالح |
| onreset | نص برمجي | يتم تشغيله عند النقر فوق زر إعادة الضبط في نموذج |
| onsearch | نص برمجي | يتم تشغيله عندما يكتب المستخدم شيئًا في حقل البحث (لـ <input=”search”>) |
| onselect | نص برمجي | يتم تشغيله بعد تحديد بعض النص في عنصر |
| onsubmit | نص برمجي | يتم تشغيله عند إرسال نموذج |
سمات أحداث لوحة المفاتيح
| السمة | القيمة | الوصف |
|---|---|---|
| onkeydown | نص برمجي | يتم تشغيله عندما يقوم المستخدم بالضغط على مفتاح |
| onkeypress | نص برمجي | يتم تشغيله عندما يقوم المستخدم بضغط على مفتاح (لكن تم إهماله في معظم المتصفحات الحديثة) |
| onkeyup | نص برمجي | يتم تشغيله عندما يقوم المستخدم بتحرير مفتاح |
سمات أحداث الماوس
| السمة | القيمة | الوصف |
|---|---|---|
| onclick | نص برمجي | يتم تشغيله عند النقر بالماوس على العنصر |
| ondblclick | نص برمجي | يتم تشغيله عند النقر المزدوج بالماوس على العنصر |
| onmousedown | نص برمجي | يتم تشغيله عند الضغط على زر الماوس على عنصر |
| onmousemove | نص برمجي | يتم تشغيله عندما يتحرك مؤشر الماوس أثناء وجوده فوق عنصر |
| onmouseout | نص برمجي | يتم تشغيله عندما يتحرك مؤشر الماوس خارج عنصر |
| onmouseover | نص برمجي | يتم تشغيله عندما يتحرك مؤشر الماوس فوق عنصر |
| onmouseup | نص برمجي | يتم تشغيله عند تحرير زر الماوس فوق عنصر |
| onmousewheel | نص برمجي | تم إهماله. استخدم سمة onwheel بدلاً منه |
| onwheel | نص برمجي | يتم تشغيله عندما يتم تدوير عجلة الماوس لأعلى أو لأسفل فوق عنصر |
سمات أحداث السحب والإفلات
| السمة | القيمة | الوصف |
|---|---|---|
| ondrag | نص برمجي | يتم تشغيله عند سحب عنصر |
| ondragend | نص برمجي | يتم تشغيله في نهاية عملية السحب |
| ondragenter | نص برمجي | يتم تشغيله عند سحب عنصر إلى هدف إسقاط صالح |
| ondragleave | نص برمجي | يتم تشغيله عندما يترك عنصر هدف إسقاط صالح |
| ondragover | نص برمجي | يتم تشغيله عندما يتم سحب عنصر فوق هدف إسقاط صالح |
| ondragstart | نص برمجي | يتم تشغيله في بداية عملية السحب |
| ondrop | نص برمجي | يتم تشغيله عند إسقاط العنصر الذي تم سحبه |
| onscroll | نص برمجي | يتم تشغيله عند تمرير شريط التمرير الخاص بالعنصر |
أحداث الحافظة
| السمة | القيمة | الوصف |
|---|---|---|
| oncopy | نص برمجي | يتم تشغيله عندما يقوم المستخدم بنسخ محتوى عنصر |
| oncut | نص برمجي | يتم تشغيله عندما يقوم المستخدم بقص محتوى عنصر |
| onpaste | نص برمجي | يتم تشغيله عندما يقوم المستخدم بلصق بعض المحتوى في عنصر |
أحداث الوسائط المتعددة
يتم تشغيل هذه الأحداث بواسطة عناصر الوسائط المتعددة مثل مقاطع الفيديو والصور والصوت (تنطبق على جميع عناصر HTML، ولكنها أكثر شيوعًا في عناصر الوسائط المتعددة، مثل <audio> و <embed> و <img> و <object> و <video>) .
| السمة | القيمة | الوصف |
|---|---|---|
| onabort | نص برمجي | يتم تشغيله عند إيقاف تشغيل الوسائط المتعددة بشكل مفاجئ |
| oncanplay | نص برمجي | يتم تشغيله عندما تصبح الوسائط المتعددة جاهزة للبدء في التشغيل (عند تخزين بيانات كافية) |
| oncanplaythrough | نص برمجي | يتم تشغيله عندما يمكن تشغيل الوسائط المتعددة بالكامل حتى النهاية دون توقف |
| oncuechange | نص برمجي | يتم تشغيله عندما تتغير الإشارات في عنصر <track> |
| ondurationchange | نص برمجي | يتم تشغيله عندما يتغير طول الوسائط المتعددة |
| onemptied | نص برمجي | يتم تشغيله عند حدوث مشكلة مفاجئة وعدم توفر الملف (مثل انقطاع الاتصال بشكل غير متوقع) |
| onended | نص برمجي | يتم تشغيله عند وصول الوسائط المتعددة إلى نهايتها |
| onerror | نص برمجي | يتم تشغيله عند حدوث خطأ أثناء تحميل الملف |
| onloadeddata | نص برمجي | يتم تشغيله عند تحميل بيانات الوسائط المتعددة |
| onloadedmetadata | نص برمجي | يتم تشغيله عند تحميل معلومات الوسائط المتعددة (مثل الحجم والمدة) |
| onloadstart | نص برمجي | يتم تشغيله بمجرد بدء تحميل الملف قبل تحميل أي شيء فعليًا |
| onpause | نص برمجي | يتم تشغيله عند إيقاف تشغيل الوسائط المتعددة مؤقتًا إما بواسطة المستخدم أو برمجيًا |
| onplay | نص برمجي | يتم تشغيله عندما تصبح الوسائط المتعددة جاهزة لبدء التشغيل |
| onplaying | نص برمجي | يتم تشغيله عند بدء تشغيل الوسائط المتعددة بالفعل |
| onprogress | نص برمجي | يتم تشغيله عندما يكون المتصفح في طور الحصول على بيانات الوسائط |
| onratechange | نص برمجي | يتم تشغيله في كل مرة يتغير فيها معدل التشغيل (مثل عندما يقوم المستخدم بالتبديل إلى وضع الحركة البطيئة أو التقديم السريع) |
| onseeked | نص برمجي | يتم تشغيله عند تعيين السمة seeking إلى false، مما يشير إلى انتهاء البحث |
| onseeking | نص برمجي | يتم تشغيله عند تعيين السمة seeking إلى true، مما يشير إلى أن البحث نشط |
| onstalled | نص برمجي | يتم تشغيله عندما يتعذر على المتصفح جلب بيانات الوسائط لأي سبب |
| onsuspend | نص برمجي | يتم تشغيله عند إيقاف جلب بيانات الوسائط قبل تحميلها بالكامل لأي سبب |
| ontimeupdate | نص برمجي | يتم تشغيله عند تغيير موضع التشغيل (مثل عندما يقوم المستخدم بالتقديم السريع إلى نقطة مختلفة في الوسائط) |
| onvolumechange | نص برمجي | يتم تشغيله في كل مرة يتم فيها تغيير مستوى الصوت (بما في ذلك ضبط الصوت على “كتم الصوت”) |
| onwaiting | نص برمجي | يتم تشغيله عند إيقاف الوسائط المتعددة مؤقتًا ولكن من المتوقع استئنافها (مثل عندما تتوقف الوسائط المتعددة مؤقتًا لتخزين المزيد من البيانات) |
أحداث متنوعة
فيما يلي بعض الأحداث الإضافية التي لا تتناسب بالضرورة مع الفئات السابقة:
- ontoggle: يتم تشغيل هذا الحدث عندما يقوم المستخدم بفتح أو إغلاق عنصر <details>. يُستخدم هذا العنصر لإنشاء أقسام قابلة للتوسيع أو طيها على الصفحة، مثل مربعات الأسئلة الشائعة أو أجزاء المحتوى المخفية.
ملحوظة: هناك بعض الأحداث الأخرى التي لم يتم ذكرها هنا، ويمكنك العثور على قائمة كاملة بها في وثائق مرجعية للمتصفحات مثل MDN Web Docs.
