Метод ВставитьПеред объекта ЭлементФорматированногоТекстаHTML

[1cwiki]

Раздел

Общие объекты

Подразделы

HTML

ИмяОбъекта

ЭлементФорматированногоТекстаHTML

ТипСтатьи

Методы

ЭлементФорматированногоТекстаHTML.ВставитьПеред (HTMLPreElement.InsertBefore)
ЭлементФорматированногоТекстаHTML (HTMLPreElement)
ВставитьПеред (InsertBefore)
Синтаксис:
ВставитьПеред(<НовыйУзел>, <Узел>)
Параметры:
<НовыйУзел> (обязательный)
Тип: ЭлементФорматированногоТекстаHTML.
Вставляемый узел HTML.
<Узел> (необязательный)
Тип: ЭлементФорматированногоТекстаHTML.
Узел, перед которым необходимо вставить узел, заданный в параметре <НовыйУзел>. Если параметр не задан, то узел добавляется к концу списка дочерних узлов.
Возвращаемое значение:
Тип: ЭлементФорматированногоТекстаHTML.

Описание:
Вставляет узел в список дочерних перед существующим дочерним узлом, заданным параметром <Узел>.
Если вставляемый узел является узлом ФрагментДокумента, то все его дочерние узлы будут вставлены перед узлом, заданным параметром <Узел>, в том же порядке. Если узел, заданный параметром <НовыйУзел>, уже содержится в дереве документа, то он сначала удаляется из дочерних узлов прежнего родителя и вставляется в список дочерних узлов нового родителя.

Доступность:
Тонкий клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение(клиент), мобильное приложение(сервер).
Примечание:
Причины вызова исключения:
данный узел не допускает в качестве дочерних добавляемый узел или добавляемый узел является одним из предков данного или узел добавляется сам в себя или данный узел Документ и добавляется второй узел ОпределениеТипаДокумента или Элемент;
добавляемый узел был создан документом отличным от создавшего данный узел;
данный узел в режиме Только для чтения или если предыдущий родитель добавляемого узла в режиме Только для чтения;
узел, перед которым осуществляется вставка, не найден.