Javascript addEventListener • Event Handler registrieren

Mit addEventListener gibt uns das DOM eine zentrale Funktion, bei der wir Events und die dazugehörigen Aktionen registrieren.

Der Event Listener reagiert auf Events für window, für document oder individuelle Elemente der Webseite.

addEventListener registriert Events wie das Laden der Webseite, den Klick auf ein Element oder die Antwort auf einen XMLHttpRequest und ruft eine Funktion auf, sobald das Ereigniss stattfindet. Mit addEventListener können theoretisch beliebig viele Events für ein Element angemeldet werden.

Event Listener des DOM
elem.addEventListener(eventType,   <-- EventType (z.B. click, touch 
                                       o. mouseover)
                      handler,     <-- aufzurufende Funktion
                      useCapture); <-- Phase der Aktivierung

Der Handler ist im einfachsten Fall eine Javascript-Funktion, in der die Aktionen durchgeführt werden.

<div id="elem"> … </div>

var elem = document.getElementById('elem');
elem.addEventListener ('click', showElem, true);

function showElem() { … }

addEventListener mit Argumenten

Wenn der Event Handler Argumente braucht, muss er als anonyme Funktion in den Aufruf der Funktion addEventListener geschrieben werden.

elem.addEventListener ('click', 
      function() {showElem(param1, param2)}, 
      false);

function showElem(p1, p2) { … }

attachEvent in IE8 und älter

In den älteren Version von IE gibt es anstelle des Event Listeners eine ähnliche Methode, die ein Element auf ein Event vorbereitet – attachEvent – mit ebenfalls ähnlichen Argumenten.

elem.attachEvent (event,    <-- EventType (z.B. click 
                                  o. mouseover)
                  handler); <-- aufzurufende Funktion

In IE6, IE7 und IE8 muss das Ereigniss mit "on" beginnen. Das dritte Argument useCapture entfällt, da diese Versionen von IE nur Event-Bubbling implementiert.

Ab IE9 unterstützt Internet Explorer dann den EventListener des W3C.

Event Handler vom Ereigniss entbinden

Zu addEventListener / attachEvent gibt es ein Gegenstück removeEventListener bzw detachEvent, das den Event Handler wieder vom Event entbindet:

elem.removeEventListener(eventType, handler, useCapture);

elem.detachEvent(event, handler);     

Cross-Browser-Registrierung

Die Konzepte des Event Listeners bzw. attachEvent sind sich ähnlich genug, um die Differenzen unter einer einfachen Funktion zu verstecken. Ein Script prüft, welches der beiden Konzepte vom Browser unterstützt wird – addEventListener vom W3C oder attachEvent in IE.

function myfunc() {
   …
}
if (window.addEventListener) 
    window.addEventListener("load", myfunc);

else if (window.attachEvent) 
   window.attachEvent("onload", myfunc);

else window.onload = myfunc;

capture oder bubble?

Wenn sowohl ein Element als auch Vorfahren des Elements für ein Ereignis registriert sind, erreicht das Event zuerst den Vorfahren und wandert dann zu den Nachkommen? Oder wird das Ereignis zuerst an das Element und dann an die Vorfahren gemeldet?

Der dritte Parameter der Funktion – useCapture – legt fest, in welcher Phase ein Ereignis den Beobachter aktiviert.

Capture
true (default) Zuerst die Event Handler von Vorfahren aufrufen, dann erst den Event Handler des Elements
Bubble
false Zuerst den Event Handler des Elements aufrufen, erst dann die Event Handler von Vorfahren

Aus der Sicht des DOM 2 reist ein Ereignis in einer Capture-Phase von der Wurzel des Dokuments zu seinem Ziel. Wenn es die Art des Ereignisses erlaubt, steigt das Ereignis in einer Bubbling-Phase wie eine Wasserblase durch den Baum zurück nach oben. Dabei kann jeder Knoten auf dem Weg von der Wurzel des Dokuments zum Zielknoten – dem EventTarget-Objekt – ein Beobachter sein, den das Ereignis beim Passieren in einer der beiden Phasen aktiviert.

