Сравнивает данный узел с узлом, переданным в качестве параметра, для определения позиции относительно документа.
Синтаксис
СравнитьПозициюВДокументе(<Узел>)Полное описание, параметры и ограничения
ТекстHTML.СравнитьПозициюВДокументе (HTMLText.CompareDocumentPosition)
ТекстHTML (HTMLText)
СравнитьПозициюВДокументе (CompareDocumentPosition)
Доступен, начиная с версии 8.2.
Синтаксис:
СравнитьПозициюВДокументе(<Узел>)
Параметры:
<Узел> (обязательный)
Тип: АтрибутHTML, ЭлементHTML, ЭлементКнопкаHTML, ЭлементВводаHTML, ЭлементЗаголовокHTML, ЭлементРазметкаHTML, ЭлементПлавающийФреймHTML, ЭлементВставкаHTML, ЭлементФреймHTML, ЭлементНаборФреймовHTML, ЭлементМетаHTML, ЭлементОбъектHTML, ЭлементСкриптHTML, ЭлементТаблицаHTML, ЭлементСтрокаТаблицыHTML, ЭлементЯчейкаТаблицыHTML, ЭлементКолонкаТаблицыHTML, ЭлементЗаголовокТаблицыHTML, ЭлементБлокHTML, ЭлементЛинияHTML, ЭлементФорматированногоТекстаHTML, ЭлементКартинкаHTML, ЭлементСвязьHTML, ЭлементЯкорьHTML, ЭлементАплетHTML, ЭлементФормаHTML, ДокументHTML, ТекстHTML, КомментарийHTML.
Узел HTMLDOM, с которым происходит сравнение.
Описание:
Сравнивает данный узел с узлом, переданным в качестве параметра, для определения позиции относительно документа.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Текстовые узлы: вызов сравнения без изменения текста
ТекстHTML получается из содержимого собственных span, а не из конструктора текстового DOM другого типа.
Где и как запускать
Синтаксический пример для серверного обработчика или толстого клиента. ЧтениеHTML и ПостроительDOM разбирают собственную строку в память; это не открытие страницы в браузере. Здесь код не выполнялся.
Подготовка
Оба span содержат ровно свой непустой текст. В строке нет пробела перед текстом внутри этих элементов.
Чтение = Новый ЧтениеHTML;
Чтение.УстановитьСтроку("<html><body><span id=""first"">Книга</span><span id=""second"">Тетрадь</span></body></html>");
Построитель = Новый ПостроительDOM;
Документ = Построитель.Прочитать(Чтение);
Чтение.Закрыть();
ПервыйТекст = Документ.ПолучитьЭлементПоИдентификатору("first").ПервыйДочерний;
ВторойТекст = Документ.ПолучитьЭлементПоИдентификатору("second").ПервыйДочерний;
ПервыйТекст.СравнитьПозициюВДокументе(ВторойТекст);
Сообщить(ПервыйТекст.ЗначениеУзла);
Сообщить(ВторойТекст.ЗначениеУзла);Разбор по шагам
Разберите собственную строку.
Получите первые дочерние текстовые узлы span.
Вызовите сравнение и покажите оставшийся исходный текст.
Как проверить результат
Выводятся Книга и Тетрадь, а не подставленный код позиции.
Сравнение не меняет текст и не создаёт дочерних узлов у текста.
Ожидаемый результат
Приведён короткий пример синтаксиса и его ограничения. Здесь он не запускался в 1С; выполните проверки в своём учебном контексте.
На что обратить внимание
В установленной справке СравнитьПозициюВДокументе не указан тип возвращаемого значения. Поэтому вызовы показаны без присваивания результата; числовые маски, конкретные коды и успешный результат здесь не выдумываются.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.