Es war einmal ganz einfach, im Web auf Dinge zu zeigen. Sie hatten eine Maus, haben sie bewegt, manchmal Tasten gedrückt und das war es. Alles, was keine Maus war, wurde als Maus emuliert und die Entwickler wussten genau, worauf sie sich verlassen konnten.
Einfach bedeutet aber nicht unbedingt gut. Im Laufe der Zeit wurde es immer wichtiger, dass nicht alles eine Maus war (oder vorgab, eine zu sein): Sie konnten druckempfindliche und Neigungssensoren verwenden, um eine enorme kreative Freiheit zu erhalten. Sie konnten Ihre Finger verwenden, sodass Sie nur das Gerät und Ihre Hand benötigten. Und warum nicht gleich mehrere Finger verwenden?
Wir haben schon seit einiger Zeit Touch-Ereignisse, die uns dabei helfen. Es handelt sich jedoch um eine völlig separate API speziell für Touchbedienung. Wenn Sie sowohl Maus- als auch Touchbedienung unterstützen möchten, müssen Sie also zwei separate Ereignismodelle programmieren. Chrome 55 enthält einen neueren Standard, der beide Modelle vereint: Zeigerereignisse.
Ein Modell für ein einzelnes Ereignis
Maus-Ereignisse vereinheitlichen das Eingabemodell für den Mauszeiger im Browser und fassen Touchbedienung, Eingabestifte und Mäuse in einer einzigen Gruppe von Ereignissen zusammen. Beispiel:
document.addEventListener('pointermove',
ev => console.log('The pointer moved.'));
foo.addEventListener('pointerover',
ev => console.log('The pointer is now over foo.'));
Hier ist eine Liste aller verfügbaren Ereignisse, die Ihnen bekannt vorkommen sollten, wenn Sie mit Mausereignissen vertraut sind:
pointerover
|
Der Cursor befindet sich im Begrenzungsrahmen des Elements.
Das geschieht sofort auf Geräten, die das Hovering unterstützen, oder vor einem pointerdown -Ereignis auf Geräten, die das Hovering nicht unterstützen.
|
pointerenter
|
Ähnlich wie pointerover , aber ohne Aufsteigen und mit anderer Behandlung von Nachkommen.
Details zur Spezifikation
|
pointerdown
|
Der Cursor hat den Status „Aktive Schaltfläche“ erreicht. Je nach Semantik des Eingabegeräts wird entweder eine Schaltfläche gedrückt oder eine Berührung erkannt. |
pointermove
|
Der Cursor hat seine Position geändert. |
pointerup
|
Der Cursor hat den Status der aktiven Schaltfläche verlassen. |
pointercancel
|
Es ist etwas passiert, was bedeutet, dass der Zeiger wahrscheinlich keine weiteren Ereignisse mehr ausgibt. Sie sollten also alle laufenden Aktionen abbrechen und zu einem neutralen Eingabestatus zurückkehren. |
pointerout
|
Der Cursor hat den Begrenzungsrahmen des Elements oder des Bildschirms verlassen. Auch nach einem pointerup , wenn das Gerät das Hovering nicht unterstützt.
|
pointerleave
|
Ähnlich wie pointerout , aber ohne Aufsteigen und mit anderer Behandlung von Nachkommen.
Details zur Spezifikation
|
gotpointercapture
|
Das Element hat eine Maus- oder Touch-Eingabe erhalten. |
lostpointercapture
|
Der aufgenommene Zeiger wurde freigegeben. |
Verschiedene Eingabetypen
Im Allgemeinen ermöglichen Pointer-Ereignisse, Code unabhängig von der Eingabe zu schreiben, ohne dass separate Ereignishandler für verschiedene Eingabegeräte registriert werden müssen.
Natürlich müssen Sie die Unterschiede zwischen den Eingabetypen berücksichtigen, z. B. ob das Konzept „Hover“ (Bewegung des Mauszeigers) gilt. Wenn Sie verschiedene Eingabegerätetypen unterscheiden möchten, z. B. um für verschiedene Eingaben separaten Code/Funktionen bereitzustellen, können Sie dies jedoch innerhalb derselben Ereignishandler mithilfe der Eigenschaft pointerType
der Schnittstelle PointerEvent
tun. Wenn Sie beispielsweise eine seitliche Navigationsleiste codieren, könnte die folgende Logik für das Ereignis pointermove
gelten:
switch(ev.pointerType) {
case 'mouse':
// Do nothing.
break;
case 'touch':
// Allow drag gesture.
break;
case 'pen':
// Also allow drag gesture.
break;
default:
// Getting an empty string means the browser doesn't know
// what device type it is. Let's assume mouse and do nothing.
break;
}
Standardaktionen
In Touch-fähigen Browsern werden bestimmte Touch-Gesten verwendet, um die Seite zu scrollen, zu zoomen oder zu aktualisieren.
Bei Touch-Ereignissen erhalten Sie weiterhin Ereignisse, während diese Standardaktionen ausgeführt werden. Beispielsweise wird touchmove
weiterhin ausgelöst, während der Nutzer scrollt.
Bei Zeigerereignissen erhalten Sie jedes Mal ein pointercancel
-Ereignis, wenn eine Standardaktion wie Scrollen oder Zoomen ausgelöst wird. So erkennen Sie, dass der Browser die Kontrolle über den Zeiger übernommen hat. Beispiel:
document.addEventListener('pointercancel',
ev => console.log('Go home, the browser is in charge now.'));
Eingebaute Geschwindigkeit: Dieses Modell bietet standardmäßig eine bessere Leistung als Touch-Ereignisse, bei denen Sie passive Ereignis-Listener verwenden müssten, um dieselbe Reaktionsfähigkeit zu erreichen.
Mit der CSS-Eigenschaft touch-action
können Sie verhindern, dass der Browser die Kontrolle übernimmt. Wenn Sie für ein Element den Wert none
festlegen, werden alle browserdefinierten Aktionen deaktiviert, die über dieses Element gestartet werden. Es gibt jedoch eine Reihe anderer Werte für eine detailliertere Steuerung, z. B. pan-x
, mit dem der Browser auf Bewegungen entlang der X-Achse, aber nicht der Y-Achse reagieren kann. Chrome 55 unterstützt die folgenden Werte:
auto
|
Standard; der Browser kann eine beliebige Standardaktion ausführen. |
none
|
Der Browser darf keine Standardaktionen ausführen. |
pan-x
|
Der Browser darf nur die Standardaktion „Horizontal scrollen“ ausführen. |
pan-y
|
Der Browser darf nur die Standardaktion für das vertikale Scrollen ausführen. |
pan-left
|
Der Browser darf nur die Standardaktion für das horizontale Scrollen ausführen und die Seite nur nach links schwenken. |
pan-right
|
Der Browser darf nur die Standardaktion „Horizontal scrollen“ ausführen und die Seite nur nach rechts schwenken. |
pan-up
|
Der Browser darf nur die Standardaktion für das vertikale Scrollen ausführen und nur die Seite nach oben schwenken. |
pan-down
|
Der Browser darf nur die Standardaktion für das vertikale Scrollen ausführen und nur die Seite nach unten schwenken. |
manipulation
|
Der Browser darf nur Scroll- und Zoomaktionen ausführen. |
Zeigererfassung
Haben Sie schon einmal eine frustrierende Stunde damit verbracht, ein fehlerhaftes mouseup
-Ereignis zu beheben, bis Sie festgestellt haben, dass der Nutzer die Schaltfläche außerhalb Ihres Klickziels loslässt? Nein? Okay, vielleicht liegt es nur an mir.
Bislang gab es jedoch keine wirklich gute Möglichkeit, dieses Problem anzugehen. Natürlich können Sie den mouseup
-Handler für das Dokument einrichten und einen Status in Ihrer Anwendung speichern, um den Überblick zu behalten. Das ist jedoch nicht die sauberste Lösung, insbesondere wenn Sie eine Webkomponente erstellen und alles schön getrennt halten möchten.
Mit Zeigerereignissen gibt es eine viel bessere Lösung: Sie können den Zeiger erfassen, damit Sie das pointerup
-Ereignis (oder einen anderen seiner schwer fassbaren Freunde) auf jeden Fall erhalten.
const foo = document.querySelector('#foo');
foo.addEventListener('pointerdown', ev => {
console.log('Button down, capturing!');
// Every pointer has an ID, which you can read from the event.
foo.setPointerCapture(ev.pointerId);
});
foo.addEventListener('pointerup',
ev => console.log('Button up. Every time!'));
Unterstützte Browser
Zum Zeitpunkt der Erstellung dieses Artikels werden Pointer-Ereignisse in Internet Explorer 11, Microsoft Edge, Chrome und Opera unterstützt. In Firefox werden sie teilweise unterstützt. Eine aktuelle Liste finden Sie unter caniuse.com.
Sie können die Pointer Events-Polyfill verwenden, um die Lücken zu schließen. Alternativ können Sie während der Laufzeit ganz einfach prüfen, ob der Browser unterstützt wird:
if (window.PointerEvent) {
// Yay, we can use pointer events!
} else {
// Back to mouse and touch events, I guess.
}
Zeiger-Ereignisse eignen sich hervorragend für die progressive Verbesserung: Ändern Sie einfach Ihre Initialisierungsmethoden, um die oben genannte Prüfung durchzuführen, fügen Sie Zeiger-Ereignis-Handler in den Block if
ein und verschieben Sie die Maus-/Touch-Ereignis-Handler in den Block else
.
Probieren Sie sie aus und lassen Sie uns wissen, was Sie davon halten.