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

CKTIS / JavaScript

CustomEvent: údaje v detail a bublanie s bubbles

Pomocou `detail` odovzdaj údaje vo vlastnej udalosti a pomocou `bubbles` umožni, aby ju po cieľovej fáze prijali poslucháče na predkoch zaregistrované bez zachytávania.

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

Syntax

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

new CustomEvent(type, options) vytvorí udalosť DOM. V názve udalosti type záleží na veľkosti písmen. Argument options je voliteľný. Vytvorením sa udalosť nevyšle: zavolaj target.dispatchEvent(event), ktoré spustí príslušné poslucháče synchrónne ešte pred návratom z volania.

detail a bubbles majú nezávislé úlohy. detail nesie údaje a jeho predvolená hodnota je null. Poslucháče čítajú údaje cez vlastnosť event.detail, ktorá je len na čítanie. Môžeš odovzdať primitívnu hodnotu alebo objekt. Objekt sa nekopíruje ani nezmrazuje: poslucháče dostanú ten istý objekt a môžu meniť jeho meniteľné vlastnosti.

Predvolená hodnota voľby bubbles je false. bubbles: true zapne fázu bublania: po cieľovej fáze sa udalosť môže dostať k poslucháčom na predkoch, ak sa šírenie nezastavilo. Vlastnosť event.bubbles je len na čítanie a dedí sa z Event. Hodnota false nevypína poslucháče na cieli ani poslucháče na predkoch registrované na fázu zachytávania (capture: true).

stopPropagation() zastaví ďalšie šírenie. Nezávisle od toho cancelable určuje, či možno udalosť zrušiť pomocou preventDefault(). Aby udalosť vyslaná vnútri stromu shadow DOM mohla vybublať aj mimo neho, nastav aj composed: true (predvolene false). Udalosť vyslaná skriptom má isTrusted rovné false; nepovažuj ju za dôkaz akcie používateľa. CustomEvent je API DOM, nie súčasť ECMAScriptu 2024. Dostupnosť závisí od behového prostredia.

Príklady

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

Výsledok

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

Spusti blok v Node.js 24 alebo v konzole prehliadača. V prehliadači nie sú prvky pripojené k dokumentu, ale `child` má rodiča a uplatní sa natívne bublanie DOM. V Node.js kód výslovne odovzdá udalosť cieľu `parent`, aby napodobnil tento jeden krok bublania. V oboch prostrediach `child` prijme obe udalosti; poslucháč bez zachytávania na `parent` prijme len druhú, so `score: 2`.

Súvisiace lekcie

  • JavaScript · Lekcia 43 · Pokročilá · Verzia: 4

Zdroje