CKTIS / JavaScript
FocusEvent.relatedTarget — l’altro obiettivo della transizione del focus
FocusEvent.relatedTarget identifica l’altro oggetto coinvolto in una transizione del focus: l’obiettivo precedente quando si riceve il focus o quello successivo quando lo si perde. La proprietà è di sola lettura e può essere null.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
event.relatedTarget
new FocusEvent(type, { relatedTarget: otherTarget })FocusEvent rappresenta gli eventi focus, blur, focusin e focusout. Eredita da UIEvent e indirettamente da Event. La proprietà FocusEvent.relatedTarget descrive l’altro obiettivo di una transizione del focus, non quello identificato da event.target.
Per focus e focusin, event.target identifica l’oggetto che riceve il focus, mentre event.relatedTarget identifica quello che lo perde. Per blur e focusout, i ruoli si invertono: event.target perde il focus e event.relatedTarget lo riceve.
relatedTarget è di sola lettura e restituisce un EventTarget o null. L’altro obiettivo potrebbe non essere disponibile o essere nascosto per motivi di sicurezza, ad esempio quando si usa Tab per entrare in una pagina o uscirne. Controlla che il valore non sia null prima di usarlo; inoltre, non dare per scontato che ogni EventTarget sia un elemento DOM.
Il costruttore new FocusEvent(type, options) consente di impostare relatedTarget; il valore predefinito è null. L’esempio verifica questa opzione senza dipendere dall’interazione dell’utente. FocusEvent è una Web API del browser, non una funzionalità di una specifica edizione di ECMAScript. MDN indica che l’interfaccia e la proprietà sono ampiamente disponibili da luglio 2015; l’uso di Node 24 in un repository non dimostra il supporto di questa API.
Esempi
(() => {
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);
})();Risultato
focus true true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.