HTMLElement : méthode attachInternals()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2023.
La méthode attachInternals() de l'interface HTMLElement retourne un objet ElementInternals.
Cette méthode permet à un élément personnalisé de participer aux formulaires HTML. L'interface ElementInternals fournit des outils pour travailler avec ces éléments de la même manière qu'avec n'importe quel élément de formulaire HTML standard, et expose également le modèle d'objet d'accessibilité (angl.) à l'élément.
Syntaxe
attachInternals()
Paramètres
Aucun.
Valeur de retour
Un objet ElementInternals.
Exceptions
NotSupportedErrorDOMException-
Levée si l'élément n'est pas un élément personnalisé.
NotSupportedErrorDOMException-
Levée si la fonctionnalité « internals » a été désactivée lors de la définition de l'élément.
NotSupportedErrorDOMException-
Levée si cette méthode est appelée deux fois sur le même élément.
Exemples
L'exemple suivant montre comment créer un élément personnalisé associé à un formulaire avec HTMLElement.attachInternals. La propriété ElementInternals.form est ensuite affichée dans la console pour démontrer que nous avons bien un objet ElementInternals.
class CustomCheckbox extends HTMLElement {
static formAssociated = true;
constructor() {
super();
this.internals_ = this.attachInternals();
}
// …
}
window.customElements.define("custom-checkbox", CustomCheckbox);
let element = document.getElementById("custom-checkbox");
console.log(element.internals_.form);
Spécifications
| Specification |
|---|
| HTML # dom-attachinternals |