TouchEvent: touches-Eigenschaft
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more support for this feature? Tell us why.
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.
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
| Spezifikation |
|---|
| Touch Events # dom-touchevent-touches |