Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
HTMLElement: attachInternals()-Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2023.
DieHTMLElement.attachInternals()-Methode gibt einElementInternals-Objekt zurück. Diese Methode ermöglicht es einembenutzerdefinierten Element, an HTML-Formularen teilzunehmen. DasElementInternals-Interface bietet Hilfsmittel zum Arbeiten mit diesen Elementen in der gleichen Weise, wie Sie mit einem Standard-HTML-Formularelement arbeiten würden, und stellt auch dasAccessibility Object Model dem Element zur Verfügung.
Syntax
attachInternals()Parameter
Keine.
Rückgabewert
EinElementInternals-Objekt.
Ausnahmen
NotSupportedErrorDOMExceptionAusgelöst, wenn das Element kein benutzerdefiniertes Element ist.
NotSupportedErrorDOMExceptionAusgelöst, wenn die "internals"-Funktion als Teil der Elementdefinition deaktiviert wurde.
NotSupportedErrorDOMExceptionAusgelöst, wenn diese Methode zweimal auf demselben Element aufgerufen wird.
Beispiele
Das folgende Beispiel demonstriert, wie man ein benutzerdefiniertes, formularassoziiertes Element mitHTMLElement.attachInternals erstellt. DieElementInternals.form-Eigenschaft wird dann in die Konsole ausgegeben, um zu zeigen, dass wir einElementInternals-Objekt haben.
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);Spezifikationen
| Specification |
|---|
| HTML # dom-attachinternals |