TouchEvent: changedTouches-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die changedTouches schreibgeschützte Eigenschaft ist eine TouchList, deren Berührungspunkte (Touch-Objekte) je nach Ereignistyp wie folgt variieren:

  • Bei dem touchstart-Ereignis ist es eine Liste der Berührungspunkte, die mit dem aktuellen Ereignis aktiv wurden.
  • Bei dem touchmove-Ereignis ist es eine Liste der Berührungspunkte, die sich seit dem letzten Ereignis geändert haben.
  • Bei den touchend- und touchcancel-Ereignissen ist es eine Liste der Berührungspunkte, die von der Oberfläche entfernt wurden (d.h. die Menge der Berührungspunkte, die Fingern entsprechen, die die Oberfläche nicht mehr berühren).

Wert

Eine TouchList, deren Touch-Objekte alle Berührungspunkte enthalten, die zu diesem Berührungsereignis beigetragen haben.

Beispiele

Dieses Beispiel veranschaulicht die TouchEvent.changedTouches-Eigenschaft des TouchEvent-Objekts. Die TouchEvent.changedTouches-Eigenschaft ist ein TouchList-Objekt, das ein Touch-Objekt für jeden Berührungspunkt enthält, der zu dem Ereignis beigetragen hat.

Im folgenden Code-Snippet iteriert der touchmove-Ereignishandler durch die changedTouches-Liste und gibt die Kennung jedes Berührungspunkts aus, der sich seit dem letzten Ereignis geändert hat.

js
someElement.addEventListener(
  "touchmove",
  (e) => {
    // Iterate through the list of touch points that changed
    // since the last event and print each touch point's identifier.
    for (let i = 0; i < e.changedTouches.length; i++) {
      console.log(
        `changedTouches[${i}].identifier = ${e.changedTouches[i].identifier}`,
      );
    }
  },
  false,
);

Spezifikationen

Specification
Touch Events
# dom-touchevent-changedtouches

Browser-Kompatibilität

BCD tables only load in the browser