PointerEvent

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2020.

* Some parts of this feature may have varying levels of support.

Das PointerEvent Interface repräsentiert den Zustand eines DOM-Ereignisses, das durch einen Zeiger wie die Geometrie des Kontaktpunkts, den Gerätetyp, der das Ereignis erzeugt hat, den Druck, der auf die Kontaktfläche ausgeübt wurde, usw. erzeugt wird.

Ein Zeiger ist eine hardwareunabhängige Darstellung von Eingabegeräten (wie eine Maus, ein Stift oder ein Kontaktpunkt auf einer berührungsempfindlichen Oberfläche). Der Zeiger kann eine bestimmte Koordinate (oder ein Satz von Koordinaten) auf der Kontaktfläche wie einem Bildschirm anvisieren.

Ein Zeiger-Treffer-Test ist der Prozess, den ein Browser verwendet, um das Ziel-Element für ein Zeigerereignis zu bestimmen. Typischerweise wird dies durch die Berücksichtigung der Position des Zeigers und auch des visuellen Layouts von Elementen in einem Dokument auf einem Bildschirmmedium bestimmt.

Konstruktoren

PointerEvent(): Erstellt ein synthetisches und nicht vertrauenswürdiges PointerEvent.

Instanz-Eigenschaften

Dieses Interface erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Schreibgeschützt: Repräsentiert den Winkel zwischen der Achse eines Transducers (eines Zeigers oder Stylus) und der X-Y-Ebene eines Geräteschirms.
PointerEvent.azimuthAngle Schreibgeschützt: Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Transducers (eines Zeigers oder Stifts) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceId Schreibgeschützt: Eine eindeutige Identifikation für das Zeigegerät, das das PointerEvent erzeugt.
PointerEvent.pointerId Schreibgeschützt: Eine eindeutige Identifikation für den Zeiger, der das Ereignis verursacht.
PointerEvent.width Schreibgeschützt: Die Breite (Größe auf der X-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.height Schreibgeschützt: Die Höhe (Größe auf der Y-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.pressure Schreibgeschützt: Der normalisierte Druck des Zeigereingangs im Bereich von 0 bis 1, wobei 0 und 1 den minimalen und maximalen Druck darstellen, den die Hardware erkennen kann.
PointerEvent.tangentialPressure Schreibgeschützt: Der normalisierte tangentiale Druck des Zeigereingangs (auch bekannt als Barrel-Druck oder Zylinderbelastung) im Bereich von -1 bis 1, wobei 0 die Neutralposition der Steuerung ist.
PointerEvent.tiltX Schreibgeschützt: Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der Y–Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z.B. Pen-Stylus) als auch die Y-Achse enthält.
PointerEvent.tiltY Schreibgeschützt: Der Ebenenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der X–Z-Ebene und der Ebene, die sowohl die Achse des Zeigers (z.B. Pen-Stylus) als auch die X-Achse enthält.
PointerEvent.twist Schreibgeschützt: Die Drehung im Uhrzeigersinn des Zeigers (z.B. Pen-Stylus) um seine Hauptachse in Grad, mit einem Wert im Bereich von 0 bis 359.
PointerEvent.pointerType Schreibgeschützt: Gibt den Gerätetyp an, der das Ereignis verursacht hat (Maus, Stift, Berührung, etc.).
PointerEvent.isPrimary Schreibgeschützt: Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.

Instanz-Methoden

PointerEvent.getCoalescedEvents() Sicherer Kontext: Gibt eine Sequenz aller PointerEvent Instanzen zurück, die in das ausgelöste pointermove Ereignis zusammengefasst wurden.
PointerEvent.getPredictedEvents(): Gibt eine Sequenz von PointerEvent Instanzen zurück, die der Browser vorherzusagen erwartet, dass sie den zusammengefassten Ereignissen des ausgelösten pointermove Ereignisses folgen werden.

Zeigerereignistypen

Das PointerEvent Interface hat verschiedene Ereignistypen. Um zu bestimmen, welches Ereignis ausgelöst wurde, schauen Sie sich die Eigenschaft type des Ereignisses an.

Hinweis: Es ist wichtig zu beachten, dass in vielen Fällen sowohl Zeiger- als auch Mausereignisse gesendet werden (um es nicht spezifizischem Code auch zu ermöglichen, mit dem Benutzer zu interagieren). Wenn Sie Zeigerereignisse verwenden, sollten Sie preventDefault() aufrufen, um zu verhindern, dass auch das Mausereignis gesendet wird.

pointerover: Dieses Ereignis wird ausgelöst, wenn ein Zeigegerät in die Treffer-Test-Grenzen eines Elements bewegt wird.
pointerenter: Dieses Ereignis wird ausgelöst, wenn ein Zeigegerät in die Treffer-Test-Grenzen eines Elements oder eines seiner Nachkommen bewegt wird, einschließlich als Resultat eines pointerdown Ereignisses von einem Gerät, das den Schwebemodus nicht unterstützt (siehe pointerdown). Dieser Ereignistyp ist ähnlich wie pointerover, unterscheidet sich jedoch dadurch, dass er sich nicht blasenförmig ausbreitet.
pointerdown: Das Ereignis wird ausgelöst, wenn ein Zeiger aktiv wird. Bei einer Maus wird es ausgelöst, wenn das Gerät vom Zustand ohne gedrückte Tasten zu mindestens einer gedrückten Taste wechselt. Bei Berührung wird es ausgelöst, wenn physischer Kontakt mit dem Digitalisierer hergestellt wird. Bei Stift wird es ausgelöst, wenn der Stylus physischen Kontakt mit dem Digitalisierer herstellt.

Hinweis: Für Touchscreen-Browser, die direkte Manipulation ermöglichen, löst ein pointerdown Ereignis die implizite Zeigererfassung aus, wodurch das Ziel alle nachfolgenden Zeigerereignisse erfasst, als ob sie über dem erfassenden Ziel auftreten würden. Dementsprechend werden pointerover, pointerenter, pointerleave und pointerout nicht ausgelöst, solange diese Erfassung aktiv ist. Die Erfassung kann manuell durch Aufrufen von element.releasePointerCapture am Zielelement aufgehoben werden, oder sie wird implizit nach einem pointerup oder pointercancel Ereignis aufgehoben.
pointermove: Dieses Ereignis wird ausgelöst, wenn ein Zeigerkoordinaten ändert.
pointerrawupdate Experimentell: Dieses Ereignis wird ausgelöst, wenn sich eine der Eigenschaften eines Zeigers ändert.
pointerup: Dieses Ereignis wird ausgelöst, wenn ein Zeiger nicht mehr aktiv ist.
pointercancel: Ein Browser löst dieses Ereignis aus, wenn er zu dem Schluss kommt, dass der Zeiger keine Ereignisse mehr erzeugen kann (zum Beispiel wenn das zugehörige Gerät deaktiviert wird).
pointerout: Dieses Ereignis wird aus mehreren Gründen ausgelöst, einschließlich: Zeigegerät wird aus den Treffer-Test-Grenzen eines Elements bewegt; Auslösen des pointerup Ereignisses für ein Gerät, das den Schwebemodus nicht unterstützt (siehe pointerup); nach dem Auslösen des pointercancel Ereignisses (siehe pointercancel); wenn ein Pen-Stylus den Schwebebereich verlässt, der vom Digitalisierer erkannt wird.
pointerleave: Dieses Ereignis wird ausgelöst, wenn ein Zeigegerät aus den Treffer-Test-Grenzen eines Elements bewegt wird. Bei Pen-Geräten wird dieses Ereignis ausgelöst, wenn der Stylus den Schwebebereich verlässt, der vom Digitalisierer erkannt wird.
gotpointercapture: Dieses Ereignis wird ausgelöst, wenn ein Element Zeigererfassung erhält.
lostpointercapture: Dieses Ereignis wird ausgelöst, nachdem die Zeigererfassung für einen Zeiger freigegeben wurde.

Beispiel

Beispiele für jede Eigenschaft, jeden Ereignistyp und jeden globalen Ereignishandler sind in ihren jeweiligen Referenzseiten enthalten.

Spezifikationen

Specification
Pointer Events # pointerevent-interface