Event objekt

Objekt event genereeritakse sündmuse toimumisel ja sisaldab selle kohta teavet. Sündmuse ilmnemisel edastatakse objekt event töötlejafunktsiooni.

Objekti event omadused ja meetodid

Allpool tabelis on toodud objekti event omadused ja meetodid ning nende kirjeldus:

Nimi	Kirjeldus
`event.currentTarget`	Praegune DOM element sündmuse levimise etapis. Tavaliselt on see omadus samaväärne `this` funktsiooniga.
`event.data`	Valikuline parameeter. Andmete objekt, mis edastatakse sündmuse meetodile käivitatava töötleja manustamisel.
`event.delegateTarget`	Element, kuhu oli just kutsutud jQuery sündmustöötleja manustatud. See omadus on kõige kasulikum delegeeritud sündmustes, kui töötleja on seotud töödeldava elemendi eellasega. Mitte-delegeeritud töötlejate puhul, mis on otse elemendiga seotud, väärtus `event.delegateTarget` vastab väärtusele `event.currentTarget`.
`event.isDefaultPrevented`	Meetod kontrollib, kas meetodit `event.preventDefault` on kutsutud selle sündmusobjekti jaoks.
`event.isImmediatePropagationStopped`	Meetod kontrollib, kas meetodit `event.stopImmediatePropagation` on kutsutud selle sündmusobjekti jaoks.
`event.isPropagationStopped`	Meetod kontrollib, kas meetodit `event.stopPropagation` on kutsutud selle sündmusobjekti jaoks.
`event.isPropagationStopped`	Meetod kontrollib, kas meetodit `event.stopPropagation` on kutsutud selle sündmusobjekti jaoks.
`event.metaKey`	Meetod kontrollib, kas klahvi `META` oli vajutatud sündmuse toimumise hetkel. Sõltuvalt platvormist võib klahv erineda. Tagastab `true` või `false`.
`event.namespace`	Nimeruum, mis määrati sündmuse kutsumise hetkel. See omadus võib osutuda kasulikuks pluginate autoritele, kelle ülesanded sõltuvad kasutatavast nimeruumist.
`event.pageX`	Näitab hiire asukohta dokumendi vasakust servast.
`event.pageY`	Näitab hiire asukohta dokumendi ülemisest servast.
`event.preventDefault`	Kui see meetod on kutsutud, siis vaikimisi tegevus selle sündmuse jaoks ei teostata. Näiteks lingile klõpsamine ei vii uuele URL-ile. Selleks, et kontrollida, kas see meetod on kutsutud, saab kasutada meetodit `event.isDefaultPrevented`.
`event.relatedTarget`	Tagastab teise DOM elemendi, mis osaleb sündmuses, kui selline on olemas. `mouseout` jaoks näitab, millisele elemendile hiir on suunatud, `mouseover` jaoks, milliselt elemendilt hiirekursor eemaldati.
`event.result`	Viimane väärtus, mille tagastas töötleja toimunud sündmusele, mis ei võrdu `undefined`. Omadus võib olla kasulik oma sündmuste väärtuste saamiseks.
`event.stopImmediatePropagation`	Tühistab kõigi ülejäänud sündmustöötlejate töö, mis on seotud elemendiga, ja takistab sündmuse levimise ülespoole DOM puus. Selleks, et lihtsalt keelata sündmusel levida eellaselementideni, kuid lubada teistel sündmustöötlejatel töötada, saab kasutada meetodit `event.stopPropagation`. Kasutage meetodit `event.isImmediatePropagationStopped`, et kontrollida, kas `event.stopImmediatePropagation` on kutsutud selle sündmusobjekti jaoks.
`event.stopPropagation`	Takistab sündmuse levimist ülespoole DOM puus. Pidage meeles, et teised töötlejad jätkavad tööd selle elemendi jaoks. See meetod töötab kohandatud sündmuste jaoks, mida on käivitatud meetodi abil `trigger`. Selleks, et kontrollida, kas see meetod on kutsutud, kasutage `event.isPropagationStopped`.
`event.target`	DOM element, mis käivitas sündmuse. See võib olla sündmuse jaoks registreeritud element või selle järeltulija. On väga kasulik võrrelda `event.target` ja `this`, et määrata sündmuse levimist. Omadus on kasulik sündmuse delegeerimisel, kui sündmused levivad.
`event.timeStamp`	Ajavahe millisekundites sündmuse loomise hetke brauseris ja 1. jaanuari 1970 vahel. Omadus võib olla kasulik sündmuse jõudluse määramisel, saades kahe ajahetke väärtuste erinevuse `event.timeStamp` koodis. Kui soovite lihtsalt saada praegust aega töötleja sees, kasutage meetodit `getTime`.
`event.type`	Selles omaduses on märgitud sündmuse tüüp.
`event.which`	See omadus näitab, millist klaviatuuri või hiire klahvi vajutati. Hiire puhul: `1` - vasak klõps, `2` - kerimisratas, `3` - parem klõps. Kasutage `event.which` asemel `event.button`.

Muud objekti event omadused

On ka teisi omadusi, mida kopeeritakse objekti event:

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

Et pääseda juurde ülal loetlemata omadustele, saab kasutada objekti event.originalEvent.

Näide

Väljastame div-i - milliseid klahve vajutati:

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

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

Näide

Väljastame div-i - millisele sildile me klõpsame:

<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);
});

Vaata ka

meetod on,
mis võimaldab siduda sündmustöötleja elemendiga
meetod trigger,
mis võimaldab käivitada kõik sündmustöötlejad, mis on seotud elemendiga etteantud tüüpi sündmuste jaoks
meetod triggerHandler,
mis võimaldab käivitada kõik sündmustöötlejad, mis on seotud elemendiga
jQuery sündmused