Объект event

event нысаны оқиға орын алған кезде жасалып, ол туралы ақпаратты қамтиды. Оқиға пайда болған кезде event нысаны оны өңдейтін функцияға беріледі.

Event нысанының қасиеттері мен әдістері

Төмендегі кестеде event нысанының қасиеттері мен әдістері және олардың сипаттамасы көрсетілген:

Атауы	Сипаттама
`event.currentTarget`	Оқиғаның көтерілу кезеңіндегі ағымдағы DOM элементі. Әдетте бұл қасиет функциядағы `this`-ке тең болады.
`event.data`	Міндетті емес параметр. Орындалатын өңдегіш қосылған кезде оқиға әдісіне берілетін деректер нысаны.
`event.delegateTarget`	Жаңа ғана шақырылған jQuery оқиға өңдегіші қосылған элемент. Бұл қасиет өңделетін элементтің ата-тегіне байланысты тапсырылған оқиғаларда ең пайдалы. Тікелей элементке байланысты тапсырылмаған өңдегіштер үшін `event.delegateTarget` мәні `event.currentTarget` мәніне сәйкес келеді.
`event.isDefaultPrevented`	Әдіс бұл оқиға нысаны үшін `event.preventDefault` әдісі шақырылған ба жоқты тексереді.
`event.isImmediatePropagationStopped`	Әдіс бұл оқиға нысаны үшін `event.stopImmediatePropagation` әдісі шақырылған ба жоқты тексереді.
`event.isPropagationStopped`	Әдіс бұл оқиға нысаны үшін `event.stopPropagation` әдісі шақырылған ба жоқты тексереді.
`event.isPropagationStopped`	Әдіс бұл оқиға нысаны үшін `event.stopPropagation` әдісі шақырылған ба жоқты тексереді.
`event.metaKey`	Әдіс оқиға орын алған кезде `META` түймесі басылған ба жоқты тексереді. Платформаға байланысты түйме әртүрлі болуы мүмкін. `true` немесе `false` мәнін қайтарады.
`event.namespace`	Оқиға шақырылған кезде көрсетілген кеңістік атауы. Бұл қасиет пайдаланылатын кеңістік атауына тәуелді мәселелері бар плагиндер авторы үшін пайдалы болады.
`event.pageX`	Тінтуірдің құжаттың сол жақ шетіне қатысты орнын көрсетеді.
`event.pageY`	Тінтуірдің құжаттың жоғарғы шетіне қатысты орнын көрсетеді.
`event.preventDefault`	Егер бұл әдіс шақырылса, онда бұл оқиға үшін әдепкі әрекет орындалмайды. Мысалы сілтемені басу жаңа URL-ге өтпейді. Бұл әдіс шақырылған ба жоқты тексеру үшін `event.isDefaultPrevented` әдісін пайдалануға болады.
`event.relatedTarget`	Оқиғаға қатысатын басқа DOM элементін қайтарады, егер бар болса. `mouseout` үшін тінтуір қай элементке тіркелгенін көрсетеді, `mouseover` үшін тінтуір курсоры қай элементтен алынғанын көрсетеді.
`event.result`	Орын алған оқиғаның өңдегіші қайтарған соңғы мән, `undefined`-ке тең емес. Бұл қасиет өз оқиғаларының мәндерін алу үшін пайдалы болуы мүмкін.
`event.stopImmediatePropagation`	Элементке байланысты оқиға өңдегіштерінің қалған бөлігінің жұмысын тоқтатады және оқиғаның DOM ағашы бойынша жоғары көтерілуін болдырмайды. Оқиғаның ата-тегі элементтеріне көтерілуін болдырмау үшін, бірақ басқа оқиға өңдегіштерінің жұмысына рұқсат ету үшін, `event.stopPropagation` әдісін пайдалануға болады. `event.stopImmediatePropagation` бұл оқиға нысаны үшін шақырылған ба жоқты тексеру үшін `event.isImmediatePropagationStopped` әдісін пайдаланыңыз.
`event.stopPropagation`	Оқиғаның DOM ағашы бойынша жоғары көтерілуін болдырмайды. Басқа өңдегіштердің осы элемент үшін жұмысын жалғастыратынын есіңізде сақтаңыз. Бұл әдіс `trigger` әдісі арқылы шақырылған өз оқиғалары үшін жұмыс істейді. Бұл әдіс шақырылған ба жоқты тексеру үшін `event.isPropagationStopped` пайдаланыңыз.
`event.target`	Оқиғаны бастаған DOM элементі. Бұл оқиғаға тіркелген элемент немесе оның ұрпағы болуы мүмкін. `event.target` және `this`-ті салыстыру оқиғаның көтерілуін анықтау үшін өте пайдалы. Оқиға көтерілген кезде оқиғаны тапсыру кезінде бұл қасиет пайдалы.
`event.timeStamp`	Оқиғаны браузер жасаған сәт пен 1970 жылдың 1 Қаңтары арасындағы уақыт айырмашылығы миллисекундпен. Бұл қасиет кодтағы екі уақыт сәті үшін `event.timeStamp` мәндерінің айырмашылығын алу арқылы оқиға өнімділігін анықтауда пайдалы болуы мүмкін. Егер сіз оқиға өңдегішінде ағымдағы уақытты алуды қаласаңыз, `getTime` әдісін пайдаланыңыз.
`event.type`	Бұл қасиетте оқиға түрі көрсетілген.
`event.which`	Бұл қасиет пернетақтаның немесе тінтуірдің қай түймесі басылғанын көрсетеді. Тінтуір үшін: `1` - сол түйме, `2` - дөңгелек, `3` - оң түйме. `event.button` орнына `event.which` пайдаланыңыз.

Event нысанының басқа қасиеттері

event нысанына көшірілетін тағы басқа қасиеттер бар:

altKey, button, buttons, cancelable, char, charCode, clientX, clientY, ctrlKey, detail, eventPhase, key, keyCode, offsetX, offsetY, originalTarget, screenX, screenY, shiftKey, toElement, view.

Жоғарыда тізімделмеген қасиеттерге қол жеткізу үшін, event.originalEvent нысанын пайдалануға болады.

Мысал

Дивке қай түймелер басылғанын шығарайық:

<input id="test" value="type something">
<div id="text"></div>

$('#test').on('keydown', function(event) {
	$('#text').html(event.type + ": " +  event.which);
});

Мысал

Дивге біз қай тегті басатынымызды шығарайық:

<body>
	<div id="text"></div>
	<div>
		<p>
			<strong><span>click</span></strong>
		</p>
	</div>
</body>

span, strong, p {
	display: block;
	padding: 10px;
	border: 1px solid black;
}

$('body').click(function(event) {
	$('#text').html('clicked: ' + event.target.nodeName);
});

Сондай-ақ қараңыз

on әдісі,
ол элементке оқиға өңдегішін байлауға мүмкіндік береді
trigger әдісі,
ол элементке берілген түрдегі оқиғалар үшін байланыстырылған барлық оқиға өңдегіштерін іске қосуға мүмкіндік береді
triggerHandler әдісі,
ол элементке байланыстырылған барлық оқиға өңдегіштерін іске қосуға мүмкіндік береді
jQuery оқиғалары