CKTIS / JavaScript
Web Components: потребителски елементи и жизнен цикъл
Web Components са механизми на уеб платформата за създаване на потребителски елементи на интерфейса. Научете как се регистрира клас, който наследява HTMLElement, как се реагира на свързване и разкачване и как се наблюдават атрибути. Това са API на браузъра, а не функции на самия ECMAScript.
Версия: 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.
Синтаксис
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 обхващат потребителски елементи (custom elements), Shadow DOM, както и шаблони и слотове. Тези механизми могат да се комбинират, но потребителският елемент не изисква Shadow DOM. Самостоятелният потребителски елемент е екземпляр на клас, който наследява HTMLElement. Методът customElements.define() регистрира конструктора на този клас под името на елемента. Валидното име трябва да съдържа тире, например cktis-greeting.
В конструктора извикайте super() преди да използвате this; там може да се създаде shadow root чрез attachShadow(). connectedCallback() обработва свързването с документа, а disconnectedCallback() — разкачването. Свързването може да се случва многократно: не дублирайте слушатели или таймери и освобождавайте външните ресурси при разкачване. Shadow DOM капсулира структурата и стиловете, но не е граница за сигурност.
Статичното observedAttributes задава имената на наблюдаваните атрибути. attributeChangedCallback(name, oldValue, newValue) реагира на добавянето, промяната или премахването им; може да се изпълни преди елементът да е свързан. Липсваща стойност се представя с null. Промяната на обикновено JavaScript свойство не променя автоматично атрибут. Примерът използва textContent, за да показва текст, без да го интерпретира като HTML.
Посочените източници са съсредоточени върху потребителските елементи и HTMLElement: стандартът HTML на WHATWG дефинира потребителските елементи, а документацията на MDN описва HTMLElement и обяснява как се използват потребителските елементи. Точният изход на примера в конзолата е проверен само в изолирана инстанция на Chromium 157.0.8103.51. Това не потвърждава съвместимост с други браузъри или версии; проверете дали целевите браузъри поддържат тези API. Нито едно отделно издание на ECMAScript не гарантира Web Components; Node 24 в хранилището също не доказва наличността на API. Примерът изисква среда на браузър.
Примери
(() => {
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();
})();Резултат
Hello, world! Hello, Ada! disconnected
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.