База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

FocusEvent.relatedTarget — другата цел при преход на фокуса

FocusEvent.relatedTarget обозначава другия обект, участващ в прехода на фокуса: предишната цел при получаване на фокус или следващата цел при загубата му. Свойството е само за четене и може да бъде null.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

event.relatedTarget
new FocusEvent(type, { relatedTarget: otherTarget })

FocusEvent представя събитията focus, blur, focusin и focusout. То наследява от UIEvent и косвено от Event. Свойството FocusEvent.relatedTarget описва другата цел при преход на фокуса, а не целта, обозначена от event.target.

При focus и focusin event.target обозначава обекта, който получава фокуса, а event.relatedTarget — обекта, който го губи. При blur и focusout ролите са разменени: event.target губи фокуса, а event.relatedTarget го получава.

relatedTarget е само за четене и връща EventTarget или null. Другата цел може да е недостъпна или скрита от съображения за сигурност, например при преминаване с Tab към страница или извън нея. Проверявайте за null, преди да използвате стойността; не приемайте и че всеки EventTarget е DOM елемент.

Конструкторът new FocusEvent(type, options) позволява да зададете relatedTarget; стойността по подразбиране е null. Примерът проверява тази опция, без да зависи от взаимодействие с потребител. FocusEvent е браузърен Web API, а не функция на конкретно издание на ECMAScript. MDN отбелязва, че интерфейсът и свойството са широко достъпни от юли 2015 г.; използването на Node 24 в хранилище не доказва поддръжка на този API.

Примери

(() => {
  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);
})();

Резултат

focus
true
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници