Objekti event

Objekti event gjenerohet kur ndodh një ngjarje dhe përmban informacione rreth saj. Kur shfaqet ngjarja, objekti event kalohet në funksionin përpunues.

Vetitë dhe metodat e objektit event

Më poshtë në tabelë janë treguar vetitë dhe metodat e objektit event dhe përshkrimi i tyre:

Emri	Përshkrimi
`event.currentTarget`	Elementi aktual DOM në fazën e shfryrjes së ngjarjes. Zakonisht kjo veti është ekuivalente me `this` të funksionit.
`event.data`	Parametër jo i detyrueshëm. Objekti i të dhënave, i transmetuar në metodën e ngjarjes kur lidhet përpunuesi i ekzekutueshëm.
`event.delegateTarget`	Elementi të cilit i ishte lidhur sapo thirrur përpunuesi i ngjarjes jQuery. Kjo veti është më e dobishme në ngjarjet e deleguara, kur përpunuesi është i lidhur me një paraardhës të elementit që përpunohet. Për përpunuesit jo të deleguar, të lidhur direkt me elementin, vlera e `event.delegateTarget` korrespondon me vlerën e `event.currentTarget`.
`event.isDefaultPrevented`	Metoda kontrollon nëse është thirrur metoda `event.preventDefault` për këtë objekt ngjarjeje.
`event.isImmediatePropagationStopped`	Metoda kontrollon nëse është thirrur metoda `event.stopImmediatePropagation` për këtë objekt ngjarjeje.
`event.isPropagationStopped`	Metoda kontrollon nëse është thirrur metoda `event.stopPropagation` për këtë objekt ngjarjeje.
`event.isPropagationStopped`	Metoda kontrollon nëse është thirrur metoda `event.stopPropagation` për këtë objekt ngjarjeje.
`event.metaKey`	Metoda kontrollon nëse ishte shtypur tastiera `META` në momentin e ndodhjes së ngjarjes. Në varësi të platformës, tastiera mund të ndryshojë. Kthen `true` ose `false`.
`event.namespace`	Hapësira e emrave, e specifikuar në momentin e thirrjes së ngjarjes. Kjo veti do të jetë e dobishme për autorët e shtojcave, detyrat e të cilëve varen nga hapësira e emrave e përdorur.
`event.pageX`	Tregon pozicionin e miut në lidhje me skajin e majtë të dokumentit.
`event.pageY`	Tregon pozicionin e miut në lidhje me skajin e sipërm të dokumentit.
`event.preventDefault`	Nëse kjo metodë thirret, atëherë veprimi parazgjedhur për këtë ngjarje nuk do të ekzekutohet. Për shembull, klikimi në një lidhje nuk do të çojë në një URL të re. Për të kontrolluar nëse është thirrur kjo metodë, mund të përdorni metodën `event.isDefaultPrevented`.
`event.relatedTarget`	Kthen një element tjetër DOM që merr pjesë në ngjarje, nëse ka të tillë. Për `mouseout` tregon në cilin element është vendosur miu, për `mouseover` nga cili element kursori i miut ishte larguar.
`event.result`	Vlera e fundit, që u kthye nga përpunuesi i ngjarjes së shkaktuar, jo e barabartë me `undefined`. Veti mund të jetë e dobishme për marrjen e vlerave të ngjarjeve të veta.
`event.stopImmediatePropagation`	Anulon punën e të gjithë përpunuesve të mbetur të ngjarjeve, të lidhur me elementin dhe parandalon shfryrjen e ngjarjes lart në pemën DOM. Për të ndaluar thjesht ngjarjen të shfryhet deri te elementët paraardhës, por për të lejuar punën e përpunuesve të tjerë të ngjarjeve, mund të përdorni metodën `event.stopPropagation`. Përdorni metodën `event.isImmediatePropagationStopped`, për të kontrolluar nëse është thirrur `event.stopImmediatePropagation` për këtë objekt ngjarjeje.
`event.stopPropagation`	Parandalon shfryrjen e ngjarjes lart në pemën DOM. Mbani mend se përpunuesit e tjerë do të vazhdojnë të punojnë për këtë element. Kjo metodë funksionon për ngjarjet e veta, të shkaktuara duke përdorur metodën `trigger`. Për të kontrolluar nëse është thirrur kjo metodë, përdorni `event.isPropagationStopped`.
`event.target`	Elementi DOM që nisi ngjarjen. Ky mund të jetë elementi i regjistruar për ngjarjen ose pasardhësi i tij. Është shumë e dobishme të krahasohen `event.target` dhe `this`, për të përcaktuar shfryrjen e ngjarjes. Veti është e dobishme kur delegohet ngjarja, kur ngjarjet shfryhen.
`event.timeStamp`	Diferenca në kohë në milisekonda midis momenteve të krijimit të ngjarjes nga shfletuesi dhe 1 Janar 1970. Veti mund të jetë e dobishme kur përcaktohet performanca e një ngjarje duke marrë diferencën e vlerave `event.timeStamp` për dy momente kohe në kod. Nëse thjesht dëshironi të merrni kohën aktuale brenda përpunuesit të ngjarjes, përdorni metodën `getTime`.
`event.type`	Në këtë veti specifikohet lloji i ngjarjes.
`event.which`	Kjo veti tregon se cila tastierë e tastierës ose e miut ishte shtypur. Për miun: `1` - butoni i majtë, `2` - rrota, `3` - butoni i djathtë. Përdorni `event.which` në vend të `event.button`.

Veti të tjera të objektit event

Ka edhe veti të tjera, të cilat kopjohen në objektin event:

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

Për të pasur qasje në vetitë, të pa listuara më sipër, mund të përdorni objektin event.originalEvent.

Shembull

Le të shfaqim në div - cilat taste janë shtypur:

<input id="test" value="shkruaj diçka">
<div id="text"></div>

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

Shembull

Le të shfaqim në div - në cilin tag do të klikojmë:

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

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

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

Shihni gjithashtu

metoda on,
e cila lejon lidhjen e një përpunuesi ngjarjesh me një element
metoda trigger,
e cila lejon nisjen e të gjithë përpunuesve të ngjarjeve, të lidhur me elementin për ngjarjet e llojit të caktuar
metoda triggerHandler,
e cila lejon nisjen e të gjithë përpunuesve të ngjarjeve, të lidhur me elementin
ngjarjet jQuery