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: touches-Eigenschaft

Limited availability

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

touches ist eine schreibgeschützte TouchList, die alle Touch-Objekte für Berührungspunkte auflistet, die sich derzeit in Kontakt mit der Berührungsoberfläche befinden, unabhängig davon, ob sie sich geändert haben oder welches ihre Ziel-Elemente zum Zeitpunkt von touchstart waren.

Sie können es sich vorstellen als die Anzahl der separaten Finger, die als gleichzeitig den Bildschirm berührend erkannt werden können.

Hinweis: Die Berührungen im Array sind nicht unbedingt nach Auftreten geordnet (d.h. das i-te Element im Array ist nicht unbedingt die i-te Berührung, die aufgetreten ist). Sie können keine bestimmte Reihenfolge annehmen. Um die Reihenfolge der Auftritte der Berührungen zu bestimmen, verwenden Sie die touch-Objekt-IDs.

Wert

Eine TouchList, die alle Touch-Objekte für Berührungspunkte auflistet, die weiterhin in Kontakt mit der Berührungsoberfläche sind, unabhängig davon, ob sie sich geändert haben oder welches ihre Ziel-Elemente zum Zeitpunkt von touchstart waren.

Beispiele

Dieses Beispiel veranschaulicht die TouchEvent.touches-Eigenschaft des TouchEvent-Objekts. Die TouchEvent.touches-Eigenschaft ist ein TouchList-Objekt, das eine Liste von Touch-Objekten für jeden Berührungspunkt enthält, der derzeit die Oberfläche berührt.

Im folgenden Code-Snippet überprüft der touchstart-Ereignishandler die Länge der TouchEvent.touches-Liste, um die Anzahl der aktivierten Berührungspunkte zu ermitteln, und ruft dann je nach Anzahl der Berührungspunkte verschiedene Handler auf.

js
someElement.addEventListener("touchstart", (e) => {
  // Invoke the appropriate handler depending on the
  // number of touch points.
  switch (e.touches.length) {
    case 1:
      handle_one_touch(e);
      break;
    case 2:
      handle_two_touches(e);
      break;
    case 3:
      handle_three_touches(e);
      break;
    default:
      console.log("Not supported");
      break;
  }
});

Spezifikationen

Specification
Touch Events
# dom-touchevent-touches

Browser-Kompatibilität