Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła