Objek event

Objek event dihasilkan ketika suatu peristiwa terjadi dan berisi informasi tentangnya. Ketika peristiwa muncul, objek event diteruskan ke fungsi penangan.

Properti dan metode objek event

Di bawah ini dalam tabel ditunjukkan properti dan metode objek event dan deskripsinya:

Nama	Deskripsi
`event.currentTarget`	Elemen DOM saat ini pada tahap bubbling peristiwa. Biasanya properti ini setara dengan `this` fungsi.
`event.data`	Parameter opsional. Objek data yang diteruskan ke metode peristiwa saat melampirkan penangan yang dapat dieksekusi.
`event.delegateTarget`	Elemen tempat penangan peristiwa jQuery yang baru saja dipanggil dilampirkan. Properti ini paling berguna dalam peristiwa delegated, ketika penangan terikat ke elemen leluhur dari elemen yang ditangani. Untuk penangan non-delegated yang terikat langsung ke elemen, nilai `event.delegateTarget` sesuai dengan nilai `event.currentTarget`.
`event.isDefaultPrevented`	Metode memeriksa apakah metode `event.preventDefault` telah dipanggil untuk objek peristiwa ini.
`event.isImmediatePropagationStopped`	Metode memeriksa apakah metode `event.stopImmediatePropagation` telah dipanggil untuk objek peristiwa ini.
`event.isPropagationStopped`	Metode memeriksa apakah metode `event.stopPropagation` telah dipanggil untuk objek peristiwa ini.
`event.isPropagationStopped`	Metode memeriksa apakah metode `event.stopPropagation` telah dipanggil untuk objek peristiwa ini.
`event.metaKey`	Metode memeriksa apakah tombol `META` ditekan saat peristiwa terjadi. Bergantung pada platform, tombol dapat berbeda. Mengembalikan `true` atau `false`.
`event.namespace`	Namespace yang ditentukan saat peristiwa dipanggil. Properti ini akan berguna untuk penulis plugin, yang tugasnya bergantung pada namespace yang digunakan.
`event.pageX`	Menunjukkan posisi mouse relatif terhadap sisi kiri dokumen.
`event.pageY`	Menunjukkan posisi mouse relatif terhadap sisi atas dokumen.
`event.preventDefault`	Jika metode ini dipanggil, maka tindakan default untuk peristiwa ini tidak akan dilakukan. Misalnya, mengklik tautan tidak akan mengarah ke URL baru. Untuk memeriksa apakah metode ini telah dipanggil, dapat menggunakan metode `event.isDefaultPrevented`.
`event.relatedTarget`	Mengembalikan elemen DOM lain yang terlibat dalam peristiwa, jika ada. Untuk `mouseout` menunjukkan ke elemen mana mouse diarahkan, untuk `mouseover` dari elemen mana kursor mouse dialihkan.
`event.result`	Nilai terakhir yang dikembalikan oleh penangan peristiwa yang dipicu, yang tidak sama dengan `undefined`. Properti dapat berguna untuk mendapatkan nilai dari peristiwa kustom.
`event.stopImmediatePropagation`	Membatalkan semua penangan peristiwa yang tersisa yang terkait dengan elemen dan mencegah peristiwa bubbling naik ke pohon DOM. Untuk hanya melarang peristiwa bubbling hingga elemen leluhur, tetapi mengizinkan penangan peristiwa lain berjalan, dapat menggunakan metode `event.stopPropagation`. Gunakan metode `event.isImmediatePropagationStopped` untuk memeriksa apakah `event.stopImmediatePropagation` telah dipanggil untuk objek peristiwa ini.
`event.stopPropagation`	Mencegah peristiwa bubbling naik ke pohon DOM. Ingat bahwa penangan lain akan terus bekerja untuk elemen ini. Metode ini bekerja untuk peristiwa kustom, yang dipicu dengan metode `trigger`. Untuk memeriksa apakah metode ini telah dipanggil, gunakan `event.isPropagationStopped`.
`event.target`	Elemen DOM yang memulai peristiwa. Ini bisa menjadi elemen yang terdaftar untuk peristiwa atau keturunannya. Sangat berguna untuk membandingkan `event.target` dan `this`, untuk menentukan bubbling peristiwa. Properti berguna saat mendelegasikan peristiwa, ketika peristiwa bubbling.
`event.timeStamp`	Perbedaan waktu dalam milidetik antara momen pembuatan peristiwa oleh browser dan 1 Januari 1970. Properti dapat berguna untuk menentukan kinerja peristiwa dengan mendapatkan perbedaan nilai `event.timeStamp` untuk dua momen waktu dalam kode. Jika Anda hanya ingin mendapatkan waktu saat ini di dalam penangan peristiwa, gunakan metode `getTime`.
`event.type`	Dalam properti ini ditunjukkan jenis peristiwa.
`event.which`	Properti ini menunjukkan tombol keyboard atau mouse mana yang ditekan. Untuk mouse: `1` - tombol kiri, `2` - roda scroll, `3` - tombol kanan. Gunakan `event.which` alih-alih `event.button`.

Properti objek event lainnya

Ada juga properti lain yang disalin ke objek event:

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

Untuk mengakses properti yang tidak tercantum di atas, dapat menggunakan objek event.originalEvent.

Contoh

Mari kita tampilkan di div - tombol mana yang ditekan:

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

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

Contoh

Mari kita tampilkan di div - tag mana yang kita klik:

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

Lihat juga

metode on,
yang memungkinkan untuk mengikat penangan peristiwa ke elemen
metode trigger,
yang memungkinkan untuk menjalankan semua penangan peristiwa, terikat ke elemen untuk peristiwa dari jenis yang ditentukan
metode triggerHandler,
yang memungkinkan untuk menjalankan semua penangan peristiwa, terikat ke elemen
peristiwa jQuery