Diese Basisklasse definiert die on, onceund off Methoden von Objekten, die Ereignisse auslösen können.

Methoden

addEventListener(Typ, Listener, Kontext)

Parameter:

Abgelehnt — Verwendung on() oder einmal() stattdessen.

Mit dieser Methode wird eine Methode als Ereignisbehandler für ein bestimmtes Ereignis registriert.

Wenn für ein Ereignis kein Handler registriert ist, wird das Ereignis lokal ignoriert. Wenn die Ereignis-Listener-Funktion nicht existiert, wird das Ereignis lokal ignoriert.

Löst eine Ausnahme aus, wenn die listener Der Name ist ungültig.

Siehe: : - on() - einmal() - Veranstaltungen

off(Typ, Handler, Kontext) → {Object}

Entfernt einen oder mehrere Ereignis-Handler.

Wenn Sie einen Ereignisnamen und eine Handler-Methode übergeben, wird der Handler für dieses Ereignis entfernt:

obj.off("eventName", eventHandler);

Wenn Sie mehrere Ereignisnamen und eine Handler-Methode übergeben, wird der Handler für diese Ereignisse entfernt:

obj.off("eventName1 eventName2", eventHandler);

Wenn Sie einen Ereignisnamen (oder mehrere) übergeben und nein Handler-Methode werden alle Handler für diese Ereignisse entfernt:

obj.off("event1Name event2Name");

Wenn Sie keine Argumente übergeben, alle Ereignisbehandler werden für alle Ereignisse entfernt, die von dem Objekt ausgelöst werden:

obj.off();

Die Methode unterstützt auch eine alternative Syntax, bei der der erste Parameter ein Objekt ist, das aus einer Hash-Map mit Ereignisnamen und Handler-Funktionen besteht, und der zweite Parameter (optional) den Kontext für diesen in jedem Handler darstellt:

obj.off(
   {
      eventName1: event1Handler,
      eventName2: event2Handler
   });

Parameter:

Siehe: : - on() - einmal() - Veranstaltungen

Rückgabe:

Das Objekt, das das Ereignis ausgelöst hat.

on(Typ, Handler, Kontext) → {EventDispatcher}

Fügt eine Ereignisbehandlungsfunktion für ein oder mehrere Ereignisse hinzu.

Der folgende Code fügt einen Ereignis-Handler für ein Ereignis hinzu:

obj.on("eventName", function (event) {
    // This is the event handler.
});

Wenn Sie mehrere Ereignisnamen und eine Handler-Methode übergeben, wird der Handler für jedes dieser Ereignisse registriert:

obj.on("eventName1 eventName2",
       function (event) {
           // This is the event handler.
       });

Sie können auch ein drittes Argument übergeben context Parameter (der optional ist), um den Wert von this in der Handler-Methode:

obj.on("eventName",
       function (event) {
           // This is the event handler.
       },
       obj);

Die Methode unterstützt auch eine alternative Syntax, bei der der erste Parameter ein Objekt ist, das eine Hash-Map aus Ereignisnamen und Handler-Funktionen darstellt, und der zweite Parameter (optional) den Kontext für diesen in jedem Handler darstellt:

obj.on(
   {
      eventName1: function (event) {
              // This is the handler for eventName1.
          },
      eventName2:  function (event) {
              // This is the handler for eventName2.
          }
   },
   obj);

Wenn Sie für ein Ereignis keinen Handler hinzufügen, wird das Ereignis lokal ignoriert.

Parameter:

Siehe: : - off() - einmal() - Veranstaltungen

Rückgabe:

Das EventDispatcher-Objekt.

once(Typ, Handler, Kontext) → {Object}

Fügt eine Ereignisbehandlungsfunktion für ein oder mehrere Ereignisse hinzu. Sobald der Handler aufgerufen wird, wird die angegebene Handler-Methode als Handler für dieses Ereignis entfernt. (Wenn Sie die on() Methode zum Hinzufügen eines Ereignis-Handlers; der Handler lautet nicht wird beim Aufruf entfernt.) Das once() Die Methode entspricht dem Aufruf der on() Methode und Aufruf off() beim ersten Aufruf des Handlers.

Der folgende Code fügt einen einmaligen Ereignis-Handler für ein Ereignis hinzu:

obj.once("eventName", function (event) {
   // This is the event handler.
});

Wenn Sie mehrere Ereignisnamen und eine Handler-Methode übergeben, wird der Handler für jedes dieser Ereignisse registriert:

obj.once("eventName1 eventName2"
         function (event) {
             // This is the event handler.
         });

Sie können auch ein drittes Argument übergeben context Parameter (der optional ist), um den Wert von this in der Handler-Methode:

obj.once("eventName",
         function (event) {
             // This is the event handler.
         },
         obj);

Die Methode unterstützt außerdem eine alternative Syntax, bei der der erste Parameter ein Objekt ist, das aus einer Hash-Map mit Ereignisnamen und Handler-Funktionen besteht, und der zweite Parameter (optional) den Kontext für diesen Parameter in jedem Handler darstellt:

obj.once(
   {
      eventName1: function (event) {
                 // This is the event handler for eventName1.
          },
      eventName2:  function (event) {
                 // This is the event handler for eventName1.
          }
   },
   obj);

Parameter:

Siehe: : - on() - off() - Veranstaltungen

Rückgabe:

Das Objekt, das das Ereignis ausgelöst hat.

removeEventListener(Typ, Listener, Kontext)

Parameter:

Abgelehnt — Verwendung off() stattdessen.

Entfernt einen Ereignis-Listener für ein bestimmtes Ereignis.

Löst eine Ausnahme aus, wenn die listener Der Name ist ungültig.

Siehe: : - off() - Veranstaltungen