Сравнивает данный узел с узлом, переданным в качестве параметра, для определения позиции относительно документа.
Синтаксис
СравнитьПозициюВДокументе(<Узел>)Полное описание, параметры и ограничения
ДокументHTML.СравнитьПозициюВДокументе (HTMLDocument.CompareDocumentPosition)
ДокументHTML (HTMLDocument)
СравнитьПозициюВДокументе (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, head и span — разные настоящие узлы одного дерева.
Где и как запускать
Синтаксический пример для серверного обработчика или толстого клиента. ЧтениеHTML и ПостроительDOM разбирают собственную строку в память; это не открытие страницы в браузере. Здесь код не выполнялся.
Подготовка
Разметка находится в собственной строке; идентификаторы root, head и label уже заданы.
head — ЭлементЗаголовокHTML, а не визуальный заголовок h1. html — ЭлементРазметкаHTML; span представляет обычный ЭлементHTML.
Чтение = Новый ЧтениеHTML;
Чтение.УстановитьСтроку("<html id=""root""><head id=""head""><title>Памятка</title></head><body><span id=""label"">Книга</span></body></html>");
Построитель = Новый ПостроительDOM;
Документ = Построитель.Прочитать(Чтение);
Чтение.Закрыть();
Корень = Документ.ПолучитьЭлементПоИдентификатору("root");
Заголовок = Документ.ПолучитьЭлементПоИдентификатору("head");
Метка = Документ.ПолучитьЭлементПоИдентификатору("label");
Документ.СравнитьПозициюВДокументе(Корень);
Корень.СравнитьПозициюВДокументе(Заголовок);
Заголовок.СравнитьПозициюВДокументе(Метка);
Метка.СравнитьПозициюВДокументе(Корень);
Сообщить("Сравнения вызваны на документе и трёх элементах");Разбор по шагам
Создайте дерево из строки.
Получите реальные элементы по идентификаторам.
Сравните документ с корнем, затем связанные элементы между собой.
Как проверить результат
Получатели вызовов — разные узлы этого же документа.
Строка Книга и структура документа не редактируются сравнением.
Ожидаемый результат
Приведён короткий пример синтаксиса и его ограничения. Здесь он не запускался в 1С; выполните проверки в своём учебном контексте.
На что обратить внимание
В установленной справке СравнитьПозициюВДокументе не указан тип возвращаемого значения. Поэтому вызовы показаны без присваивания результата; числовые маски, конкретные коды и успешный результат здесь не выдумываются.
Нельзя присваивать заранее выбранный код позиции и выдавать его за результат метода.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.