DOM:element.dispatchEvent

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

« Dokumentacja Gecko DOM

Spis treści 1 Podsumowanie 2 Składnia 3 Przykład 4 Uwagi 5 Specyfikacja

[edytuj] Podsumowanie

Wywołuje zdarzenie w bieżącym elemencie.

[edytuj] Składnia

bool = element.dispatchEvent(event)

• event to obiekt zdarzenia, które ma zostać wywołane.
• Jeśli któraś z funkcji obsługujących to zdarzenie wywoła preventDefault, zwracana wartość to false. W przeciwnym przypadku zwracane jest true.

[edytuj] Przykład

Poniższy przykład przedstawia symulację kliknięcia w pole wyboru opartą o metody DOM. Możesz zobaczyć przykład w działaniu.

function simulateClick() {
  var evt = document.createEvent("MouseEvents");
  evt.initMouseEvent("click", true, true, window,
    0, 0, 0, 0, 0, false, false, false, false, 0, null);
  var cb = document.getElementById("checkbox"); 
  var canceled = !cb.dispatchEvent(evt);
  if(canceled) {
    // metoda obsługi zdarzenia wywołała preventDefault
    alert("canceled");
  } else {
    // nie wywołano preventDefault
    alert("not canceled");
  }
}

[edytuj] Uwagi

Jak pokazuje powyższy przykład, dispatchEvent to ostatni krok w procesie utwórz-zainicjuj-wywołaj, którego używa się by ręcznie wywołać zdarzenia w modelu zdarzeń implementacji.

Zdarzenie może zostać utworzone przy użyciu metody document.createEvent i zainicjowane za pomocą initEvent lub innej, bardziej wyspecjalizowanej metody, jak initMouseEvent albo initUIEvent.

Zobacz też dokumentację obiektu event.

[edytuj] Specyfikacja

DOM Level 2 Events: dispatchEvent