موضوع Event XML DOM
- صفحه قبلی DOM Element
- صفحه بعدی DOM HTMLCollection
شیء رویداد اطلاعات مربوط به رویداد را نشان می‌دهد.
شیء رویداد
ویژگی‌های شیء رویداد جزئیات مربوط به رویداد را فراهم می‌کنند (مثلاً عناصری که رویداد در آن رخ می‌دهد). روش‌های شیء رویداد می‌توانند گسترش رویداد را کنترل کنند.
استاندارد رویدادهای DOM 2 سطح یک مدل رویداد استاندارد را تعریف کرده است که توسط همه مرورگرهای مدرن به جز IE پیاده‌سازی شده است، در حالی که IE مدل خود را تعریف کرده است که با آن ناسازگار است. این صفحه مراجعه‌ای را از ویژگی‌های شیء رویداد استاندارد و شیء رویداد IE ارائه می‌دهد.
توجه:در مدل رویداد استاندارد، شیء رویداد به دستورالعمل‌های رویداد داده می‌شود؛ اما در مدل رویداد IE، آن در ویژگی event موجود در شیء Window ذخیره می‌شود.
در مدل رویداد استاندارد، زیررابط‌های مختلف Event ویژگی‌های اضافی را تعریف می‌کنند که جزئیات مرتبط با نوع خاص رویداد را فراهم می‌کنند. در مدل رویداد IE، تنها یک نوع شیء رویداد وجود دارد که برای همه نوع رویدادها استفاده می‌شود.
ویژگی‌های استاندارد رویداد
در اینجا ویژگی‌های تعریف شده در استاندارد رویدادهای DOM 2 سطح نشان داده شده است.
| ویژگی | توضیح | IE | F | O | W3C |
|---|---|---|---|---|---|
| bubbles | برای نشان‌دهی به این که رویداد از نوع حباب‌ها است یا خیر، یک مقدار بولینگ برمی‌گرداند. | نه | 1 | 9 | بله |
| cancelable | برای نشان‌دهی به این که رویداد قابل لغو عملکرد پیش‌فرض است یا خیر، یک مقدار بولینگ برمی‌گرداند. | نه | 1 | 9 | بله |
| currentTarget | عنصر ایجادکننده رویداد (عنصر فعلی) را برمی‌گرداند. | نه | 1 | 9 | بله |
| eventPhase | مرحله فعلی گسترش رویداد را برمی‌گرداند. | بله | |||
| target | عنصر ایجادکننده رویداد (نقطه هدف رویداد) را برمی‌گرداند. | نه | 1 | 9 | بله |
| timeStamp | تاریخ و زمان ایجاد رویداد را برمی‌گرداند. | نه | 1 | 9 | بله |
| type | نام رویدادی که توسط شیء رویداد فعلی نشان داده می‌شود را برمی‌گرداند. | 6 | 1 | 9 | بله |
روش‌های استاندارد رویداد
در اینجا روش‌های تعریف شده در استاندارد رویدادهای DOM 2 سطح نشان داده شده است. مدل رویداد IE از این روش‌ها پشتیبانی نمی‌کند:
| روش | توضیح | IE | F | O | W3C |
|---|---|---|---|---|---|
| initEvent() | ویژگی‌های شیء رویداد جدید ایجاد شده را تنظیم می‌کند. | نه | 1 | 9 | بله |
| preventDefault() | به مرورگر اطلاع دهید که از عملکرد پیش‌فرض مرتبط با رویداد خودداری کند. | نه | 1 | 9 | بله |
| stopPropagation() | رویدادهای پایان‌یافته در فرآیند گسترش، پردازش هدف یا مرحله حباب‌های بیشتر گسترش نمی‌یابند. پس از فراخوانی این روش، برنامه‌های مدیریت رویداد مربوط به این گره فراخوانی خواهند شد و رویداد دیگر به گره‌های دیگر ارسال نمی‌شود. | نه | 1 | 9 | بله |
ویژگی‌های IE
IE از مدل رویداد استاندارد DOM ( حداقل در IE 7) پشتیبانی نمی‌کند و شیء رویداد IE یک مجموعه کاملاً متفاوت از ویژگی‌ها را تعریف می‌کند.
مدل رویداد IE هیچ سلسله مراتتی برای رویدادهای مختلف تعریف نکرده است، بنابراین تمام ویژگی‌های مرتبط با نوع هر رویدادی در اینجا لیست شده‌اند.
| ویژگی | توضیح |
|---|---|
| cancelBubble | اگر رویداد سمت راست می‌خواهد از ادامه جریان رویداد جلوگیری کند، باید این ویژگی به true تنظیم شود. |
| fromElement | برای رویدادهای mouseover و mouseout، fromElement به عنصری که ماوس از آن خارج می‌شود اشاره دارد. |
| keyCode |
برای رویدادهای keypress، این ویژگی کد Unicode کلیدی فشرده شده را مشخص می‌کند. برای رویدادهای keydown و keyup، این ویژگی کد مجازی کلید فشرده شده را مشخص می‌کند. کدهای کیبورد مجازی ممکن است با آرایش کیبورد مورد استفاده مرتبط باشند. |
| offsetX,offsetY | موقعیت مختصات x و y مکان وقوع رویداد در سیستم مختصات عنصر منبع. |
| returnValue |
اگر این ویژگی تنظیم شده باشد، ارزش آن از ارزش بازگشتی رویداد优先 دارد. با تنظیم این ویژگی به fasle، می‌توانید عملکرد پیش‌فرض عنصر منبع رویداد را حذف کنید. |
| srcElement | برای اشاره به ویندوز، مستند یا عنصر ایجادکننده رویداد، به آن اشاره دارد. |
| toElement | برای رویدادهای mouseover و mouseout، این ویژگی به عنصری که ماوس به آن وارد می‌شود اشاره دارد. |
| x,y | موقعیت x و y مختصات مکان وقوع رویداد، که در برابر عنصر محیط داخلی‌ترین CSS تعیین شده قرار دارند. |
- صفحه قبلی DOM Element
- صفحه بعدی DOM HTMLCollection
