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