CKTIS / JavaScript
customElements.define — registrácia vlastného prvku
customElements.define priradí názov prvku ku konštruktoru v registri dokumentu. Zistite, aký je rozdiel medzi samostatnými vlastnými prvkami a upravenými vstavanými prvkami, a spoznajte hlavné obmedzenia registrácie.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
customElements.define(name, constructor);
customElements.define(name, constructor, { extends: baseLocalName });customElements.define(name, constructor, options) zaregistruje definíciu v registri dostupnom cez window.customElements a vráti undefined, nie inštanciu ani prísľub. Ide o API štandardu HTML Living Standard, nie o funkciu konkrétneho vydania ECMAScriptu. Moderné prehliadačové enginy podporujú samostatné vlastné prvky; prítomnosť Node 24 v repozitári nedokazuje dostupnosť tohto API.
Samostatný prvok používa triedu, ktorá dedí z HTMLElement. Jednoduchý platný názov, napríklad cktis-greeting, sa začína malým písmenom ASCII, obsahuje spojovník a neobsahuje veľké písmená ASCII; niektoré názvy sú tiež rezervované. Registrácia umožňuje vytvárať inštancie a aktualizovať zodpovedajúce prvky, ktoré sa už nachádzajú v dokumente. Sama osebe nevloží nový prvok do DOM.
Variant { extends: "button" } definuje upravený vstavaný prvok: jeho trieda dedí z HTMLButtonElement a inštancia sa vytvára pomocou document.createElement("button", { is: name }), nie pomocou document.createElement(name). Podporu tohto variantu si osobitne overte v cieľových prehliadačoch.
Neplatný názov spôsobí SyntaxError, opätovné použitie názvu alebo konštruktora v tom istom registri spôsobí NotSupportedError; obidve sú výnimky DOMException. Argument, ktorý nie je konštruktorom, spôsobí TypeError. Príklad nastavuje obsah v connectedCallback až po pripojení; do konštruktora nepridávajte potomkov ani atribúty. Pred ďalším spustením dokument znova načítajte: odstránením inštancie sa jej definícia neodstráni.
Príklady
(() => {
class CktisGreeting extends HTMLElement {
connectedCallback() {
this.textContent = "Hello!";
}
}
customElements.define("cktis-greeting", CktisGreeting);
const element = document.createElement("cktis-greeting");
document.body.append(element);
console.log(element.textContent);
console.log(element instanceof CktisGreeting);
element.remove();
})();Výsledok
Hello! true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.