Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

TouchEvent: changedTouches-Eigenschaft

Limited availability

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

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

  • Beim touchstart-Ereignis ist es eine Liste der Berührungspunkte, die mit dem aktuellen Ereignis aktiv wurden.
  • Beim touchmove-Ereignis ist es eine Liste der Berührungspunkte, die sich seit dem letzten Ereignis geändert haben.
  • Bei den Ereignissen touchend und touchcancel ist es eine Liste der Berührungspunkte, die von der Oberfläche entfernt wurden (das heißt, 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 zum Ereignis beigetragen hat.

Im folgenden Codeausschnitt durchläuft der touchmove-Ereignis-Handler die changedTouches-Liste und gibt die Kennung jedes Berührungspunktes 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}`,
    );
  }
});

Spezifikationen

Specification
Touch Events
# dom-touchevent-changedtouches

Browser-Kompatibilität