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