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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.