CKTIS / JavaScript
customElements.define — registracija prilagođenog elementa
customElements.define povezuje naziv elementa s konstruktorom u registru dokumenta. Saznajte koja je razlika između samostalnih prilagođenih elemenata i prilagođenih ugrađenih elemenata te koja su glavna ograničenja registracije.
Verzija: 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 definiciju u registru dostupnom putem window.customElements i vraća undefined, a ne instancu ili obećanje. Riječ je o API-ju standarda HTML Living Standard, a ne o značajki određenog izdanja ECMAScripta. Moderni preglednički mehanizmi podržavaju samostalne prilagođene elemente; prisutnost Nodea 24 u repozitoriju ne dokazuje da je ovaj API dostupan.
Samostalni element koristi klasu koja nasljeđuje HTMLElement. Jednostavan valjani naziv, primjerice cktis-greeting, počinje malim ASCII slovom, sadrži crticu i ne sadrži velika ASCII slova; neki su nazivi također rezervirani. Registracija omogućuje stvaranje instanci i nadogradnju odgovarajućih elemenata koji se već nalaze u dokumentu. Sama ne umeće novi element u DOM.
Varijanta { extends: "button" } definira prilagođeni ugrađeni element: njegova klasa nasljeđuje HTMLButtonElement, a instanca se stvara pomoću document.createElement("button", { is: name }), a ne pomoću document.createElement(name). Podršku za ovu varijantu zasebno provjerite u ciljanim preglednicima.
Nevaljan naziv uzrokuje SyntaxError, a ponovna upotreba naziva ili konstruktora u istom registru uzrokuje NotSupportedError; obje su iznimke DOMException. Argument koji nije konstruktor uzrokuje TypeError. Primjer postavlja sadržaj u connectedCallback nakon dodavanja elementa; nemojte dodavati djecu ni atribute u konstruktoru. Ponovno učitajte dokument prije ponovnog pokretanja: uklanjanje instance ne uklanja njezinu definiciju.
Primjeri
(() => {
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.