Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori