Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

FocusEvent.relatedTarget — drugi cilj prijelaza fokusa

FocusEvent.relatedTarget označava drugi objekt uključen u prijelaz fokusa: prethodni cilj pri dobivanju fokusa ili sljedeći cilj pri njegovu gubitku. Svojstvo je samo za čitanje i može biti null.

Verzija: 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 događaje focus, blur, focusin i focusout. Nasljeđuje od UIEvent i posredno od Event. Njegovo svojstvo FocusEvent.relatedTarget opisuje drugi cilj prijelaza fokusa, a ne cilj koji označava event.target.

Kod događaja focus i focusin, event.target označava objekt koji dobiva fokus, a event.relatedTarget objekt koji ga gubi. Kod događaja blur i focusout uloge su obrnute: event.target gubi fokus, a event.relatedTarget ga dobiva.

relatedTarget je samo za čitanje i vraća EventTarget ili null. Drugi cilj možda nije dostupan ili je skriven iz sigurnosnih razloga, primjerice pri prelasku tipkom Tab na stranicu ili sa stranice. Prije upotrebe provjerite je li vrijednost null; nemojte pretpostaviti ni da je svaki EventTarget DOM element.

Konstruktor new FocusEvent(type, options) omogućuje postavljanje svojstva relatedTarget; zadana je vrijednost null. Primjer provjerava tu mogućnost bez oslanjanja na interakciju korisnika. FocusEvent je web-API preglednika, a ne značajka određenog izdanja ECMAScripta. MDN navodi da su sučelje i svojstvo široko dostupni od srpnja 2015.; upotreba Node 24 u repozitoriju ne potvrđuje podršku za ovaj API.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori