Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri