دستورالعمل‌های مرجع رویدادهای HTML

خصوصیات رویدادهای جهانی

HTML قابلیت تحریک اعمال‌های مرورگر را دارد، به عنوان مثال، اجرای JavaScript هنگام کلیک کاربر روی یک عنصر.

برای اطلاعات بیشتری در مورد رویدادهای برنامه‌نویسی، لطفاً وب‌سایت ما را访问 کنید: آموزش JavaScript.

در اینجا خصوصیات رویدادهای جهانی آورده شده است که می‌توانند به عناصر HTML اضافه شوند تا عملکرد رویدادها تعریف شوند.

خصوصیات رویداد window

رویدادهایی که برای شیء window تحریک می‌شوند (برای برچسب <body> اعمال می‌شود):

ویژگی مقادیر توضیح
onafterprint اسکریپت اسکریپتی که پس از چاپ مستند اجرا می‌شود.
onbeforeprint اسکریپت اسکریپتی که پیش از چاپ مستند اجرا می‌شود.
onbeforeunload اسکریپت اسکریپتی که پیش از卸یدن مستند اجرا می‌شود.
onerror اسکریپت اسکریپتی که در هنگام رخ دادن خطا اجرا می‌شود.
onhaschange اسکریپت اسکریپتی که در هنگام تغییر مستند اجرا می‌شود.
onload اسکریپت پس از پایان بارگذاری صفحه رویداد تحریک می‌شود.
onmessage اسکریپت اسکریپتی که در هنگام تحریک پیام اجرا می‌شود.
onoffline اسکریپت اسکریپتی که در هنگام قرار گرفتن مستند آفلاین اجرا می‌شود.
ononline اسکریپت اسکریپتی که در هنگام قرار گرفتن مستند آنلاین اجرا می‌شود.
onpagehide اسکریپت اسکریپتی که در هنگام مخفی شدن پنجره اجرا می‌شود.
onpageshow اسکریپت اسکریپتی که در هنگام دیدنی شدن پنجره اجرا می‌شود.
onpopstate اسکریپت اسکریپتی که در هنگام تغییر تاریخچه پنجره اجرا می‌شود.
onredo اسکریپت اسکریپتی که در هنگام اجرای redo در مستند اجرا می‌شود.
onresize اسکریپت وقتی پنجره مرورگر بزرگتر یا کوچکتر شد، رویداد تحریک می‌شود.
onstorage اسکریپت اسکریپتی که پس از به‌روزرسانی فضای ذخیره‌سازی وب اجرا می‌شود.
onundo اسکریپت اسکریپتی که در هنگام اجرای undo در مستند اجرا می‌شود.
onunload اسکریپت وقتی صفحه بارگذاری شد (یا پنجره مرورگر بسته شد).

رویداد‌های فرم

رویدادهایی که توسط عملکرد فرم HTML تحریک می‌شوند (برای تقریباً همه عناصر HTML اعمال می‌شود، اما بیشتر در عناصر فرم استفاده می‌شود):

ویژگی مقادیر توضیح
onblur اسکریپت رویدادهایی که هنگام از دست دادن تمرکز عنصر اجرا می‌شوند.
onchange اسکریپت رویدادهایی که هنگام تغییر ارزش عنصر اجرا می‌شوند.
oncontextmenu اسکریپت رویدادهایی که هنگام تحریک منوی محیطی اجرا می‌شوند.
onfocus اسکریپت رویدادهایی که هنگام دریافت تمرکز توسط عنصر اجرا می‌شوند.
onformchange اسکریپت رویدادهایی که هنگام تغییر فرم اجرا می‌شوند.
onforminput اسکریپت رویدادهایی که هنگام دریافت ورودی کاربر توسط فرم تحریک می‌شوند.
oninput اسکریپت رویدادهایی که هنگام دریافت ورودی کاربر توسط عنصر تحریک می‌شوند.
oninvalid اسکریپت رویدادهایی که هنگام غیر معتبر بودن عنصر اجرا می‌شوند.
onreset اسکریپت رویدادهایی که هنگام کلیک روی دکمه بازنشانی فرم تحریک می‌شوند. در HTML5 پشتیبانی نمی‌شود.
onselect اسکریپت رویدادهایی که هنگام انتخاب متن در عنصر تحریک می‌شوند.
onsubmit اسکریپت رویدادهایی که هنگام ارسال فرم تحریک می‌شوند.

