رویدادهای HTML DOM

رویدادهای HTML DOM

رویدادهای HTML DOM به جاوااسکریپت اجازه می‌دهند تا رویدادهای مختلفی را روی عناصر مستند HTML ثبت کنند.

رویدادها معمولاً با تابع‌ها ترکیب می‌شوند، تابع‌ها قبل از وقوع رویداد اجرا نمی‌شوند (مثلاً وقتی که کاربر روی دکمه کلیک می‌کند).

برای یادگیری آموزش‌های مربوط به رویدادها، لطفاً دوره‌های ما را مطالعه کنید: آموزش رویدادهای جاوااسکریپت。

رویداد توضیح معلق
abort این رویداد وقتی که بارگذاری رسانه متوقف می‌شود، رخ می‌دهد.
afterprint این رویداد وقتی که صفحه شروع به چاپ می‌کند یا دیالوگ چاپ بسته می‌شود، رخ می‌دهد. Event
animationend این رویداد در پایان CSS آنیمایشن رخ می‌دهد. AnimationEvent
animationiteration این رویداد در تکرار CSS آنیمایشن رخ می‌دهد. AnimationEvent
animationstart این رویداد در شروع CSS آنیمایشن رخ می‌دهد. AnimationEvent
beforeprint این رویداد قبل از اینکه صفحه چاپ شود، رخ می‌دهد. Event
beforeunload این رویداد قبل از اینکه مستند از بین برود، رخ می‌دهد.
blur این رویداد وقتی که عنصر از تمرکز خارج می‌شود، رخ می‌دهد. FocusEvent
canplay این رویداد وقتی که مرورگر می‌تواند رسانه را شروع به پخش کند، رخ می‌دهد. Event
canplaythrough این رویداد وقتی که مرورگر می‌تواند بدون توقف بارگذاری، رسانه را پخش کند، رخ می‌دهد. Event
change این رویداد وقتی که محتوای عنصر form، انتخاب شده یا وضعیت انتخاب شده تغییر می‌کند، رخ می‌دهد. Event
click این رویداد وقتی که کاربر روی عنصر کلیک می‌کند، رخ می‌دهد. MouseEvent
contextmenu این رویداد وقتی که کاربر با کلیک راست روی عنصر، منوی محیط را باز می‌کند، رخ می‌دهد. MouseEvent
copy این رویداد وقتی که کاربر محتوای عنصر را کپی می‌کند، رخ می‌دهد. ClipboardEvent
cut این رویداد وقتی که کاربر محتوای عنصر را برش می‌دهد، رخ می‌دهد. ClipboardEvent
dblclick این رویداد وقتی که کاربر روی عنصر دوبار کلیک می‌کند، رخ می‌دهد. MouseEvent
drag در حالی که عنصر در حال حرکت است، این رویداد رخ می‌دهد. DragEvent
dragend وقتی کاربر کشیدن عنصر را به پایان می‌رساند، این رویداد رخ می‌دهد. DragEvent
dragenter وقتی عنصر کشیده شده به هدف وارد می‌شود، این رویداد رخ می‌دهد. DragEvent
dragleave وقتی عنصر کشیده شده از هدف خارج می‌شود، این رویداد رخ می‌دهد. DragEvent
dragover وقتی عنصر کشیده شده روی هدف قرار می‌گیرد، این رویداد رخ می‌دهد. DragEvent
dragstart وقتی کاربر شروع به کشیدن عنصر می‌کند، این رویداد رخ می‌دهد. DragEvent
drop وقتی عنصر کشیده شده روی هدف قرار می‌گیرد، این رویداد رخ می‌دهد. DragEvent
durationchange وقتی مدت زمان رسانه تغییر می‌کند، این رویداد رخ می‌دهد. Event
ended وقتی رسانه به پایان می‌رسد، این رویداد رخ می‌دهد. Event
error وقتی خطایی در بارگذاری فایل‌های خارجی رخ می‌دهد، این رویداد رخ می‌دهد.
focus وقتی عنصر فокус دریافت می‌کند، این رویداد رخ می‌دهد. FocusEvent
focusin وقتی عنصر در حال دریافت فокус قرار می‌گیرد، این رویداد رخ می‌دهد. FocusEvent
focusout وقتی عنصر در حال از دست دادن فокус قرار می‌گیرد، این رویداد رخ می‌دهد. FocusEvent
fullscreenchange وقتی عنصر در حالت تمام‌صفحه نمایش نمایش داده می‌شود، این رویداد رخ می‌دهد. Event
fullscreenerror وقتی عنصر نمی‌تواند در حالت تمام‌صفحه نمایش نشان داده شود، این رویداد رخ می‌دهد. Event
hashchange وقتی بخش آنکر URL تغییر می‌کند، این رویداد رخ می‌دهد. HashChangeEvent
input وقتی عنصر ورودی کاربر دریافت می‌شود، این رویداد رخ می‌دهد.
invalid وقتی عنصر نامعتبر است، این رویداد رخ می‌دهد. Event
keydown وقتی کاربر دکمه را فشار می‌دهد، این رویداد رخ می‌دهد. KeyboardEvent
keypress وقتی کاربر دکمه را فشار می‌دهد، این رویداد رخ می‌دهد. KeyboardEvent
keyup وقتی کاربر دکمه را رها می‌کند، این رویداد رخ می‌دهد. KeyboardEvent
load وقتی داده‌ها به طور کامل بارگذاری شدند، این رویداد رخ می‌دهد.
loadeddata وقتی داده‌های رسانه بارگذاری شدند، این رویداد رخ می‌دهد. Event
loadedmetadata وقتی داده‌های متا (مثلاً اندازه و مدت زمان) بارگذاری می‌شوند، این رویداد رخ می‌دهد. Event
loadstart وقتی مرورگر شروع به جستجوی رسانه‌های مشخص شده می‌کند، این رویداد رخ می‌دهد. ProgressEvent
message وقتی پیام‌ها از این منبع رویداد دریافت می‌شوند، این رویداد رخ می‌دهد. Event
mousedown وقتی کاربر دکمه موس را روی عنصر فشار می‌دهد، این رویداد رخ می‌دهد. MouseEvent
mouseenter وقتی نشانگر به روی عنصر حرکت می‌کند، این رویداد رخ می‌دهد. MouseEvent
mouseleave وقتی نشانگر از روی عنصر خارج می‌شود، این رویداد رخ می‌دهد. MouseEvent
mousemove وقتی نشانگر روی عنصر حرکت می‌کند، این رویداد رخ می‌دهد. MouseEvent
mouseout وقتی کاربر نشانگر موس را از روی عنصر یا یکی از فرزندان آن خارج می‌کند، این رویداد رخ می‌دهد. MouseEvent
mouseover وقتی نشانگر به روی عنصر یا یکی از فرزندان آن حرکت می‌کند، این رویداد رخ می‌دهد. MouseEvent
mouseup وقتی کاربر دکمه موس را روی عنصر رها می‌کند، این رویداد رخ می‌دهد. MouseEvent
mousewheel مستند نشده است.لطفاً استفاده کنید. wheel رویداد. WheelEvent
offline وقتی مرورگر شروع به کار آفلاین می‌کند، این رویداد رخ می‌دهد. Event
online وقتی مرورگر شروع به کار آنلاین می‌کند، این رویداد رخ می‌دهد. Event
open وقتی ارتباط با منبع رویداد باز می‌شود، این رویداد رخ می‌دهد. Event
pagehide وقتی کاربر از یک صفحه وب برای هدایت خارج می‌شود، این رویداد رخ می‌دهد. PageTransitionEvent
pageshow وقتی کاربر به یک صفحه وب هدایت می‌شود، این رویداد رخ می‌دهد. PageTransitionEvent
paste وقتی کاربر محتوایی را به داخل عنصر چسبانده می‌کند، این رویداد رخ می‌دهد. ClipboardEvent
pause وقتی رسانه توسط کاربر یا به صورت برنامه‌ریزی شده تعلیق می‌شود، این رویداد رخ می‌دهد. Event
play وقتی رسانه شروع به پخش می‌کند یا دیگر در حال تعلیق نیست، این رویداد رخ می‌دهد. Event
playing وقتی رسانه پس از تعلیق یا توقف برای بارگذاری پس از بازیابی پخش می‌شود، این رویداد رخ می‌دهد. Event
popstate وقتی تاریخچه پنجره تغییر می‌کند، این رویداد رخ می‌دهد. PopStateEvent
progress وقتی مرورگر در حال دریافت داده‌های رسانه‌ای است، این رویداد رخ می‌دهد. Event
ratechange وقتی سرعت پخش رسانه تغییر می‌کند، این رویداد رخ می‌دهد. Event
reset وقتی فرم重نویسی می‌شود، این رویداد رخ می‌دهد. Event
resize وقتی اندازه نمایه مستند تغییر می‌کند، این رویداد رخ می‌دهد.
scroll وقتی نوار کشیدن عنصر ر滚动 می‌شود، این رویداد رخ می‌دهد.
search وقتی کاربر در زمینه جستجو محتوایی وارد می‌کند، این رویداد رخ می‌دهد. Event
seeked وقتی کاربر به موقعیت جدید در رسانه می‌رسد، این رویداد رخ می‌دهد. Event
seeking وقتی کاربر شروع به حرکت/پرش به موقعیت جدید در رسانه می‌کند، این رویداد رخ می‌دهد. Event
select وقتی کاربر متن را انتخاب می‌کند (برای <input> و <textarea>)، این رویداد رخ می‌دهد.
show وقتی عنصر <menu> به عنوان منوی متناظر نمایش داده می‌شود، این رویداد رخ می‌دهد. Event
stalled وقتی مرورگر تلاش می‌کند داده‌های رسانه‌ای را دریافت کند اما داده‌ها در دسترس نیستند، این رویداد رخ می‌دهد. Event
storage وقتی فضای ذخیره‌سازی وب به‌روزرسانی می‌شود، این رویداد رخ می‌دهد. StorageEvent
submit وقتی فرم ارسال می‌شود، این رویداد رخ می‌دهد. Event
suspend وقتی مرورگر به طور ارادی داده‌های رسانه‌ای را دریافت نمی‌کند، این رویداد رخ می‌دهد. Event
timeupdate وقتی موقعیت پخش تغییر می‌کند، این رویداد رخ می‌دهد. Event
toggle وقتی کاربر <details> را باز یا بست، این رویداد رخ می‌دهد. Event
touchcancel وقتی لمس قطع شد، این رویداد رخ می‌دهد. TouchEvent
touchend وقتی انگشت از صفحه لمسی خارج می‌شود، این رویداد رخ می‌دهد. TouchEvent
touchmove وقتی انگشت روی صفحه صفحه‌نمایش کشیده می‌شود، این رویداد رخ می‌دهد. TouchEvent
touchstart وقتی انگشت روی صفحه لمسی قرار می‌گیرد، این رویداد رخ می‌دهد. TouchEvent
transitionend وقتی CSS تبدیل شد، این رویداد رخ می‌دهد. TransitionEvent
unload این رویداد پس از بارگذاری صفحه (برای <body>) رخ می‌دهد
volumechange این رویداد هنگامی که صدای رسانه تغییر می‌کند، رخ می‌دهد Event
waiting این رویداد هنگامی که رسانه‌ها به حالت تعلیق درآمده‌اند اما انتظار می‌رود که به حالت اولیه بازگردند، رخ می‌دهد Event
wheel این رویداد هنگامی که چرخش موس در یک عنصر به بالا یا پایین است، رخ می‌دهد WheelEvent

