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.

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

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

Ein Zeiger-Treffertest ist der Prozess, den ein Browser verwendet, um das Ziel-Element für ein Zeigerereignis zu bestimmen. Typischerweise wird dies durch Berücksichtigung des Standorts des Zeigers und auch des visuellen Layouts der Elemente in einem Dokument auf Bildschirmmedien bestimmt.

Konstruktoren

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

Instanz-Eigenschaften

Diese Schnittstelle erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Schreibgeschützt: Repräsentiert den Winkel zwischen der Achse eines Wandlers (eines Zeigers oder Stiftes) und der X-Y-Ebene eines Gerätebildschirms.
PointerEvent.azimuthAngle Schreibgeschützt: Repräsentiert den Winkel zwischen der Y-Z-Ebene und der Ebene, die sowohl die Achse des Wandlers (eines Zeigers oder Stiftes) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceId Schreibgeschützt Experimentell: Eine eindeutige Kennung für das Eingabegerät, das das PointerEvent erzeugt.
PointerEvent.pointerId Schreibgeschützt: Eine eindeutige Kennung für den Zeiger, der das Ereignis verursacht.
PointerEvent.width Schreibgeschützt: Die Breite (Magnitude auf der X-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.height Schreibgeschützt: Die Höhe (Magnitude auf der Y-Achse) in CSS-Pixeln der Kontaktgeometrie des Zeigers.
PointerEvent.pressure Schreibgeschützt: Der normalisierte Druck der Zeigereingabe im Bereich von 0 bis 1, wobei 0 und 1 den minimalen und maximalen Druck darstellen, den die Hardware erfassen kann.
PointerEvent.tangentialPressure Schreibgeschützt: Der normalisierte tangentiale Druck der Zeigereingabe (auch bekannt als Fassdruck oder Zylinderbelastung) im Bereich -1 bis 1, wobei 0 die neutrale Position 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. Stift) 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. Stift) als auch die X-Achse enthält.
PointerEvent.twist Schreibgeschützt: Die im Uhrzeigersinn gerichtete Drehung des Zeigers (z.B. Stift) 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, Touch usw.).
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 zu dem ausgelösten pointermove-Ereignis zusammengefasst wurden.
PointerEvent.getPredictedEvents(): Gibt eine Sequenz von PointerEvent-Instanzen zurück, die der Browser vorausgesagt hat, nachdem die zu dem ausgelösten pointermove-Ereignis zusammengefassten Ereignisse folgen werden.

Zeiger-Ereignistypen

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

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

pointerover: Dieses Ereignis wird ausgelöst, wenn ein Zeigegerät in die Treffertest-Grenzen eines Elements bewegt wird.
pointerenter: Dieses Ereignis wird ausgelöst, wenn ein Zeigegerät in die Treffertest-Grenzen eines Elements oder eines seiner Nachkommen bewegt wird, einschließlich als Ergebnis eines pointerdown-Ereignisses eines Geräts, das Hover nicht unterstützt (siehe pointerdown). Dieser Ereignistyp ähnelt pointerover, unterscheidet sich jedoch dadurch, dass er nicht aufsteigt.
pointerdown: Das Ereignis wird ausgelöst, wenn ein Zeiger aktiv wird. Für die Maus wird es ausgelöst, wenn das Gerät vom Drücken keiner Tasten zum Drücken von mindestens einer Taste übergeht. Für Touch wird es ausgelöst, wenn physischer Kontakt mit dem Digitalisierer hergestellt wird. Für Stift wird es ausgelöst, wenn der Stift physischen Kontakt mit dem Digitalisierer herstellt.

Hinweis: Für Touchscreen-Browser, die direkte Manipulation erlauben, löst ein pointerdown-Ereignis eine implizite Zeigererfassung aus, wodurch das Ziel alle nachfolgenden Zeigereignisse erfasst, als ob sie über dem erfassenden Ziel auftreten würden. Dementsprechend werden pointerover, pointerenter, pointerleave und pointerout nicht ausgelöst, solange diese Erfassung gesetzt ist. Die Erfassung kann manuell durch Aufruf von element.releasePointerCapture auf dem Zielelement freigegeben werden oder wird nach einem pointerup- oder pointercancel-Ereignis automatisch freigegeben.
pointermove: Dieses Ereignis wird ausgelöst, wenn ein Zeiger Koordinaten ä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 feststellt, dass der Zeiger keine Ereignisse mehr generieren kann (z.B. wenn das zugehörige Gerät deaktiviert ist).
pointerout: Dieses Ereignis wird aus mehreren Gründen ausgelöst: wenn das Zeigegerät aus den Treffertest-Grenzen eines Elements bewegt wird; wenn das pointerup-Ereignis für ein Gerät, das Hover nicht unterstützt, ausgelöst wird (siehe pointerup); nach dem Auslösen des pointercancel-Ereignisses (siehe pointercancel); wenn ein Stift die Hover-Reichweite verlässt, die der Digitalisierer erkennen kann.
pointerleave: Dieses Ereignis wird ausgelöst, wenn ein Zeigegerät aus den Treffertest-Grenzen eines Elements bewegt wird. Für Stiftgeräte wird dieses Ereignis ausgelöst, wenn der Stift die Hover-Reichweite verlässt, die der Digitalisierer erkennen kann.
gotpointercapture: Dieses Ereignis wird ausgelöst, wenn ein Element die 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 den jeweiligen Referenzseiten enthalten.

Spezifikationen

Specification
Pointer Events # pointerevent-interface

Browser-Kompatibilität

BCD tables only load in the browser