رویدادهای کلیدبرد

ویژگی مقادیر توضیح
onkeydown اسکریپت رویدادهایی که هنگام فشار دادن کلید توسط کاربر تحریک می‌شوند.
onkeypress اسکریپت رویدادهایی که هنگام فشار دادن کلید توسط کاربر تحریک می‌شوند.
onkeyup اسکریپت رویدادهایی که هنگام رها کردن کلید توسط کاربر تحریک می‌شوند.

رویدادهای ماوس

رویدادهایی که توسط حرکت ماوس یا مشابه آن تحریک می‌شوند:

ویژگی مقادیر توضیح
onclick اسکریپت رویدادهایی که هنگام کلیک روی عنصر تحریک می‌شوند.
ondblclick اسکریپت رویدادهایی که هنگام کلیک دوبل روی عنصر تحریک می‌شوند.
ondrag اسکریپت اسکریپت‌هایی که هنگام کشیدن عنصر اجرا می‌شوند.
ondragend اسکریپت اسکریپت‌هایی که در پایان عملیات کشیدن و رها کردن اجرا می‌شوند.
ondragenter اسکریپت اسکریپت‌هایی که هنگام رها کردن عنصر در منطقه معتبر کشیده شده اجرا می‌شوند.
ondragleave اسکریپت اسکریپت‌هایی که هنگام حرکت عنصر از هدف معتبر خارج شدن اجرا می‌شوند.
ondragover اسکریپت اسکریپت‌هایی که هنگام کشیدن عنصر به سمت هدف معتبر در حال اجرا هستند.
ondragstart اسکریپت اسکریپت‌هایی که در آغاز عملیات کشیدن و رها کردن اجرا می‌شوند.
ondrop اسکریپت اسکریپت‌هایی که هنگام تلاش برای حرکت عنصر در حال تداوم اجرا می‌شوند.
onmousedown اسکریپت رویدادهایی که هنگام فشار دادن دکمه ماوس در عنصر تحریک می‌شوند.
onmousemove اسکریپت رویدادهایی که هنگام حرکت ماوس به سمت عنصر تحریک می‌شوند.
onmouseout اسکریپت رویدادهایی که هنگام حرکت ماوس از عنصر خارج می‌شود تحریک می‌شوند.
onmouseover اسکریپت رویدادهایی که هنگام حرکت ماوس به سمت عنصر تحریک می‌شوند.
onmouseup اسکریپت رویدادهایی که هنگام رها کردن دکمه ماوس در عنصر تحریک می‌شوند.
onmousewheel اسکریپت اسکریپت‌هایی که هنگام حرکت چرخ دنده ماوس اجرا می‌شوند.
onscroll اسکریپت اسکریپت‌هایی که هنگام حرکت اسکرول در نوار عناصر اجرا می‌شوند.

رویدادهای مدیا

رویدادهایی که توسط رسانه‌ها (مثلاً ویدیو، تصاویر و صوت) تحریک می‌شوند (برای همه عناصر HTML قابل اعمال است، اما معمولاً در عناصر رسانه‌ای مانند <audio>، <embed>، <img>، <object> و <video>):

