CKTIS / JavaScript
FocusEvent.relatedTarget — druhý cieľ zmeny fokusu
FocusEvent.relatedTarget označuje druhý objekt, ktorý sa zúčastňuje na zmene fokusu: predchádzajúci cieľ pri získaní fokusu alebo nasledujúci cieľ pri jeho strate. Vlastnosť je iba na čítanie a môže mať hodnotu null.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.relatedTarget
new FocusEvent(type, { relatedTarget: otherTarget })FocusEvent predstavuje udalosti focus, blur, focusin a focusout. Dedí z UIEvent a nepriamo z Event. Jeho vlastnosť FocusEvent.relatedTarget opisuje druhý cieľ pri zmene fokusu, nie cieľ označený pomocou event.target.
Pri udalostiach focus a focusin označuje event.target objekt, ktorý získava fokus, zatiaľ čo event.relatedTarget označuje objekt, ktorý ho stráca. Pri blur a focusout sú úlohy opačné: event.target fokus stráca a event.relatedTarget ho získava.
relatedTarget je iba na čítanie a vracia EventTarget alebo null. Druhý cieľ nemusí byť dostupný alebo môže byť z bezpečnostných dôvodov skrytý, napríklad pri prechode klávesom Tab na stránku alebo mimo nej. Pred použitím hodnoty skontrolujte, či nie je null; nepredpokladajte ani to, že každý EventTarget je prvkom DOM.
Konštruktor new FocusEvent(type, options) umožňuje nastaviť relatedTarget; predvolená hodnota je null. Príklad túto možnosť overuje bez závislosti od interakcie používateľa. FocusEvent je webové API prehliadača, nie funkcia konkrétnej edície ECMAScriptu. MDN uvádza, že rozhranie aj vlastnosť sú široko dostupné od júla 2015; použitie Node 24 v repozitári nedokazuje podporu tohto API.
Prí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ýsledok
focus true true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.