عنصر Event
عنصر Event
همه‌ی شیءهای رویداد در DOM بر اساس شیء Event تعریف شده‌اند.
بنابراین، همه‌ی شیءهای رویداد دیگر (مانند MouseEvent و KeyboardEvent)(که می‌توانند به عنوان ویژگی‌ها و روش‌های شیء Event دسترسی پیدا کنند.
ویژگی‌ها و روش‌های رویداد
| ویژگی/روش | توضیح |
|---|---|
| bubbles | اینکه آیا رویداد خاصی یک رویداد بادکنکی است یا خیر را بازمی‌گرداند. |
| cancelBubble | اینکه آیا رویداد باید به سمت سطوح بالاتر منتقل شود یا خیر را تنظیم یا بازمی‌گرداند. |
| cancelable | اینکه آیا رویداد می‌تواند عملیات پیش‌فرض خود را متوقف کند یا خیر را بازمی‌گرداند. |
| composed | اینکه آیا رویداد می‌تواند از Shadow DOM به DOM عمومی منتقل شود یا خیر را نشان می‌دهد. |
| composedPath() | مسیر رویداد را بازمی‌گرداند. |
| createEvent() | رویداد جدیدی ایجاد می‌کند. |
| currentTarget | عنصر ایجادکننده رویداد شناسه‌دهنده رویداد را بازمی‌گرداند. |
| defaultPrevented | اینکه آیا preventDefault() برای رویداد فراخوانی شده است یا خیر را بازمی‌گرداند. |
| eventPhase | مرحله‌ای که جریان رویداد در حال ارزیابی است را بازمی‌گرداند. |
| isTrusted | اعتمادپذیری رویداد را بازمی‌گرداند. |
| preventDefault() | اگر رویداد قابل لغو باشد، آن را لغو می‌کند و عملیات پیش‌فرض مربوط به رویداد را اجرا نمی‌کند. |
| stopImmediatePropagation() | ممانعت از فراخوانی شناسه‌دهنده‌های رویداد دیگر برای همان رویداد. |
| stopPropagation() | ممانعت از ادامه حرکت رویداد در جریان رویداد. |
| target | عنصر ایجادکننده رویداد را بازمی‌گرداند. |
| timeStamp | زمان ایجاد رویداد را (به عنوان میلادی) به میلادین بازمی‌گرداند. |
| type | نام رویداد را بازمی‌گرداند. |
نوع رویداد
این نوع رویدادها به عنوان شیء Event تعریف شده‌اند:
| رویداد | توضیح |
|---|---|
| abort | این رویداد وقتی که بارگذاری رسانه متوقف می‌شود رخ می‌دهد. |
| afterprint | وقتی صفحه شروع به چاپ می‌کند یا هنگام بستن پنجره‌ی دیالوگ چاپ، این رویداد رخ می‌دهد. |
| beforeprint | قبل از چاپ صفحه، این رویداد رخ می‌دهد. |
| beforeunload | قبل از اینکه مستند به حالت بارگذاری شود، این رویداد رخ می‌دهد. |
| canplay | وقتی مرورگر می‌تواند رسانه را شروع به پخش کند، این رویداد رخ می‌دهد. |
| canplaythrough | وقتی مرورگر می‌تواند رسانه را بدون توقف بهینه‌سازی پخش کند، این رویداد رخ می‌دهد. |
| change | وقتی محتوای عنصر فرم، انتخاب شده یا وضعیت انتخاب شده تغییر می‌کند، این رویداد رخ می‌دهد. |
| error | وقتی خطایی در بارگذاری فایل‌های خارجی رخ می‌دهد، این رویداد رخ می‌دهد. |
| fullscreenchange | وقتی عنصر در حالت تمام‌صفحه نمایش نمایش داده می‌شود، این رویداد رخ می‌دهد. |
| fullscreenerror | وقتی عنصر نمی‌تواند در حالت تمام‌صفحه نمایش داده شود، این رویداد رخ می‌دهد. |
| input | وقتی عنصر ورودی کاربر دریافت می‌شود، این رویداد رخ می‌دهد. |
| invalid | وقتی عنصر نامعتبر است، این رویداد رخ می‌دهد. |
| load | وقتی اشیاء بارگذاری شدند، این رویداد رخ می‌دهد. |
| loadeddata | وقتی داده‌های رسانه بارگذاری شدند، این رویداد رخ می‌دهد. |
| loadedmetadata | وقتی داده‌های متا (مثلاً اندازه و زمان) بارگذاری می‌شوند، این رویداد رخ می‌دهد. |
| message | وقتی پیام‌ها از طریق این منبع رویداد دریافت می‌شوند، این رویداد رخ می‌دهد. |
| offline | وقتی مرورگر شروع به کار آفلاین می‌کند، این رویداد رخ می‌دهد. |
| online | وقتی مرورگر شروع به کار آنلاین می‌کند، این رویداد رخ می‌دهد. |
| open | وقتی اتصال به منبع رویداد باز می‌شود، این رویداد رخ می‌دهد. |
| pause | وقتی رسانه توسط کاربر یا به صورت برنامه‌ریزی شده به حالت توقف در می‌آید، این رویداد رخ می‌دهد. |
| play | وقتی رسانه شروع به پخش می‌شود یا دیگر در حال توقف نیست، این رویداد رخ می‌دهد. |
| playing | وقتی رسانه به حالت استراحت یا توقف در نظر گرفته می‌شود تا بهینه‌سازی شود و سپس پخش می‌شود، این رویداد رخ می‌دهد. |
| progress | وقتی مرورگر در حال دریافت داده‌های رسانه‌ای است، این رویداد رخ می‌دهد. |
| ratechange | وقتی سرعت پخش رسانه تغییر می‌کند، این رویداد رخ می‌دهد. |
| resize | وقتی اندازه دیدگاه مستند تغییر می‌کند، این رویداد رخ می‌دهد. |
| reset | وقتی فرم بازسازی می‌شود، این رویداد رخ می‌دهد. |
| scroll | وقتی اسکرول بار عنصر اسکرول می‌شود، این رویداد رخ می‌دهد. |
| search | وقتی کاربر در فیلتر جستجو محتوا وارد می‌کند، این رویداد رخ می‌دهد. |
| seeked | وقتی کاربر به موقعیت جدید در رسانه می‌رسد، این رویداد رخ می‌دهد. |
| seeking | وقتی کاربر شروع به حرکت/پرش به موقعیت جدید در رسانه می‌کند، این رویداد رخ می‌دهد. |
| select | وقتی کاربر متن را انتخاب می‌کند (برای <input> و <textarea>)، این رویداد رخ می‌دهد. |
| show | وقتی علامت <menu> به عنوان منوی محلی نمایش داده می‌شود، این رویداد رخ می‌دهد. |
| stalled | وقتی مرورگر تلاش می‌کند تا داده‌های رسانه‌ای را دریافت کند و داده‌ها در دسترس نیستند، این رویداد رخ می‌دهد. |
| submit | این رویداد وقتی فرم ارسال می‌شود، رخ می‌دهد. |
| suspend | این رویداد وقتی مرورگر به طور عمدی داده‌های رسانه را دریافت نمی‌کند، رخ می‌دهد. |
| timeupdate | این رویداد وقتی موقعیت پخش تغییر می‌کند، رخ می‌دهد. |
| toggle | این رویداد وقتی کاربر علامت <details> را باز یا بسته می‌کند، رخ می‌دهد. |
| unload | این رویداد پس از بارگذاری صفحه (برای <body>) رخ می‌دهد. |
| waiting | این رویداد وقتی رخ می‌دهد که رسانه متوقف شده است اما انتظار می‌رود که به زودی دوباره شروع شود. |
