InputEvent#

new InputEvent()#

Interfejs InputEvent może być wywoływany w roli konstruktora, dzięki czemu pozwala na bezpośrednie tworzenie nowych zdarzeń wejścia (syntetycznych) wprost z interfejsu. Przy tworzeniu nowego zdarzenia od razu ustalany jest jego typ (pierwszy argument) oraz specyficzne cechy ustawiane za pomocą opcjonalnego słownika InputEventInit (drugi argument).

Składnia#

Samo wywołanie i poszczególne jego części najlepiej objaśnić na zapisie składniowym:

  1. —
  2. L
  3. K
  4. T'
  5. T
  6. A
  7. O
  8. Z'
  9. Z
  10. #
var new_inputEvent = new InputEvent(type [, inputEventInitDict]);

gdzie poszczególne człony oznaczają:

Algorytm wywołania konstruktora new InputEvent(type, inputEventInitDict) nie jest skomplikowany. Dla lepszego zrozumienia tematu prezentuję go w całości:

  1. Zwróć nowe zdarzenie wejścia za pomocą algorytmu tworzenia zdarzenia z typem type i słownikiem inputEventInitDict (jeśli występuje).

Obiekt zwracany przez konstruktor new InputEvent() implementuje interfejs InputEvent, dlatego ma dostęp do wszystkich poleceń z tego interfejsu (oraz z kolejnych interfejsów w łańcuchu dziedziczenia). Warto podkreślić, że i opcjonalny słownik InputEventInit dziedziczy ze słownika UIEventInit, dlatego ma dostęp do wszystkich jego członków w chwili przekazania do konstruktora.

Nowy obiekt zdarzenia będzie miał ustawiane domyślne wartości dla wszystkich swoich właściwości i dodatkowo zostanie automatycznie zainicjowany zgodnie z przekazanymi argumentami przy jego wywołaniu, w przeciwieństwie do polecenia Document.createEvent(), dlatego może być od razu wysłany za pomocą metody EventTarget.dispatchEvent().

W ramach uzupełnienia warto przeanalizować wady i zalety poszczególnych poleceń odpowiedzialnych za tworzenie niezaufanych zdarzeń.

Ze względów bezpieczeństwa zdarzenia generowane przy użyciu konstruktora new InputEvent() muszą ustawiać wartość właściwości Event.isTrusted na boolowskie false.

Prosty przykład:

  1. —
  2. L
  3. K
  4. T'
  5. T
  6. A
  7. O
  8. Z'
  9. Z
  10. #
<script>

	// Tworzymy nowe zdarzenie
	var inputEvent1 = new InputEvent("piesek");

	document.write(inputEvent1); // [object UIEvent]
	document.write("<br>");
	document.write(inputEvent1.type); // piesek
	document.write("<br>");
	document.write(inputEvent1.bubbles); // false
	document.write("<br>");
	document.write(inputEvent1.cancelable); // false
	document.write("<br>");
	document.write(inputEvent1.view); // null
	document.write("<br>");
	document.write(inputEvent1.detail); // 0
	document.write("<br>");
	document.write(inputEvent1.data); // 0
	document.write("<br>");
	document.write(inputEvent1.isComposing); // false
	document.write("<br>");
	document.write(inputEvent1.defaultPrevented); // false
	document.write("<br>");
	document.write(inputEvent1.isTrusted); // false
	document.write("<br>");
	document.write(inputEvent1.eventPhase); // 0
	document.write("<br>");
	document.write(inputEvent1.timeStamp); // liczba całkowita z wartością zależną od chwili uruchomienia przykładu
	document.write("<br>");
	document.write(inputEvent1.currentTarget); // null
	document.write("<br>");
	document.write(inputEvent1.target); // null

	document.write("<br><br>");

	// Tworzymy kolejne zdarzenie
	var inputEvent2 = new InputEvent("piesek", {
		bubbles: true,
		cancelable: true,
		view: window,
		detail: 69,
		data: "husky",
		isComposing: true
	});

	document.write(inputEvent2); // [object UIEvent]
	document.write("<br>");
	document.write(inputEvent2.type); // piesek
	document.write("<br>");
	document.write(inputEvent2.bubbles); // true
	document.write("<br>");
	document.write(inputEvent2.cancelable); // true
	document.write("<br>");
	document.write(inputEvent2.view); // [object Window]
	document.write("<br>");
	document.write(inputEvent2.detail); // 69
	document.write("<br>");
	document.write(inputEvent2.data); // "husky"
	document.write("<br>");
	document.write(inputEvent2.isComposing); // true
	document.write("<br>");
	document.write(inputEvent2.defaultPrevented); // false
	document.write("<br>");
	document.write(inputEvent2.isTrusted); // false
	document.write("<br>");
	document.write(inputEvent2.eventPhase); // 0
	document.write("<br>");
	document.write(inputEvent2.timeStamp); // liczba całkowita z wartością zależną od chwili uruchomienia przykładu
	document.write("<br>");
	document.write(inputEvent2.currentTarget); // null
	document.write("<br>");
	document.write(inputEvent2.target); // null

</script>

Na chwilę obecną jedynie przeglądarka Firefox zaimplementowała interfejs InputEvent i pozwala na jego wywoływanie w roli konstruktora, aczkolwiek bez obsługi właściwości data ze słownika InputEventInit.

Interfejs Web IDL#

  1. —
  2. L
  3. K
  4. T'
  5. T
  6. A
  7. O
  8. Z'
  9. Z
  10. #
[Constructor(DOMString type, optional InputEventInit inputEventInitDict)]
interface InputEvent : UIEvent {
};

dictionary InputEventInit : UIEventInit {
	DOMString data = "";
	boolean isComposing = false;
};

Specyfikacje i inne materiały#

Pasek społecznościowy

SPIS TREŚCI AKTUALNEJ STRONY

InputEvent (H1) new InputEvent() (H2) Składnia (H3) Interfejs Web IDL (H3) Specyfikacje i inne materiały (H3)