EventListener EventListener EventListener capturing bubbling root node node EventTarget node node node EventTarget

Wenn ein Skript Ereignisse auf verschachtelten HTML-/XML-Elementen registriert, die auf dasselbe Ereigniss warten, führt der Broswer beim Bubbling die innerste Registrierung zuerst aus und arbeitet sich dann nach oben vor. Beim Capturing behandelt der Browser das Ereignis auf dem Weg »nach unten«.

<div>
    <p><a href="" … >Lorem Ipsum    </a></p>
</div>
Capturing

Klick

Bubbling

Klick


Ein Klick auf eines der inneren Element zeigt, in welcher Reihenfolge das Klick-Ereignis aufgenommen wird: von oben nach unten oder von unten nach oben. Das Beispiel funktioniert nicht in IE 6 / IE 7 / IE 8, die das Konzept des Event Capturings nicht unterstützen.

Mozilla, Safari und Opera implementieren die Methode addEventListener des W3C seit 2001, mit Version 9 unterstützt nun auch IE9 Javascript addEventListener.

Wir ziehen heute die Capture-Phase vor. Für moderne Skripte macht es kaum Sinn, ein Event beim Aufsteigen (bubble) von mehreren Event Handlern behandeln zu lassen. Wenn wir auf ein Element klicken, erwarten wir eine Aktion. Darum wird jedes Event in einem eigenen Skript behandelt.

Also können wir den dritten Parameter meist fallen lassen – capture (true) ist der Default-Wert und der dritte Parameter ist optional.

stopPropagation

Zumeist werden sowohl bubble als auch capture ausgeschaltet, damit es nicht zu unvorhergesehenen Aktionen kommt. Dafür gibt es das stopPropagation() sowohl für die modernen Browser als auch für IE.

DOM: stopPropagation()
Stopt den Ereignis-Fluss. Kann entweder in der Capture- oder in der Bubble-Phase benutzt werden.
IE: stopPropagation()
In IE ist stopPropagation() keine Methode, sondern eine Boole'sche Eigenschaft, die auf true gesetzt wird, damit das Ereignis nicht aufsteigt (bubbling)

Das onload-Problem

An einem generellen Problem ändert auch der eventListener des W3C nichts: Sowohl mit addEventListener als auch mit attachEvent kann der Handler erst ausgeführt werden, wenn das Tag des Elements im Browser geladen wurde.

Die Funktion muss innerhalb einer Funktion aufgerufen werden, die von einem window.onload-Event Handler angestossen wurde, nachdem alle Elemente des Dokuments (das gesamte Markup, Style Sheets, Bilder und Plugins) geladen wurden.

Wird ein Ereignis-Handler registriert, bevor der Browser das HTML-Element geladen hat, kommt es zu einem JavaScript-Fehler: Das Objekt ist unbekannt.

Das Warten auf das Laden des Dokuments (mit sämtlichen Bilder, Plugins ... ) führt zu einer Verzögerung bis zum Skript-Aufruf.

Events mit jQuery

Dem Ärger mit verschiedenen Methoden zur Registrierung von Ereignissen und damit verbundenen Aktionen entgegnet die Javascript-Library jQuery mit einem Cross-Browser-Aufruf:

Skripte starten mit jQuery

$(document).ready(function() {
   // dieser Code wird ausgeführt, wenn das HTML-Dokument
   // geladen – also das DOM fertig aufgebaut – ist.
   $("h1").text("Das DOM ist geladen und kann durchquert werden");
});

$(document).ready(function() wartet nicht einmal, bis das gesamte Dokument im Browser geladen ist, sondern tritt bereits in Aktion, wenn das HTML-Dokument geladen ist und der DOM-Baum durchquert werden kann. Das ist kürzer als die Zeit bis zum vollständigen Laden aller Dokumente einer Webseite.

Dazu muss allerdings die jQuery-Library vor allen anderen Skripten in das Dokument geladen werden.