CKTIS / JavaScript
Конструктор на HTMLElement
`HTMLElement` е базовият клас за автономни потребителски елементи. Неговият конструктор се извиква чрез `super()` в производен клас, а не директно с `new HTMLElement()`.
Версия: Current web platform; runtime support varies
Синтаксис
class StatusBadge extends HTMLElement {
constructor() {
super();
// Initialize instance state here.
}
}
customElements.define("cktis-status-badge", StatusBadge);
new StatusBadge();
document.createElement("cktis-status-badge");Конструкторът на HTMLElement е част от интерфейс на уеб платформата, достъпен чрез Window, а не вградена част от ECMAScript. Синтаксисът на класовете е въведен в ECMAScript 2015, но алгоритъмът за конструиране на HTML елементи и регистърът на потребителските елементи се предоставят от браузъра. И new HTMLElement(), и HTMLElement() хвърлят изключение TypeError. За да създадеш обикновен HTML елемент, използвай document.createElement("div").
За автономен потребителски елемент напиши клас с extends HTMLElement и го регистрирай чрез customElements.define() с валидно име, съдържащо тире. Ако пишеш собствен constructor, първата инструкция трябва да е super() без аргументи, преди да използваш this. JavaScript предава new.target на базовия конструктор, а платформата намира дефиницията по идентичността на конструктора, а не по име, подадено на super(). При използване на new с нерегистриран производен клас super() хвърля изключение TypeError.
След регистрацията new StatusBadge() и document.createElement("cktis-status-badge") създават по една нова инстанция в именното пространство на HTML, без да я вмъкват в документа. При надграждане на съществуващ елемент до регистрирания клас super() предоставя същия възел като this. В конструктора задай началното състояние на инстанцията, но не чети и не добавяй атрибути или дъщерни възли. Операциите, които изискват елементът да е свързан с документа, постави в connectedCallback(), който може да се изпълни повече от веднъж.
Персонализираният вграден елемент изисква съответния интерфейс, например HTMLButtonElement, и опцията { extends: "button" } при регистрация. Поддръжката зависи от средата за изпълнение: съответствието с ECMAScript само по себе си не осигурява тези DOM интерфейси, а поддръжката на автономни елементи не означава поддръжка на персонализирани вградени елементи.
Примери
<!doctype html>
<meta charset="utf-8">
<title>HTMLElement constructor</title>
<script>
{
class StatusBadge extends HTMLElement {
constructor() {
super();
this.status = "ready";
}
}
for (const create of [() => new HTMLElement(), () => new StatusBadge()]) {
try {
create();
} catch (error) {
console.log(error.name);
}
}
customElements.define("cktis-status-badge", StatusBadge);
for (const badge of [new StatusBadge(), document.createElement("cktis-status-badge")]) {
console.log(`${badge.localName} ${badge instanceof StatusBadge} ${badge.status} ${badge.isConnected}`);
}
}
</script>Резултат
TypeError TypeError cktis-status-badge true ready false cktis-status-badge true ready false
Първите два реда показват, че както директното създаване, така и създаването на инстанция на производния клас преди регистрация са неуспешни. След регистрацията и двата начина създават инстанция на `StatusBadge` със състояние `ready`, която още не е свързана с документа (`false`). За да изпълниш примера отново, презареди страницата му в браузъра.
Свързани уроци
- JavaScript · Урок 38 · Средно · Версия: 3
- JavaScript · Урок 39 · Средно · Версия: 3