CKTIS / JavaScript
FocusEvent.relatedTarget — das andere Ziel des Fokuswechsels
FocusEvent.relatedTarget bezeichnet das andere Objekt bei einem Fokuswechsel: das vorherige Ziel beim Erhalten des Fokus oder das nächste Ziel beim Verlieren des Fokus. Die Eigenschaft ist schreibgeschützt und kann null sein.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.relatedTarget
new FocusEvent(type, { relatedTarget: otherTarget })FocusEvent steht für die Ereignisse focus, blur, focusin und focusout. Es erbt von UIEvent und indirekt von Event. Die Eigenschaft FocusEvent.relatedTarget beschreibt das andere Ziel eines Fokuswechsels, nicht das durch event.target bezeichnete Ziel.
Bei focus und focusin bezeichnet event.target das Objekt, das den Fokus erhält, während event.relatedTarget das Objekt bezeichnet, das den Fokus verliert. Bei blur und focusout sind die Rollen umgekehrt: event.target verliert den Fokus und event.relatedTarget erhält ihn.
relatedTarget ist schreibgeschützt und gibt ein EventTarget oder null zurück. Das andere Ziel ist möglicherweise nicht verfügbar oder aus Sicherheitsgründen verborgen, etwa wenn man per Tab in eine Seite hinein- oder aus ihr herauswechselt. Prüfe vor der Verwendung auf null; gehe außerdem nicht davon aus, dass jedes EventTarget ein DOM-Element ist.
Mit dem Konstruktor new FocusEvent(type, options) lässt sich relatedTarget setzen; der Standardwert ist null. Das Beispiel prüft diese Option ohne Abhängigkeit von einer Benutzerinteraktion. FocusEvent ist eine Browser-Web-API und keine Funktion einer bestimmten ECMAScript-Ausgabe. MDN kennzeichnet die Schnittstelle und die Eigenschaft seit Juli 2015 als allgemein verfügbar; die Verwendung von Node 24 in einem Repository belegt keine Unterstützung dieser API.
Beispiele
(() => {
const previous = document.createElement("button");
previous.id = "previous";
const event = new FocusEvent("focus", {
relatedTarget: previous
});
console.log(event.type);
console.log(event.relatedTarget === previous);
console.log(new FocusEvent("blur").relatedTarget === null);
})();Ergebnis
focus true true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.