CKTIS / JavaScript
Web Components: własne elementy i cykl życia
Web Components to mechanizmy platformy WWW służące do budowania własnych elementów interfejsu. Poznaj rejestrację klasy dziedziczącej po HTMLElement, reakcje na podłączenie i odłączenie elementu oraz obserwowanie atrybutów. Są to interfejsy przeglądarki, a nie funkcje samego ECMAScript.
Wersja: Web-platform APIs, not tied to an ECMAScript edition. The example's exact console output was verified in isolated Chromium 157.0.8103.51 only; this does not establish broader browser compatibility. Node 24 in the repository does not establish browser API support.
Składnia
class ExampleElement extends HTMLElement {
static get observedAttributes() { return ['label']; }
connectedCallback() { /* initialize or resume */ }
disconnectedCallback() { /* release external resources */ }
attributeChangedCallback(name, oldValue, newValue) { /* react to an observed attribute */ }
}
customElements.define('example-element', ExampleElement);Web Components obejmują własne elementy (custom elements), Shadow DOM oraz szablony i sloty. Mechanizmy te można łączyć, ale własny element nie musi mieć Shadow DOM. Autonomiczny własny element to instancja klasy dziedziczącej po HTMLElement. Metoda customElements.define() rejestruje konstruktor tej klasy pod nazwą elementu. Prawidłowa nazwa musi zawierać łącznik, jak cktis-greeting.
W konstruktorze wywołaj super() przed użyciem this; można tam utworzyć shadow root przez attachShadow(). connectedCallback() obsługuje podłączenie do dokumentu, a disconnectedCallback() — odłączenie. Podłączenie może następować wielokrotnie: nie dubluj nasłuchiwaczy ani timerów, a przy odłączeniu zwalniaj zasoby zewnętrzne. Shadow DOM zapewnia enkapsulację struktury i stylów, nie granicę bezpieczeństwa.
Statyczne observedAttributes określa nazwy obserwowanych atrybutów. attributeChangedCallback(name, oldValue, newValue) reaguje na ich dodanie, zmianę lub usunięcie; może działać przed podłączeniem elementu. Brakująca wartość jest reprezentowana przez null. Zmiana zwykłej właściwości JavaScript nie zmienia automatycznie atrybutu. W przykładzie textContent wyświetla tekst bez interpretowania go jako HTML.
Podane źródła koncentrują się na własnych elementach i HTMLElement: WHATWG HTML Living Standard definiuje własne elementy, a dokumentacja MDN opisuje HTMLElement i wyjaśnia, jak używać własnych elementów. Dokładny wynik przykładu w konsoli sprawdzono wyłącznie w odizolowanej instancji Chromium 157.0.8103.51. Nie potwierdza to zgodności z innymi przeglądarkami ani wersjami; sprawdź obsługę tych API w docelowych przeglądarkach. Nie istnieje jedna edycja ECMAScript gwarantująca Web Components; Node 24 w repozytorium również nie dowodzi dostępności tych API. Przykład wymaga środowiska przeglądarki.
Przykłady
(() => {
class CktisGreeting extends HTMLElement {
static get observedAttributes() {
return ['label'];
}
constructor() {
super();
this.attachShadow({ mode: 'open' });
}
connectedCallback() {
this.render();
}
disconnectedCallback() {
console.log('disconnected');
}
attributeChangedCallback(name, oldValue, newValue) {
if (oldValue !== newValue) this.render();
}
render() {
this.shadowRoot.textContent = `Hello, ${this.getAttribute('label') ?? 'world'}!`;
}
}
if (customElements.get('cktis-greeting')) {
throw new Error('Reload the page before running this example again.');
}
customElements.define('cktis-greeting', CktisGreeting);
const element = document.createElement('cktis-greeting');
document.body.append(element);
console.log(element.shadowRoot.textContent);
element.setAttribute('label', 'Ada');
console.log(element.shadowRoot.textContent);
element.remove();
})();Wynik
Hello, world! Hello, Ada! disconnected
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.