Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

is — estender um elemento HTML integrado

O atributo is identifica uma definição de elemento personalizado que estende um elemento HTML integrado. O elemento mantém a semântica e o comportamento nativos e recebe funcionalidades definidas pelo autor.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<button is="demo-button" type="button">Demo</button>

O atributo is cria um elemento integrado personalizado (customized built-in element). O seu valor tem de ser um nome válido de elemento personalizado que contenha um hífen, como demo-button. Não é um atributo booleano.

A classe estende a interface adequada, como HTMLButtonElement, e o registo através de customElements.define() indica { extends: "button" }. O nome da etiqueta base tem de corresponder a extends. O elemento mantém button como valor de localName, a semântica nativa de um botão e o suporte para disabled.

Um elemento autónomo utiliza o seu próprio nome de etiqueta; is não deve ser especificado nele e não aplicará aí qualquer extensão. Alterar ou adicionar is através de setAttribute() depois da criação não altera o tipo do elemento. Para o criar por programação, utilize document.createElement("button", { is: "demo-button" }).

O exemplo regista a definição depois de o botão ter sido analisado, fazendo com que este seja atualizado. No entanto, os elementos integrados personalizados não são suportados por todos os browsers; verifique os ambientes de destino.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>is example</title>
<button is="demo-button" type="button" id="demo">Demo</button>
<script>
class DemoButton extends HTMLButtonElement {
  message() {
    return "custom behavior";
  }
}
customElements.define("demo-button", DemoButton, { extends: "button" });
const button = document.getElementById("demo");
console.log(button.localName);
console.log(button instanceof DemoButton);
console.log(button.message());
</script>
</html>

Resultado

button
true
custom behavior

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes