Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

is — étendre un élément HTML intégré

L’attribut is désigne une définition d’élément personnalisé qui étend un élément HTML intégré. L’élément conserve sa sémantique et son comportement natifs, tout en gagnant des fonctionnalités définies par l’auteur.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

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

L’attribut is permet de créer un élément intégré personnalisé (customized built-in element). Sa valeur doit être un nom d’élément personnalisé valide contenant un trait d’union, par exemple demo-button. Ce n’est pas un attribut booléen.

La classe étend l’interface appropriée, telle que HTMLButtonElement, et l’enregistrement avec customElements.define() fournit { extends: "button" }. Le nom de la balise de base doit correspondre à extends. L’élément conserve button comme valeur de localName, la sémantique native d’un bouton et la prise en charge de disabled.

Un élément autonome utilise son propre nom de balise ; is ne doit pas y être spécifié et n’y appliquera aucune extension. Modifier ou ajouter is avec setAttribute() après la création ne change pas le type de l’élément. Pour une création programmatique, utilisez document.createElement("button", { is: "demo-button" }).

L’exemple enregistre la définition après l’analyse du bouton, ce qui entraîne sa mise à niveau. Toutefois, les éléments intégrés personnalisés ne sont pas pris en charge par tous les navigateurs ; vérifiez les environnements ciblés.

Exemples

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

Résultat

button
true
custom behavior

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources