Spec-Zone.ru › Web APIs

HTMLElement: метод attachInternals()

Базовая версия 2023
Новое

С марта 2023 года эта функция работает на последних устройствах и версиях браузеров. Возможно, эта функция не будет работать на старых устройствах или браузерах.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Метод HTMLElement.attachInternals() возвращает объект ElementInternals. Этот метод позволяет пользовательскому элементу участвовать в HTML-формах. Интерфейс ElementInternals предоставляет утилиты для работы с этими элементами так же, как с любым стандартным элементом HTML-формы, а также предоставляет Accessibility Object Model для элемента.

Синтаксис

attachInternals()

Параметры

Нет.

Возвращаемое значение

Объект ElementInternals.

Исключения

NotSupportedError DOMException

Выбрасывается, если элемент не является пользовательским элементом.

NotSupportedError DOMException

Выбрасывается, если функция "internals" была отключена в определении элемента.

NotSupportedError DOMException

Выбрасывается, если этот метод вызывается дважды для одного и того же элемента.

Примеры

В следующем примере показано, как создать пользовательский элемент, связанный с формой, с помощью 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

См. также

  • Более функциональные элементы управления формами
  • Создание пользовательских элементов управления формами с помощью ElementInternals

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API