Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje