CKTIS / JavaScript
FocusEvent.relatedTarget — drugi cel zmiany fokusu
FocusEvent.relatedTarget wskazuje drugi obiekt uczestniczący w zmianie fokusu: poprzedni przy jego uzyskaniu lub następny przy utracie. Właściwość jest tylko do odczytu i może mieć wartość null.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
event.relatedTarget
new FocusEvent(type, { relatedTarget: otherTarget })FocusEvent reprezentuje zdarzenia focus, blur, focusin i focusout. Dziedziczy po UIEvent, a pośrednio po Event. Jego właściwość FocusEvent.relatedTarget opisuje drugi cel zmiany fokusu, a nie cel wskazany przez event.target.
Dla focus i focusin właściwość event.target wskazuje obiekt otrzymujący fokus, a event.relatedTarget — obiekt tracący fokus. Dla blur i focusout role są odwrotne: event.target traci fokus, a event.relatedTarget go otrzymuje.
relatedTarget jest tylko do odczytu i zwraca EventTarget lub null. Drugi cel może być niedostępny albo ukryty ze względów bezpieczeństwa, np. podczas przechodzenia klawiszem Tab do strony lub poza nią. Sprawdzaj null przed użyciem wartości; nie zakładaj też, że każdy EventTarget jest elementem DOM.
Konstruktor new FocusEvent(type, options) pozwala ustawić relatedTarget; domyślnie jest to null. Przykład sprawdza tę opcję bez zależności od interakcji użytkownika. FocusEvent jest przeglądarkowym Web API, nie funkcją określonej edycji ECMAScript. MDN oznacza interfejs i właściwość jako szeroko dostępne od lipca 2015 r.; samo użycie Node 24 w repozytorium nie potwierdza obsługi tego API.
Przykłady
(() => {
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);
})();Wynik
focus true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.