ویژگی‌ها و روش‌های رویداد HTML DOM

ویژگی/روش توضیح معلق
altKey بازگشت اینکه آیا کلید "ALT" در هنگام رویداد موس فشرده شده است یا خیر MouseEvent
altKey بازگشت اینکه آیا کلید "ALT" در هنگام رویداد کلید فشرده شده است یا خیر
animationName بازگشت نام انیمیشن AnimationEvent
bubbles بازگشت اینکه آیا رویداد خاصی یک رویداد حباب‌گسیل است یا خیر Event
button بازگشت دکمه موس که در زمان تحریک رویداد موس فشرده شده است. MouseEvent
buttons بازگشت دکمه موس که در زمان تحریک رویداد موس فشرده شده است. MouseEvent
cancelBubble تنظیم یا بازگشت اینکه آیا رویداد باید به سمت سطوح بالاتر منتقل شود یا خیر
cancelable بازگشت اینکه آیا رویداد می‌تواند عمل پیش‌فرض خود را متوقف کند یا خیر Event
changeTouches بازگشت لیستی از همه اشیاء لمسی که در بین لمس‌های قبلی و فعلی وضعیت خود را تغییر داده‌اند TouchEvent
charCode بازگشت کد Unicode کلیدی که رویداد onkeypress تحریک شده است KeyboardEvent
clientX بازگشت مختصات افقی موس در مقایسه با پنجره فعلی در هنگام رویداد موس
clientY بازگشت مختصات عمودی موس در مقایسه با پنجره فعلی در هنگام رویداد موس
clipboardData بازگشت شیء که شامل داده‌هایی است که تحت تأثیر عمل剪بده قرار گرفته‌اند ClipboardData
code بازگشت کد کلیدی که رویداد تحریک شده است KeyboardEvent
composed نشان می‌دهد که آیا این رویداد می‌تواند از Shadow DOM به DOM عمومی منتقل شود یا خیر Event
composedPath() بازگشت مسیر رویداد
createEvent() ایجاد یک رویداد جدید Event
ctrlKey بازگشت اینکه آیا کلید "CTRL" در هنگام رویداد موس فشرده شده است یا خیر MouseEvent
ctrlKey بازگشت اینکه آیا کلید "CTRL" در هنگام رویداد کلید موس فشرده شده است یا خیر
currentTarget بازگشت عنصری که رویداد شناسایی شده توسط شناسه‌دهنده رویداد فعلی را تحریک کرده است Event
data بازگشت حرف اضافه شده InputEvent
dataTransfer بازگشت یک شیء که شامل داده‌های کشیده شده یا اضافه شده/حذف شده است
defaultPrevented بازگشت اینکه آیا preventDefault() برای فراخوانی رویداد استفاده شده است یا خیر Event
deltaX بازگشت مقدار چرخش افقی موس (آxis x) WheelEvent
deltaY بازگشت مقدار چرخش عمودی موس (آxis y) WheelEvent
deltaZ بازگشت مقدار چرخش محوری موس WheelEvent
deltaMode بازگشت به عددی که نشان‌دهنده واحد اندازه‌گیری مقدار افزایش (پیکسل، خط یا صفحه) است. WheelEvent
detail بازگشت به عددی که نشان‌دهنده تعداد کلیک‌های ماوس است. UiEvent
elapsedTime بازگشت به تعداد ثانیه‌ای که آنی‌میشن انجام شده است. AnimationEvent
elapsedTime بازگشت به تعداد ثانیه‌ای که انتقال انجام شده است. 　
eventPhase بازگشت به این که رویداد در کدام مرحله از جریان ارزیابی شده است. Event
getModifierState() بازگشت به آرایه‌ای که شامل محدوده هدف است، این محدوده تحت تأثیر عملیات اضافه‌کردن/حذف قرار می‌گیرد. MouseEvent
getTargetRanges() بازگشت به آرایه‌ای که شامل محدوده هدف است، این محدوده تحت تأثیر عملیات اضافه‌کردن/حذف قرار می‌گیرد. InputEvent
inputType بازگشت به نوع تغییر (یعنی "inserting" یا "deleting"). InputEvent
isComposing بازگشت به این که آیا وضعیت رویداد در حال شکل‌گیری است یا خیر.
isTrusted بازگشت به این که آیا رویداد قابل اعتماد است یا خیر. Event
key بازگشت به مقدار کلیدی که رویداد نشان‌دهنده آن است. KeyboardEvent
key بازگشت به کلید جدید پروژه ذخیره‌سازی شده. StorageEvent
keyCode بازگشت به کد Unicode کلیدی که رویداد onkeypress، onkeydown یا onkeyup فعال‌سازی شده است. KeyboardEvent
location بازگشت به موقعیت کلید روی صفحه‌کلید یا دستگاه. KeyboardEvent
lengthComputable بازگشت به این که طول پیشرفت قابل محاسبه است یا خیر. ProgressEvent
loaded بازگشت به مقدار کار بارگذاری شده. ProgressEvent
metaKey بازگشت به این که آیا کلید "META" در هنگام فعال‌سازی رویداد فشرده شده است یا خیر. MouseEvent
metaKey بازگشت به این که آیا کلید "META" در هنگام فعال‌سازی رویداد کلید فشرده شده است یا خیر.
MovementX بازگشت به موقعیت افقی نشان‌گر موس در مقایسه با موقعیت آخرین رویداد mousemove. MouseEvent
MovementY بازگشت به موقعیت عمودی نشان‌گر موس در مقایسه با موقعیت آخرین رویداد mousemove. MouseEvent
newURL بازگشت به URL مستند بعد از تغییر hash. HasChangeEvent
newValue بازگشت به مقدار جدید پروژه‌ای که ذخیره‌سازی تغییر کرده است. StorageEvent
offsetX بازگشت به موقعیت افقی نشان‌گر موس در مقایسه با لبه عنصر هدف. MouseEvent
offsetY بازگشت به موقعیت عمودی نشان‌گر موس در مقایسه با لبه عنصر هدف. MouseEvent
oldURL بازگشت به URL مستند قبل از تغییر hash. HasChangeEvent
oldValue بازگشت به مقدار قبلی پروژه‌ای که ذخیره‌سازی تغییر کرده است. StorageEvent
onemptied وقتی که وضعیت بدی رخ می‌دهد و فایل‌های رسانه‌ای به طور ناگهانی غیرقابل استفاده می‌شوند، این رویداد رخ می‌دهد. 　
pageX بازگشت به موقعیت افقی نشان‌گر موس در مقایسه با مستند. MouseEvent
pageY بازگشت به موقعیت عمودی نشان‌گر موس در مقایسه با مستند. MouseEvent
persisted بازگشت به اینترنت‌صفحه آیا توسط مرورگر در حافظه‌پدیده شده است. PageTransitionEvent
preventDefault() اگر رویداد قابل لغو باشد، آن را لغو کرده و عمل پیش‌فرض مربوط به رویداد را اجرا نمی‌کند. Event
propertyName بازگشت نام ویژگی CSS مرتبط با انیمیشن یا گذار.
pseudoElement بازگشت نام پseudo-element مربوط به انیمیشن یا گذار.
region MouseEvent
relatedTarget بازگشت عنصری که به آن مربوط می‌شود. MouseEvent
relatedTarget بازگشت عنصری که به آن مربوط می‌شود. FocusEvent
repeat بازگشت به این که آیا کلید خاصی چندین بار فشرده شده است. KeyboardEvent
screenX بازگشت به این که آیا نقطه پیکان ماوس/نمای ویندوز در راستای افقی صفحه نمایش قرار دارد. MouseEvent
screenY بازگشت به این که آیا نقطه پیکان ماوس/نمای ویندوز در راستای عمودی صفحه نمایش قرار دارد. MouseEvent
shiftKey بازگشت به این که آیا کلید "SHIFT" در زمان تحریک رویداد فشرده شده است یا خیر. MouseEvent
shiftKey بازگشت به این که آیا کلید "SHIFT" در زمان تحریک رویداد فشرده شده است یا خیر.
state بازگشت عنصری که شامل نسخه‌ای از ورودی تاریخچه است. PopStateEvent
stopImme...() ممانعت از فراخوانی شنوندگان دیگر رویداد. Event
stopPropagation() ممانعت از گسترش رویداد در جریان رویداد. Event
storageArea بازگشت عنصری که نماینده‌ای برای موجودیت ذخیره‌سازی تأثیرگذار است. StorageEvent
target بازگشت عنصلی که رویداد را تحریک کرده است. Event
targetTouches بازگشت لیست TouchList از TouchObject‌هایی که هنوز با سطح تماس دارند. TouchEvent
timeStamp بازگشت زمانی که رویداد ایجاد شده است (به میل ثانیه‌های جبری). Event
total بازگشت مقدار کل کاری که قرار است بارگذاری شود. ProgressEvent
touches بازگشت لیستی از touch‌های فعلی که با سطح تماس دارند. TouchEvent
type بازگشت نام رویداد. Event
url بازگشت URL مستندی که پروژه تغییر کرده است. StorageEvent
which بازگشت دکمه موس که در زمان تحریک رویداد موس فشرده شده است. MouseEvent
which بازگشت کد Unicode کاراکتر کلیدی که رویداد onkeypress را تحریک کرده است، یا کد کلید Unicode کلیدی که رویداد onkeydown یا onkeyup را تحریک کرده است. KeyboardEvent
نمای اشاره به ویندوزی که رویداد رخ داده را بازمی‌گرداند. UiEvent