HTMLElement: метод attachInternals()
Базовая версия 2023
Новое
С марта 2023 года эта функция работает на последних устройствах и версиях браузеров. Возможно, эта функция не будет работать на старых устройствах или браузерах.
Метод HTMLElement.attachInternals() возвращает объект ElementInternals. Этот метод позволяет пользовательскому элементу участвовать в HTML-формах. Интерфейс ElementInternals предоставляет утилиты для работы с этими элементами так же, как с любым стандартным элементом HTML-формы, а также предоставляет Accessibility Object Model для элемента.
Синтаксис
attachInternals()
Параметры
Нет.
Возвращаемое значение
Объект ElementInternals.
Исключения
-
NotSupportedErrorDOMException -
Выбрасывается, если элемент не является пользовательским элементом.
-
NotSupportedErrorDOMException -
Выбрасывается, если функция "internals" была отключена в определении элемента.
-
NotSupportedErrorDOMException -
Выбрасывается, если этот метод вызывается дважды для одного и того же элемента.
Примеры
В следующем примере показано, как создать пользовательский элемент, связанный с формой, с помощью HTMLElement.attachInternals. Затем свойство ElementInternals.form выводится в консоль, чтобы продемонстрировать, что у нас есть объект 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);
Спецификации
| Спецификация |
|---|
| HTML # dom-attachinternals |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
attachInternals |
77 | 79 | 93 | 64 | 16.4 | 77 | 93 | 55 | 16.4 | 12.0 | 77 |
См. также
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/attachInternals