База знанияИзпитен център
BGБългарски
Избери език13

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

Източници