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.
Die HTMLElement.attachInternals()-Methode gibt ein ElementInternals-Objekt zurück. Diese Methode ermöglicht es einem benutzerdefinierten Element, an HTML-Formularen teilzunehmen. Das ElementInternals-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 das Accessibility Object Model dem Element zur Verfügung.
Syntax
attachInternals() Parameter
Keine.
Rückgabewert
Ein ElementInternals-Objekt.
Ausnahmen
NotSupportedErrorDOMException-
Ausgelöst, wenn das Element kein benutzerdefiniertes Element ist.
NotSupportedErrorDOMException-
Ausgelöst, wenn die "internals"-Funktion als Teil der Elementdefinition deaktiviert wurde.
NotSupportedErrorDOMException-
Ausgelöst, wenn diese Methode zweimal auf demselben Element aufgerufen wird.
Beispiele
Das folgende Beispiel demonstriert, wie man ein benutzerdefiniertes, formularassoziiertes Element mit HTMLElement.attachInternals erstellt. Die ElementInternals.form-Eigenschaft wird dann in die Konsole ausgegeben, um zu zeigen, dass wir ein ElementInternals-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 |
Browser-Kompatibilität
Loading…