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

طريقة addEventListener() في HTML DOM

مثلث HTML DOM Document

document.addEventListener()يتم ربط معالج الحدث إلى المستند.

استخدامdocument.removeEventListener()يتم حذف البرنامج النصي لمعالجة الحدث الذي تم ربطه مع طريقة addEventListener().

استخدامالشخص .addEventListener()يضيف معالج الحدث إلى العنصر المحدد.

النحو:

document.addEventListener(event, listener, useCapture)
document.addEventListener("click", function() {
alert("Hello World!!!");
});
اختبار النظر في‹/›

متوافق مع المتصفح

الرقم في الجدول يشير إلى إصدار المتصفح الذي يدعم طريقة addEventListener() بشكل كامل:

الطريقة
addEventListener()1171.09

قيمة المعامل

المعاملوصف
eventمطلوب) يمكن أن يكون حدثًا صالحًا جدًا في JavaScript. عند استخدام الحدث، لا تستخدم بادئة "on"، مثل استخدام "click" بدلاً من "onclick"، "mousedown" بدلاً من "onmousedown".
للحصول على قائمة كاملة بجميع أحداث HTML DOM، يرجى الرجوع إلىمرجع HTML DOM لحدث.
listenerمطلوب) يمكن أن يكون دالة JavaScript تتفاعل مع حدث.
عندما يحدث الحدث، يتم نقل كائن الحدث كمعامل أولي إلى الدالة. نوع كائن الحدث يعتمد على الحدث المحدد. على سبيل المثال، يتبع حدث النقر كائن MouseEvent.
useCaptureبإمكانها أن تكون قيمة بولية، تحدد ما إذا كان يجب تنفيذ الأحداث في مرحلة الاستقبال أو التدفق. القيمة الافتراضية هي false.
القيم الممكنة:
  • true-يتم تنفيذ معالج الأحداث في مرحلة الاستقبال

  • false-يتم تنفيذ معالج الأحداث في مرحلة التدفق

يمكنك فيدليل تعليمات JavaScript حول نشر الأحداثاقرأ المزيد عن نشر الأحداث

تفاصيل تقنية

القيمة العائدة:لا يوجد
إصدار DOM:مستوى DOM 2

مزيد من الأمثلة

أضف واقعة النقر إلى المستند. عند نقر المستخدم إلى أي مكان في المستند، استخدم عنصر <p> باستخدام id="para" لإظهار "Hello World":

document.addEventListener("click", function() {
document.querySelector("#para").innerHTML = "Hello World!!!";
});
اختبار النظر في‹/›

في هذا المثال، يتم استدعاء دالة "المسمى" الخارجية:

document.addEventListener("click", myFunc);
function myFunc() {
   document.body.style.backgroundColor = "coral";
}
اختبار النظر في‹/›

يمكنك إضافة العديد من الأحداث إلى المستند دون تغطية الأحداث الحالية:

document.addEventListener("click", myFunc);
document.addEventListener("click", anotherFunc);
اختبار النظر في‹/›

يمكنك إضافة أنواع مختلفة من الأحداث إلى المستند:

document.addEventListener("mouseenter", myFunc1);
document.addEventListener("click", myFunc2);
document.addEventListener("mouseout", myFunc3);
اختبار النظر في‹/›

عند تقديم قيم المعلمات، استخدم دالة مجهولة الاسم، حيث تستدعي الدالة المحددة المعلمة

document.addEventListener("click", function() {
myFunc(x, y);
});
اختبار النظر في‹/›

يمكنك أيضًا النظر في

تعليمية JavaScript:مستمع الأحداث

تعليمية JavaScript:انتشار الأحداث

مرجع HTML DOMdocument.removeEventListener()

مرجع HTML DOMالشخص .addEventListener()

مثلث HTML DOM Document