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(انظر الجدول في الخطوة الثّانيّة [step 2]). تذكّر أنّ مُعظم كائنات الأحداث تملكُ دوال بانيّةً الآن، والتي تُعدّ الطريقة المنصوح بها لإنشاء نُسخ من كائنات الأحداث الآن.

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

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