Objek Event XML DOM
- Halaman Sebelumnya DOM Element
- Halaman Berikutnya DOM HTMLCollection
Objek Event mewakili informasi tentang peristiwa.
Objek Event
Properti objek Event menyediakan detil tentang peristiwa (contohnya, elemen tempat peristiwa terjadi). Metode objek Event dapat mengendalikan penyebaran peristiwa.
Standar DOM Events tingkat 2 mendefinisikan model peristiwa standar, yang diimplementasikan selain IE oleh semua peramban modern, sementara IE mendefinisikan model yang berbeda dan tak kompatibel. Halaman referensi ini menampilkan properti objek Event standar serta properti objek Event IE.
Perhatian:Dalam model peristiwa standar, objek Event disampaikan ke fungsi penanganan peristiwa; tetapi dalam model peristiwa IE, ia disimpan di properti event objek Window.
Dalam model peristiwa standar, berbagai subinterface Event mendefinisikan properti ekstra, yang menyediakan detil yang berhubungan dengan jenis peristiwa tertentu. Dalam model peristiwa IE, hanya ada satu jenis objek Event, yang digunakan untuk semua jenis peristiwa.
Properti Event Standar
Berikut adalah properti yang didefinisikan dalam standar DOM peristiwa tingkat 2.
Properti | Deskripsi | IE | F | O | W3C |
---|---|---|---|---|---|
bubbles | Mengembalikan nilai boolean, menunjukkan apakah peristiwa adalah jenis peristiwa yang menggelombang. | Tidak | 1 | 9 | Ya |
cancelable | Mengembalikan nilai boolean, menunjukkan apakah peristiwa dapat membatalkan tindakan standar. | Tidak | 1 | 9 | Ya |
currentTarget | Mengembalikan elemen yang mengaktifkan penanganan peristiwa saat ini. | Tidak | 1 | 9 | Ya |
eventPhase | Mengembalikan tahap penyebaran peristiwa saat ini. | Ya | |||
target | Mengembalikan elemen yang memicu peristiwa (nod target peristiwa). | Tidak | 1 | 9 | Ya |
timeStamp | Mengembalikan tanggal dan waktu yang dihasilkan oleh peristiwa. | Tidak | 1 | 9 | Ya |
type | Mengembalikan nama peristiwa yang diwakili oleh objek Event saat ini. | 6 | 1 | 9 | Ya |
Metode Event Standar
Berikut adalah metode yang didefinisikan dalam standar DOM peristiwa tingkat 2. Model peristiwa IE tidak mendukung metode ini:
Metode | Deskripsi | IE | F | O | W3C |
---|---|---|---|---|---|
initEvent() | Menginisialisasi properti objek Event yang baru dibuat. | Tidak | 1 | 9 | Ya |
preventDefault() | Beritahu peramban untuk tidak melaksanakan tindakan standar yang berhubungan dengan peristiwa. | Tidak | 1 | 9 | Ya |
stopPropagation() | Penghentian peristiwa untuk menyebar lebih jauh dalam proses penangkapan, penanganan target, atau tahap balasan, setelah memanggil metode ini, program penanganan peristiwa yang ada di node ini akan dipanggil, dan peristiwa tidak lagi disampaikan ke node lain. | Tidak | 1 | 9 | Ya |
Properti IE
IE tidak mendukung (setidaknya di IE 7) model peristiwa DOM standar, dan objek Event IE mendefinisikan set properti yang sangat berbeda.
Model peristiwa IE tidak mendefinisikan tingkat turunan untuk berbagai jenis peristiwa, sehingga semua properti yang berhubungan dengan jenis peristiwa apapun disiarkan di sini.
Properti | Deskripsi |
---|---|
cancelBubble | Jika handler peristiwa ingin mencegah penyebaran peristiwa ke objek pengelompokan, properti ini harus diatur menjadi true. |
fromElement | Untuk peristiwa mouseover dan mouseout, fromElement merujuk kepada elemen yang keluar dari mouse. |
keyCode |
Untuk peristiwa keypress, properti ini menyatakan kode karakter Unicode yang dihasilkan dari tombol yang ditekan. Untuk peristiwa keydown dan keyup, ia menentukan kode papan virtual yang ditekan. Kode papan virtual mungkin berhubungan dengan tata letak papan tik yang digunakan. |
offsetX,offsetY | Lokasi peristiwa dalam sistem koordinat elemen sumber peristiwa. |
returnValue |
Jika properti ini disetel, nilai yang diambil prioritas tinggi daripada nilai kembalian handler peristiwa. Mengatur properti ini menjadi false dapat menghapus tindakan baku elemen sumber peristiwa yang terjadi. |
srcElement | Untuk referensi ke objek Window, Document, atau Element yang menghasilkan peristiwa. |
toElement | Untuk peristiwa mouseover dan mouseout, properti ini merujuk kepada elemen yang masuk ke mouse. |
x,y | Koordinat x dan y tempat peristiwa terjadi, yang berada di dalam elemen pengelompokan paling dalam yang diposisikan secara dinamis dengan CSS. |
- Halaman Sebelumnya DOM Element
- Halaman Berikutnya DOM HTMLCollection