Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje