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…