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 im Kontakt mit der Touch-Oberflä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 so vorstellen, wie viele separate Finger identifiziert werden können, die den Bildschirm berühren.

Hinweis: Die Berührungen im Array sind nicht unbedingt in der Reihenfolge ihres Auftretens geordnet (das i-te Element im Array ist nicht unbedingt die i-te Berührung, die passiert ist). Sie können keine spezifische Reihenfolge annehmen. Um die Reihenfolge der Berührungen zu bestimmen, verwenden Sie die IDs der touch-Objekte.

Wert

Eine TouchList, die alle Touch-Objekte für Berührungspunkte auflistet, die sich noch im Kontakt mit der Touch-Oberfläche befinden, 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 und enthält eine Liste von Touch-Objekten für jeden Berührungspunkt, der aktuell 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 bestimmen und ruft dann verschiedene Handler abhängig von der Anzahl der Berührungspunkte 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;
    }
  },
  false,
);

Spezifikationen

Specification
Touch Events
# dom-touchevent-touches

Browser-Kompatibilität

BCD tables only load in the browser