Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

is — ampliar un elemento HTML integrado

El atributo is identifica una definición de elemento personalizado que amplía un elemento HTML integrado. El elemento conserva su semántica y comportamiento nativos, y añade funciones definidas por el autor.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

El atributo is crea un elemento integrado personalizado (customized built-in element). Su valor debe ser un nombre válido de elemento personalizado que contenga un guion, como demo-button. No es un atributo booleano.

La clase amplía la interfaz adecuada, como HTMLButtonElement, y el registro mediante customElements.define() especifica { extends: "button" }. El nombre de la etiqueta base debe coincidir con extends. El elemento conserva button como valor de localName, la semántica nativa de un botón y la compatibilidad con disabled.

Un elemento autónomo utiliza su propio nombre de etiqueta; no se debe especificar is en él, y el atributo no aplicará ninguna ampliación. Cambiar o añadir is mediante setAttribute() después de crear el elemento no cambia su tipo. Para crearlo mediante código, usa document.createElement("button", { is: "demo-button" }).

El ejemplo registra la definición después de que se haya analizado el botón, por lo que este se actualiza. Sin embargo, no todos los navegadores admiten elementos integrados personalizados; comprueba los entornos de destino.

Ejemplos

<!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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes