CKTIS / JavaScript
Construtor de HTMLElement
`HTMLElement` é a classe base dos elementos personalizados autónomos. O seu construtor é invocado com `super()` numa subclasse, não diretamente com `new HTMLElement()`.
Versão: Current web platform; runtime support varies
Sintaxe
class StatusBadge extends HTMLElement {
constructor() {
super();
// Initialize instance state here.
}
}
customElements.define("cktis-status-badge", StatusBadge);
new StatusBadge();
document.createElement("cktis-status-badge");O construtor de HTMLElement pertence a uma interface da plataforma Web exposta em Window; não faz parte dos elementos nativos de ECMAScript. A sintaxe de classes foi introduzida no ECMAScript 2015, mas é o navegador que disponibiliza o algoritmo de construção de elementos HTML e o registo de elementos personalizados. Tanto new HTMLElement() como HTMLElement() lançam um TypeError. Para criar um elemento HTML comum, usa document.createElement("div").
Para definir um elemento personalizado autónomo, escreve uma classe com extends HTMLElement e regista-a com customElements.define(), usando um nome válido que contenha um hífen. Se escreveres um constructor, a primeira instrução deve ser super() sem argumentos, antes de usares this. O JavaScript passa new.target ao construtor base, e a plataforma procura a definição pela identidade do construtor, não por um nome passado a super(). Usar new com uma subclasse não registada lança um TypeError ao chegar a super().
Após o registo, new StatusBadge() e document.createElement("cktis-status-badge") criam, cada um, uma nova instância no espaço de nomes HTML, sem a inserir no documento. Quando um elemento existente é atualizado para a classe registada, super() disponibiliza esse mesmo nó como this. Inicializa o estado da instância no construtor, sem ler nem adicionar atributos ou nós filhos. Deixa para connectedCallback() as tarefas que exigem que o elemento esteja ligado ao documento; o método pode ser executado mais do que uma vez.
Um elemento incorporado personalizado requer a interface correspondente, como HTMLButtonElement, e a opção de registo { extends: "button" }. O suporte varia consoante o ambiente de execução: a conformidade com ECMAScript, por si só, não disponibiliza estas API do DOM, e o suporte para elementos autónomos não implica suporte para elementos incorporados personalizados.
Exemplos
<!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>Resultado
TypeError TypeError cktis-status-badge true ready false cktis-status-badge true ready false
As duas primeiras linhas mostram que falham tanto a construção direta como a construção da subclasse antes do registo. Após o registo, ambos os métodos produzem uma instância de `StatusBadge` com o estado `ready` que ainda não está ligada ao documento (`false`). Recarrega a página do exemplo no navegador para o executar novamente.
Lições relacionadas
- JavaScript · Lição 38 · Intermédio · Versão: 3
- JavaScript · Lição 39 · Intermédio · Versão: 3