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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
touches

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Has more compatibility info.