ویژگی مقادیر توضیح
onabort اسکریپت اسکریپتی که در هر بار وقتی در حال خروج هستیم اجرا می‌شود.
oncanplay اسکریپت اسکریپتی که در هر بار وقتی فایل آماده برای شروع پخش است اجرا می‌شود (وقتی بارگذاری به اندازه کافی انجام شده است).
oncanplaythrough اسکریپت اسکریپتی که در هر بار وقتی رسانه می‌تواند بدون نیاز به بارگذاری بیشتر تا پایان پخش شود اجرا می‌شود.
ondurationchange اسکریپت اسکریپتی که در هر بار وقتی طول رسانه تغییر کند اجرا می‌شود.
onemptied اسکریپت اسکریپتی که در هر بار وقتی به هر دلیلی فایل ناگهان غیرقابل دسترسی می‌شود اجرا می‌شود (مثلاً وقتی اتصال به طور ناگهانی قطع می‌شود).
onended اسکریپت اسکریپتی که در هر بار وقتی رسانه به پایان می‌رسد اجرا می‌شود (مثلاً می‌توان پیامی مانند «ممنون از تماشا» ارسال کرد).
onerror اسکریپت اسکریپتی که در هر بار وقتی در طول بارگذاری فایل خطایی رخ می‌دهد اجرا می‌شود.
onloadeddata اسکریپت اسکریپتی که در هر بار وقتی داده‌های رسانه بارگذاری شده‌اند اجرا می‌شود.
onloadedmetadata اسکریپت اسکریپتی که در هر بار وقتی داده‌های متا (مثلاً رزولوشن و مدت زمان) بارگذاری می‌شوند اجرا می‌شود.
onloadstart اسکریپت اسکریپتی که در هر بار وقتی فایل شروع به بارگذاری می‌کند اما هنوز هیچ داده‌ای بارگذاری نشده است اجرا می‌شود.
onpause اسکریپت اسکریپتی که در هر بار وقتی رسانه توسط کاربر یا برنامه به حالت توقف درآمده است اجرا می‌شود.
onplay اسکریپت اسکریپتی که در هر بار وقتی رسانه آماده برای شروع پخش است اجرا می‌شود.
onplaying اسکریپت اسکریپتی که در هر بار وقتی رسانه شروع به پخش می‌کند اجرا می‌شود.
onprogress اسکریپت اسکریپتی که در هر بار وقتی مرورگر در حال بازیابی داده‌های رسانه است اجرا می‌شود.
onratechange اسکریپت اسکریپتی که در هر بار وقتی سرعت پخش تغییر کند اجرا می‌شود (مثلاً وقتی کاربر به حالت کندتر یا سریع‌تر می‌پردازد).
onreadystatechange اسکریپت اسکریپتی که در هر بار وقتی وضعیت آماده‌سازی تغییر کند اجرا می‌شود (وضعیت آماده‌سازی وضعیت داده‌های رسانه را نظارت می‌کند).
onseeked اسکریپت اسکریپتی که در هر بار وقتی ویژگی seeking به false تنظیم شود (نشان‌دهنده اینکه جستجو به پایان رسیده است) اجرا می‌شود.
onseeking اسکریپت اسکریپتی که در هر بار وقتی ویژگی seeking به true تنظیم شود (نشان‌دهنده اینکه جستجو فعال است) اجرا می‌شود.
onstalled اسکریپت اسکریپتی که در هر بار وقتی به هر دلیلی داده‌های رسانه توسط مرورگر بازیابی نشده است اجرا می‌شود.
onsuspend اسکریپت اسکریپتی که در هر بار وقتی به هر دلیلی فرآیند بارگذاری داده‌های رسانه متوقف می‌شود اجرا می‌شود.
ontimeupdate اسکریپت اسکریپتی که در هر بار تغییر در موقعیت پخش اجرا می‌شود (مثلاً وقتی کاربر به موقعیت مختلفی در رسانه می‌پردازد).
onvolumechange اسکریپت اسکریپتی که در هر بار تغییر در صدای رسانه اجرا می‌شود (شامل قرار دادن صدای رسانه در حالت سکوت).
onwaiting اسکریپت وقتی رسانه متوقف شده است اما قصد دارد ادامه دهد (مثلاً وقتی رسانه به صورت موقت متوقف شده است تا داده‌های بیشتری بارگذاری کند) اسکریپت اجرا می‌شود