CKTIS / JavaScript
FocusEvent.relatedTarget — druhý cíl změny fokusu
FocusEvent.relatedTarget označuje druhý objekt účastnící se změny fokusu: předchozí cíl při získání fokusu nebo následující cíl při jeho ztrátě. Vlastnost je pouze pro čtení a může mít hodnotu null.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
event.relatedTarget
new FocusEvent(type, { relatedTarget: otherTarget })FocusEvent představuje události focus, blur, focusin a focusout. Dědí z UIEvent a nepřímo z Event. Jeho vlastnost FocusEvent.relatedTarget popisuje druhý cíl při změně fokusu, nikoli cíl určený pomocí event.target.
U událostí focus a focusin označuje event.target objekt, který fokus získává, zatímco event.relatedTarget označuje objekt, který ho ztrácí. U blur a focusout jsou role obrácené: event.target fokus ztrácí a event.relatedTarget ho získává.
relatedTarget je pouze pro čtení a vrací EventTarget nebo null. Druhý cíl nemusí být dostupný nebo může být z bezpečnostních důvodů skrytý, například při přechodu klávesou Tab na stránku nebo mimo ni. Před použitím hodnoty ověřte, zda není null; nepředpokládejte ani to, že každý EventTarget je prvkem DOM.
Konstruktor new FocusEvent(type, options) umožňuje nastavit relatedTarget; výchozí hodnota je null. Příklad tuto možnost ověřuje bez závislosti na interakci uživatele. FocusEvent je webové API prohlížeče, nikoli funkce konkrétní edice ECMAScriptu. MDN uvádí, že rozhraní i vlastnost jsou široce dostupné od července 2015; použití Node 24 v repozitáři nedokládá podporu tohoto API.
Příklady
(() => {
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);
})();Výsledek
focus true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.