الفرق بين المراجعتين لصفحة: «JavaScript/Document/createEvent»
< JavaScript | Document
إضافة الصّفحة |
لا ملخص تعديل |
||
| (مراجعتان متوسطتان بواسطة مستخدم واحد آخر غير معروضتين) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>Document.createEvent()</code>}}</noinclude> | <noinclude>{{DISPLAYTITLE:<code>Document.createEvent()</code>}}</noinclude> | ||
'''مُلاحظة:''' لقد أُهمِلت الكثير من التوابع التي تُستعمل مع | '''مُلاحظة:''' لقد أُهمِلت الكثير من التوابع التي تُستعمل مع التّابع <code>createEvent</code>، هذه التّوابع تشمل التّابع <code>initCustomEvent</code> وتوابع أخرى. استعمل [[JavaScript/CustomEvent|دوال بناء الأحداث]] عوضًا عنها. | ||
يُنشئُ التّابع <code>Document.createEvent()</code> | يُنشئُ التّابع <code>Document.createEvent()</code> [[JavaScript/Event|حدثًا]] من النّوع المُحدّد. يجب تهيئة الكائن المُعاد قبل أن يُمكنَ تمريره إلى التّابع <code>[[JavaScript/EventTarget/dispatchEvent|dispatchEvent]]</code>. | ||
==البنية العامة== | ==البنية العامة== | ||
| سطر 13: | سطر 13: | ||
=== <code>type</code> === | === <code>type</code> === | ||
سلسلةٌ نصيّةٌ تُمثّل نوع الحدث المرغوب إنشاؤه. القيم المُمكنة تشمل "UIEvents" و"MouseEvents" و"MutationEvents" و"HTMLEvents". انظر قسم المُلاحظات | سلسلةٌ نصيّةٌ تُمثّل نوع الحدث المرغوب إنشاؤه. القيم المُمكنة تشمل <code>"UIEvents"</code> و<code>"MouseEvents"</code> و<code>"MutationEvents"</code> و<code>"HTMLEvents"</code>. انظر [[JavaScript/Document/createEvent#.D9.85.D9.84.D8.A7.D8.AD.D8.B8.D8.A7.D8.AA|قسم المُلاحظات]] أدناه للمزيد من التّفاصيل. | ||
==أمثلة== | ==أمثلة== | ||
| سطر 39: | سطر 39: | ||
==ملاحظات== | ==ملاحظات== | ||
السلاسِل النّصيّة الممكن تمريرها كأنواع أحداث إلى التّابع <code>Document.createEvent()</code> موجودةٌ في [https://dom.spec.whatwg.org/#dom-document-createevent معيار DOM](انظر الجدول في الخطوة الثّانيّة [step 2]). تذكّر أنّ مُعظم كائنات الأحداث تملكُ دوال بانيّةً الآن، والتي تُعدّ الطريقة المنصوح بها لإنشاء نُسخ من كائنات الأحداث الآن. | |||
==مصادر ومواصفات== | ==مصادر ومواصفات== | ||
* مواصفة [http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-DocumentEvent-createEvent DOM Level 2 Events: createEvent] | * مواصفة [http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-DocumentEvent-createEvent DOM Level 2 Events: createEvent]. | ||
* مواصفة [http://www.w3.org/TR/DOM-Level-3-Events/#events-Events-DocumentEvent-createEvent DOM Level 3 Events: createEvent] | * مواصفة [http://www.w3.org/TR/DOM-Level-3-Events/#events-Events-DocumentEvent-createEvent DOM Level 3 Events: createEvent]. | ||
[[تصنيف:JavaScript]] | [[تصنيف:JavaScript]] | ||
المراجعة الحالية بتاريخ 15:39، 25 مارس 2018
مُلاحظة: لقد أُهمِلت الكثير من التوابع التي تُستعمل مع التّابع 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.