Spec-Zone.ru › HTML

<selectedcontent> Элемент отображения выбранного пункта HTML

Ограниченная доступность

Эта функция не входит в Baseline, поскольку она не работает в некоторых из самых широко используемых браузеров.

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

Экспериментальная функция: это экспериментальная технология
Перед использованием в production внимательно изучите таблицу совместимости браузеров.

Элемент <selectedcontent> HTML используется внутри элемента <select> для отображения содержимого выбранного в данный момент элемента <option> в его первом дочернем элементе <button>. Это позволяет стилизовать все части элемента <select>, называемого «настраиваемым списком выбора».

Атрибуты

Этот элемент включает глобальные атрибуты.

Описание

Элемент <selectedcontent> используется как единственный дочерний элемент элемента <button>, который должен быть первым дочерним элементом элемента <select>. Любой элемент <option> — единственный другой допустимый дочерний элемент <select> — должен располагаться после пары из <button> и вложенного <selectedcontent>.

<select>
  <button>
    <selectedcontent></selectedcontent>
  </button>
  <option></option>
  ...
</select>

Как <selectedcontent> работает «за кулисами»

Элемент <selectedcontent> содержит клон содержимого выбранного в данный момент элемента <option>. Браузер отображает этот клон с помощью cloneNode(). Когда выбранный <option> меняется, например при возникновении события change, содержимое <selectedcontent> заменяется клоном нового выбранного <option>. Важно учитывать такое поведение, особенно при работе с динамическим содержимым.

Предупреждение: поскольку браузер обновляет <selectedcontent> только при изменении выбранного <option>, динамические изменения содержимого выбранного <option> после отображения <select> не будут скопированы в <selectedcontent>. Вам потребуется обновить <selectedcontent> вручную. Будьте внимательны, если используете популярные JavaScript-фреймворки для фронтенда, в которых элементы <option> динамически обновляются после первоначального отображения: результат может отличаться от ожидаемого в <selectedcontent>.

Неактивность <selectedcontent>

По умолчанию любой <button> внутри элемента <select> является неактивным. Поэтому всё содержимое этой кнопки, включая <selectedcontent>, также неактивно. Это означает, что пользователи не могут взаимодействовать с содержимым внутри <selectedcontent> или переводить на него фокус.

Стилизация содержимого выбранного пункта с помощью CSS

Можно выбрать содержимое текущего выбранного элемента <option> и задать его внешний вид внутри кнопки списка выбора. Стилизация кнопки не влияет на стилизацию скопированного содержимого <option>. Благодаря этому можно настроить отображение выбранного пункта в кнопке независимо от его отображения в раскрывающемся списке.

Например, элементы <option> могут содержать значки, изображения или даже видео, которые хорошо смотрятся в раскрывающемся списке, но могут увеличить размер списка выбора <button>, сделать его неопрятным и повлиять на окружающую разметку. Выбрав содержимое внутри <selectedcontent>, можно скрыть в кнопке такие элементы, как изображения, не меняя их отображение в раскрывающемся списке, как показано в следующем фрагменте:

selectedcontent img {
  display: none;
}

Примечание: если элементы <button> и/или <selectedcontent> не находятся внутри <select>, браузер создаёт неявный <button> для отображения содержимого выбранного <option>. На эту резервную кнопку нельзя воздействовать с помощью CSS, используя селектор типа button или selectedcontent.

Примеры

Полный пример с элементом <selectedcontent> приведён в руководстве «Настраиваемые элементы выбора».

Техническая сводка

Категории содержимого Нет
Допустимое содержимое Отражает содержимое выбранного элемента <option>.
Опускание тегов Не допускается: обязательны и открывающий, и закрывающий теги.
Допустимые родители Элемент <button>, являющийся первым дочерним элементом элемента <select>.
Неявная роль ARIA Нет
Допустимые роли ARIA Нет
Интерфейс DOM HTMLSelectedContentElement

Спецификации

Спецификация
HTML>
# the-selectedcontent-element>

Совместимость с браузерами

Настольные компьютеры Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari для iOS Samsung Internet WebView Android WebView для iOS
selectedcontent 135 135 Нет 120 Нет 135 Нет 89 Нет 29.0 135 Нет

См. также

  • Элемент <select>
  • Элемент <option>
  • Элемент <optgroup>
  • Настраиваемые элементы выбора

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/selectedcontent

Spec-Zone.ru

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