HTMLOptionsCollection: метод add()

Метод add() интерфейса HTMLOptionsCollection добавляет элемент HTMLOptionElement или HTMLOptGroupElement в этот HTMLOptionsCollection.

Синтаксис

add(item)
add(item, before)

Параметры

item: Элемент HTMLOptionElement или HTMLOptGroupElement.
before Необязательно: Элемент коллекции или числовой индекс (от 0) элемента, перед которым должен быть вставлен item. Если параметр опущен, null, или индекс не существует, новый элемент добавляется в конец коллекции.

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

None (undefined).

Исключения

HierarchyRequestError DOMException: Выбрасывается, если элемент item , переданный методу, является предком элемента, в который он должен быть вставлен.

Описание

По умолчанию метод add() добавляет элемент <option> или <optgroup>, переданный в качестве параметра, в конец коллекции. Можно указать место вставки добавленного <option> или <optgroup> , используя параметр before. Параметр before — это элемент или числовой индекс (от 0) элемента, перед которым должен быть вставлен добавляемый элемент.

Если параметр before имеет значение null или находится вне допустимого диапазона (или опущен), элемент <option> или <optgroup> будет добавлен в конец коллекции, вне любого <optgroup>. Если элемент <option>, на который ссылается параметр before, находится в <optgroup>, добавленный элемент HTMLOptionElement будет в той же группе.

Элемент <optgroup> может содержать только элементы <option> в качестве дочерних узлов. Метод add() успешно добавит элемент HTMLOptGroupElement в конец HTMLOptionsCollection или между элементами <optgroup> . Иными словами, попытка добавить элемент HTMLOptGroupElement перед элементом <option> внутри <optgroup> может без сообщений об ошибке не выполниться, если элемент <option> , на который ссылается параметр before , не является первым элементом <option> в пределах своей <optgroup>.

Примеры

const optionList = document.querySelector("select").options;
const firstOption = document.createElement("option");
firstOption.text = "new item";
optionList.add(firstOption, 0); // added as the first item
optionList.add(optionList[0]); // moves the first item to the end

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

Спецификация
HTML # dom-htmloptionscollection-add-dev

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`add`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	≤37

См. также

© 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/HTMLOptionsCollection/add