طريقة createEvent() في XML DOM
التعريف والاستخدام
يؤسس طريقة createEvent() جديدة عنصر Event.
النحو:
createEvent(eventType)
| المتغيرات | الوصف |
|---|---|
| eventType | للحصول على اسم الوحدة الخاصة بالمؤشر على Event. عن قائمة الأنواع الفعالة للأحداث، يرجى الرجوع إلى“شرح”部分。 |
القيمة المعدة
يعود الجديد عنصر Event، مع تحديد النوع المحدد.
طرح
إذا كان التطبيق يدعم نوع الحدث المطلوب، سيقوم الطريقة بطرح استثناء من نوع NOT_SUPPORTED_ERR استثناء DOMException.
شرح
سيقوم هذا الطريقة بإنشاء نوع جديد من الحدث، يتم تحديده بالمعامل eventType تحديد. يرجى ملاحظة أن قيمة هذا المعامل ليست اسم واجهة الحدث التي سيتم إنشاؤها، بل هو اسم وحدة DOM التي تعريف تلك الواجهة.
في الجدول أدناه تمت eventType القيم المقبولة لكل قيمة وتحديد واجهة الحدث التي يتم إنشاؤها:
| المتغيرات | واجهات الحدث | طرق التعريف |
|---|---|---|
| HTMLEvents | HTMLEvent | iniEvent() |
| MouseEvents | MouseEvent | iniMouseEvent() |
| UIEvents | UIEvent | iniUIEvent() |
بعد إنشاء Event باستخدام هذه الطريقة، يجب استخدام الطريقة المبينة في الجدول أعلاه لتعريف العنصر. لمزيد من التفاصيل حول طرق التعريف، يرجى الرجوع إلى مرجع Event.
في الواقع، هذه الطريقة ليست معرفة من واجهة Document، بل من واجهة DocumentEvent. إذا كان التطبيق يدعم وحدة Event، مثال Documentسيتم تنفيذ واجهة DocumentEvent وسيتعين دعم هذا الطريقة.
