CKTIS / JavaScript
Konstruktor HTMLElement
`HTMLElement` jest klasą bazową autonomicznych elementów niestandardowych. Jej konstruktor wywołuje się przez `super()`, a nie bezpośrednio przez `new HTMLElement()`.
Wersja: Current web platform; runtime support varies
Składnia
class StatusBadge extends HTMLElement {
constructor() {
super();
// Initialize instance state here.
}
}
customElements.define("cktis-status-badge", StatusBadge);
new StatusBadge();
document.createElement("cktis-status-badge");Konstruktor HTMLElement należy do interfejsu platformy webowej dostępnego w Window, a nie do wbudowanych mechanizmów ECMAScript. Składnia klas pochodzi z ECMAScript 2015, ale algorytm konstruktora elementów HTML i rejestr elementów niestandardowych zapewnia przeglądarka. Zarówno new HTMLElement(), jak i HTMLElement() zgłaszają TypeError. Aby utworzyć zwykły element HTML, użyj document.createElement("div").
Dla autonomicznego elementu niestandardowego utwórz klasę extends HTMLElement i zarejestruj ją za pomocą customElements.define(), podając poprawną nazwę z łącznikiem. Jeśli piszesz własny constructor, zacznij od super() bez argumentów, zanim użyjesz this. JavaScript przekazuje new.target do konstruktora bazowego, a platforma wyszukuje definicję według konstruktora klasy, nie według nazwy przekazanej do super(). Próba wykonania new na niezarejestrowanej podklasie zgłasza TypeError, gdy wykonanie dociera do super().
Po rejestracji zarówno new StatusBadge(), jak i document.createElement("cktis-status-badge") tworzą nową instancję w przestrzeni nazw HTML, bez wstawiania jej do dokumentu. Podczas aktualizacji istniejącego elementu do zarejestrowanej klasy super() udostępnia ten sam węzeł jako this. W konstruktorze inicjalizuj stan instancji; nie odczytuj ani nie dodawaj atrybutów ani węzłów potomnych. Prace wymagające podłączenia do dokumentu przenieś do connectedCallback(), które może wykonać się wielokrotnie.
Element niestandardowy rozszerzający wbudowany element HTML wymaga pasującego interfejsu, np. HTMLButtonElement, oraz opcji { extends: "button" } przy rejestracji. Obsługa zależy od środowiska; sama zgodność z ECMAScript nie zapewnia tych interfejsów DOM, a obsługa elementów autonomicznych nie oznacza obsługi rozszerzeń elementów wbudowanych.
Przykłady
<!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>Wynik
TypeError TypeError cktis-status-badge true ready false cktis-status-badge true ready false
Dwa pierwsze wiersze pokazują nieudaną próbę bezpośredniego utworzenia `HTMLElement` i utworzenia instancji podklasy przed rejestracją. Po rejestracji obie metody tworzą instancję `StatusBadge` ze stanem `ready`, jeszcze niepodłączoną do dokumentu (`false`). Aby powtórzyć przykład, odśwież jego stronę w przeglądarce.
Powiązane lekcje
- JavaScript · Lekcja 38 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 39 · Średniozaawansowany · Wersja: 3