Element: pointerout Ereignis

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 pointerout-Ereignis wird aus mehreren Gründen ausgelöst, einschließlich: Das Zeigegerät wird aus den Hit-Test-Grenzen eines Elements bewegt; das Auslösen des pointerup-Ereignisses für ein Gerät, das kein Hover unterstützt (siehe pointerup); nach dem Auslösen des pointercancel-Ereignisses (siehe pointercancel); wenn ein Stift außerhalb des durch den Digitalisierer erkennbaren Hoverbereichs gelangt.

pointerout-Ereignisse haben die gleichen Probleme wie mouseout. Wenn das Zielelement untergeordnete Elemente hat, werden pointerout- und pointerover-Ereignisse ebenfalls ausgelöst, wenn der Zeiger über die Grenzen dieser Elemente bewegt wird, nicht nur über das Zielelement selbst. Normalerweise ist das Verhalten der pointerenter- und pointerleave-Ereignisse sinnvoller, da sie nicht vom Wechseln in untergeordnete Elemente betroffen sind.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Event-Handler-Eigenschaft.

addEventListener("pointerout", (event) => { })

onpointerout = (event) => { }

Ereignistyp

Ein PointerEvent. Erbt von Event.

Ereigniseigenschaften

Diese Schnittstelle erbt Eigenschaften von MouseEvent und Event.

PointerEvent.altitudeAngle Schreibgeschützt Experimentell: Stellt den Winkel zwischen einer Transducer-Achse (ein Zeiger oder Stift) und der X-Y-Ebene eines Gerätebildschirms dar.
PointerEvent.azimuthAngle Schreibgeschützt Experimentell: Stellt den Winkel zwischen der Y-Z-Ebene und der Ebene dar, die sowohl die Transducer-Achse (ein Zeiger oder Stift) als auch die Y-Achse enthält.
PointerEvent.persistentDeviceId Schreibgeschützt Experimentell: Eine eindeutige Kennung für das Zeigegerä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 (Größe auf der X-Achse), in CSS-Pixel, der Kontaktgeometrie des Zeigers.
PointerEvent.height Schreibgeschützt: Die Höhe (Größe auf der Y-Achse), in CSS-Pixel, 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 erfassen kann.
PointerEvent.tangentialPressure Schreibgeschützt: Der normalisierte tangentiale Druck des Zeigereingangs (auch bekannt als Fassdruck oder Zylinderbelastung) im Bereich von -1 bis 1, wobei 0 die neutrale Position der Steuerung ist.
PointerEvent.tiltX Schreibgeschützt: Der Flächenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der Y-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z. B. Stift) als auch die Y-Achse enthält.
PointerEvent.tiltY Schreibgeschützt: Der Flächenwinkel (in Grad, im Bereich von -90 bis 90) zwischen der X-Z-Ebene und der Ebene, die sowohl die Zeigerachse (z. B. Stift) als auch die X-Achse enthält.
PointerEvent.twist Schreibgeschützt: Die Drehung im Uhrzeigersinn 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, Berührung usw.).
PointerEvent.isPrimary Schreibgeschützt: Gibt an, ob der Zeiger den primären Zeiger dieses Zeigertyps darstellt.

Beispiele

Verwendung von addEventListener():

const para = document.querySelector("p");

para.addEventListener("pointerout", (event) => {
  console.log("Pointer moved out");
});

Verwendung der onpointerout Event-Handler-Eigenschaft:

const para = document.querySelector("p");

para.onpointerout = (event) => {
  console.log("Pointer moved out");
};

Spezifikationen

Specification
Pointer Events # the-pointerout-event
Pointer Events # dom-globaleventhandlers-onpointerout

Browser-Kompatibilität

Siehe auch

Verwandte Ereignisse