CKTIS / JavaScript
customElements.define — registracija elementa po meri
customElements.define poveže ime elementa s konstruktorjem v registru dokumenta. Spoznajte razliko med samostojnimi elementi po meri in prilagojenimi vgrajenimi elementi ter glavne omejitve registracije.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
customElements.define(name, constructor);
customElements.define(name, constructor, { extends: baseLocalName });customElements.define(name, constructor, options) registrira definicijo v registru, dostopnem prek window.customElements, in vrne undefined, ne pa instance ali obljube. To je API standarda HTML Living Standard, ne funkcija določene izdaje ECMAScript. Sodobni brskalniški pogoni podpirajo samostojne elemente po meri; prisotnost Node 24 v repozitoriju ne dokazuje, da je ta API na voljo.
Samostojni element uporablja razred, ki razširja HTMLElement. Preprosto veljavno ime, na primer cktis-greeting, se začne z malo črko ASCII, vsebuje vezaj in ne vsebuje velikih črk ASCII; nekatera imena so tudi rezervirana. Registracija omogoča ustvarjanje instanc in nadgradnjo ustreznih elementov, ki so že v dokumentu. Sama ne vstavi novega elementa v DOM.
Različica { extends: "button" } določa prilagojeni vgrajeni element: njegov razred razširja HTMLButtonElement, instanca pa se ustvari z document.createElement("button", { is: name }), ne z document.createElement(name). Podporo za to različico posebej preverite v ciljnih brskalnikih.
Neveljavno ime povzroči SyntaxError, ponovna uporaba imena ali konstruktorja v istem registru pa NotSupportedError; oboje so izjeme DOMException. Argument, ki ni konstruktor, povzroči TypeError. Primer nastavi vsebino v connectedCallback, ko je element že dodan; v konstruktor ne dodajajte otrok ali atributov. Pred ponovnim zagonom znova naložite dokument: odstranitev instance ne odstrani njene definicije.
Primeri
(() => {
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();
})();Rezultat
Hello! true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.