JavaScript/Document/createEvent

مُلاحظة: لقد أُهمِلت الكثير من التوابع التي تُستعمل مع التّابع createEvent، هذه التّوابع تشمل التّابع initCustomEvent وتوابع أخرى. استعمل دوال بناء الأحداث عوضًا عنها.

يُنشئُ التّابع Document.createEvent()‎ حدثًا من النّوع المُحدّد. يجب تهيئة الكائن المُعاد قبل أن يُمكنَ تمريره إلى التّابع dispatchEvent.

البنية العامة

var event = document.createEvent(type);

event

الكائن الجديد من النّوع Event.

type

سلسلةٌ نصيّةٌ تُمثّل نوع الحدث المرغوب إنشاؤه. القيم المُمكنة تشمل "UIEvents" و"MouseEvents" و"MutationEvents" و"HTMLEvents". انظر قسم المُلاحظات أسفله للمزيد من التّفاصيل.

أمثلة

// أنشئ الحدث
var event = document.createEvent('Event');

// عرّف أنّ اسم الحدث هو
// 'build'.
event.initEvent('build', true, true);

// أنصِت للحدث
elem.addEventListener('build', function (e) {
  // e.target
  // تُوافِق
  // elem
}, false);

// يُمكن للهدف أن يكون أي كائنٍ من النّوع
// Element 
// أو أي كائنٍ آخر من النّوع
// EventTarget
elem.dispatchEvent(event);

ملاحظات

السلاسِل النّصيّة الممكن تمريرها كأنواع أحداث إلى التّابع Document.createEvent()‎ موجودةٌ في معيار DOM(الجدول في الخطوة الثّانيّة). تذكّر أنّ مُعظم كائنات الأحداث تملكُ دوال بانيّةً الآن، والتي تُعدّ الطريقة المنصوح بها لإنشاء نُسخ من كائنات الأحداث الآن.

انظر أيضًا

• إنشاء وإحداثُ الأحداث

مصادر ومواصفات

• مواصفة DOM Level 2 Events: createEvent
• مواصفة DOM Level 3 Events: createEvent