Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

FocusEvent.relatedTarget — drugi cilj prehoda fokusa

FocusEvent.relatedTarget označuje drugi objekt, ki sodeluje pri prehodu fokusa: prejšnji cilj ob pridobitvi fokusa ali naslednji cilj ob njegovi izgubi. Lastnost je samo za branje in je lahko null.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

event.relatedTarget
new FocusEvent(type, { relatedTarget: otherTarget })

FocusEvent predstavlja dogodke focus, blur, focusin in focusout. Deduje od UIEvent in posredno od Event. Njegova lastnost FocusEvent.relatedTarget opisuje drugi cilj pri prehodu fokusa, ne pa cilja, ki ga označuje event.target.

Pri dogodkih focus in focusin event.target označuje objekt, ki prejme fokus, event.relatedTarget pa objekt, ki ga izgubi. Pri blur in focusout sta vlogi obrnjeni: event.target izgubi fokus, event.relatedTarget pa ga prejme.

relatedTarget je samo za branje in vrne EventTarget ali null. Drugi cilj morda ni na voljo ali je iz varnostnih razlogov skrit, na primer pri prehodu s tipko Tab na stran ali z nje. Pred uporabo preverite, ali je vrednost null; prav tako ne predpostavljajte, da je vsak EventTarget element DOM.

Konstruktor new FocusEvent(type, options) omogoča nastavitev lastnosti relatedTarget; privzeta vrednost je null. Primer preveri to možnost brez odvisnosti od uporabniške interakcije. FocusEvent je spletni API brskalnika, ne funkcija določene izdaje ECMAScripta. MDN označuje vmesnik in lastnost kot široko dostopna od julija 2015; uporaba Node 24 v repozitoriju ne dokazuje podpore za ta API.

Primeri

(() => {
  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);
})();

Rezultat

focus
true
true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri