Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

CustomEvent: podaci u detail i uzlazna propagacija uz bubbles

Upotrijebi `detail` za prijenos podataka u prilagođenom događaju, a `bubbles` kako bi ga nakon ciljne faze mogli primiti slušatelji na precima koji nisu registrirani za hvatanje.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

new CustomEvent(type)
new CustomEvent(type, { detail: payload, bubbles: true })
event.detail
event.bubbles
target.dispatchEvent(event)

new CustomEvent(type, options) stvara događaj DOM-a. type je naziv događaja u kojem se razlikuju velika i mala slova, a options je neobavezan argument. Stvaranje ne šalje događaj: pozovi target.dispatchEvent(event) da se odgovarajući slušatelji pozovu sinkrono, prije nego što se poziv vrati.

detail i bubbles imaju neovisne uloge. detail sadrži podatke i zadano ima vrijednost null. Slušatelji podatke čitaju putem svojstva event.detail, koje je samo za čitanje. Možeš proslijediti primitivnu vrijednost ili objekt. Objekt se ne kopira niti zamrzava: slušatelji primaju isti objekt i mogu mijenjati njegova promjenjiva svojstva.

Opcija bubbles zadano ima vrijednost false. bubbles: true uključuje fazu uzlazne propagacije: nakon ciljne faze događaj može doći do slušatelja na precima ako propagacija nije zaustavljena. Svojstvo event.bubbles nasljeđuje se iz Event i samo je za čitanje. Vrijednost false ne isključuje slušatelje na cilju ni slušatelje na precima koji su registrirani za fazu hvatanja (capture: true).

stopPropagation() zaustavlja daljnju propagaciju; neovisno o tome, cancelable određuje može li preventDefault() poništiti događaj. Da bi se događaj poslan unutar stabla shadow DOM-a mogao uzlazno širiti izvan njega, postavi i composed: true (zadano false). Događaj poslan skriptom ima isTrusted postavljen na false; nemoj ga smatrati dokazom korisnikove radnje. CustomEvent je API DOM-a, a ne dio ECMAScripta 2024. Dostupnost ovisi o izvršnom okruženju.

Primjeri

{
  const hasDOM = typeof document !== "undefined";
  const parent = hasDOM ? document.createElement("div") : new EventTarget();
  const child = hasDOM ? document.createElement("div") : new EventTarget();
  if (hasDOM) parent.appendChild(child);

  const type = "score-change";
  const lines = [];
  child.addEventListener(type, (event) => {
    lines.push(`child: ${event.detail.score}, bubbles=${event.bubbles}`);
  });
  parent.addEventListener(type, (event) => {
    lines.push(`parent: ${event.detail.score}, bubbles=${event.bubbles}`);
  });

  function dispatchFromChild(event) {
    child.dispatchEvent(event);
    // Without a DOM tree, model just the bubbling step to one parent.
    if (!hasDOM && event.bubbles && !event.cancelBubble) {
      parent.dispatchEvent(event);
    }
  }

  dispatchFromChild(new CustomEvent(type, { detail: { score: 1 } }));
  dispatchFromChild(new CustomEvent(type, {
    detail: { score: 2 },
    bubbles: true,
  }));

  console.log(lines.join("\n"));
}

Rezultat

child: 1, bubbles=false
child: 2, bubbles=true
parent: 2, bubbles=true

Pokreni blok u okruženju Node.js 24 ili u konzoli preglednika. U pregledniku elementi nisu povezani s dokumentom, ali `child` ima roditelja i primjenjuje se ugrađena uzlazna propagacija DOM-a. U okruženju Node.js kôd izričito prosljeđuje događaj cilju `parent` kako bi simulirao taj jedan korak uzlazne propagacije. U oba okruženja `child` prima oba događaja; slušatelj na `parent` koji nije registriran za hvatanje prima samo drugi, sa `score: 2`.

Povezane lekcije

  • JavaScript · Lekcija 43 · Napredno · Verzija: 4

Izvori