طريقة dispatchEvent() في DOM XML
التعريف والاستخدام
طريقة dispatchEvent() لتوزيع حدث مدمج على العنصر.
النص النحوي:
dispatchEvent(evt)
| المتغيرات | وصف |
|---|---|
| evt | مطلوب. موضوع Event الذي سيتم توزيعه. |
الإرجاع
إذا تم استدعاء evt من طريقة preventDefault()، فإنه سيتم إرجاع false، وإلا سيتم إرجاع true.
يتم إطلاقه
إذا كان موضوع Event evt لم يتم تعيينه، أو إذا كان خاصية type الخاص به null أو فارغ، فإن الطريقة ستقوم بإطلاق استثناء.
وصف
سيقوم هذا الطريقة بتوزيع حدث مدمج، وهو Document.createEvent() إنشاء، يتم تعريفها من قبل طريقة التوليد أو أحد فروعه.
النداء إلى هذه الطريقة سيجعل العنصر الذي تم استدعاؤه يصبح العنصر المستهدف للحدث، والحدث سيتم تمريره لأول مرة خلال شجرة الوثيقة في مرحلة الاستقبال. إذا كان خاصية bubbles للحادث صحيحة، فإنه سيتم تمرير الحادث عبر شجرة الوثيقة إلى أعلى بعد معالجته في العنصر المستهدف.
