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 herausbewegt; Auslösen des pointerup-Ereignisses für ein Gerät, das keine Hover-Unterstützung bietet (siehe pointerup); nach dem Auslösen des pointercancel-Ereignisses (siehe pointercancel); wenn ein Stift die vom Digitalisierer erkennbare Hover-Range verlässt.

pointerout-Ereignisse haben die gleichen Probleme wie mouseout. Wenn das Zielelement Kindelemente hat, werden pointerout- und pointerover-Ereignisse ausgelöst, sobald der Zeiger über die Grenzen dieser Elemente bewegt wird, und nicht nur das Zielelement selbst. In der Regel ist das Verhalten von pointerenter- und pointerleave-Ereignissen sinnvoller, da sie nicht von Bewegungen in Kindelemente 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 Überträgerachse (ein Zeiger oder Stift) und der X-Y-Ebene eines Geräts dar.
PointerEvent.azimuthAngle Schreibgeschützt Experimentell: Stellt den Winkel zwischen der Y-Z-Ebene und der Ebene dar, die sowohl die Überträgerachse (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 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 als Laufdruck oder Zylinderbelastung bekannt) 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. Stiftstift) als auch die Y-Achse umfasst.
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. Stiftstift) als auch die X-Achse umfasst.
PointerEvent.twist Schreibgeschützt: Die im Uhrzeigersinn gerichtete Drehung des Zeigers (z. B. Stiftstift) 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, etc.).
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