Тип: ЭлементHTML. Содержит корневой элемент документа HTML.
Полное описание, параметры и ограничения
ДокументHTML.ЭлементДокумента (HTMLDocument.DocumentElement)
ДокументHTML (HTMLDocument)
ЭлементДокумента (DocumentElement)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Тип: ЭлементHTML.
Содержит корневой элемент документа HTML.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Прочитать свойства HTML-документа и состав его коллекций
Паспорт собственного документа в памяти не является информацией о текущей вкладке браузера. Считаем картинки, ссылки, формы и аплеты.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте учебную базу платформы 8.5.1.1343 и серверную процедуру учебного общего модуля. Каждый пример выполняйте отдельно.
Все данные заказа вымышлены и находятся в строке. ЧтениеHTML разбирает данные, но не является браузером: форма не отправляется, ссылки не открываются, картинки не скачиваются.
Никакие файлы, адреса сайтов, токены и документы информационной базы не нужны. Не заменяйте учебную строку произвольным внешним HTML без отдельной проверки безопасности.
Индексы коллекций начинаются с нуля. Перед обращением к найденному узлу проверяйте Неопределено; перед специальными свойствами элемента проверяйте его тип.
HTML = "<html><head><title>Учебный заказ</title><meta id='meta' name='description' content='Вымышленный заказ'></head>
|<body id='body'><p id='note'>Заказ существует только в памяти</p><pre id='code'>A-01: 3
|B-02: 1</pre>
|<form id='order' name='order' action='' method='get'>
|<input id='customer' name='customer' type='text' value='Учебный покупатель'>
|<input id='accepted' name='accepted' type='checkbox' value='yes'>
|<button id='preview' name='preview' type='button' value='preview'>Предпросмотр</button></form>
|<table id='items' summary='Книга и ручка'><caption id='caption'>Товары</caption><colgroup><col id='column'></colgroup><tbody>
|<tr id='book'><td id='book-name'>Книга</td><td>3</td></tr><tr id='pen'><td>Ручка</td><td>1</td></tr>
|</tbody></table><a id='help' name='help' href='#note'>Пояснение</a><img id='logo' alt='Учебная картинка без источника'>
|</body></html>";
Чтение = Новый ЧтениеHTML;
Чтение.УстановитьСтроку(HTML);
Попытка
Построитель = Новый ПостроительDOM;
Документ = Построитель.Прочитать(Чтение);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Если ТипЗнч(Документ) <> Тип("ДокументHTML") Тогда
ВызватьИсключение "Ожидался ДокументHTML, а не XML-документ";
КонецЕсли;
Сообщить("URI: " + Документ.URIДокумента);
Сообщить("Базовый URL: " + Документ.URL);
Сообщить("Домен: " + Документ.Домен);
Сообщить("Отношение: " + Документ.Отношение);
Сообщить("Кодировка источника: " + Документ.КодировкаИсточника);
Сообщить(Документ.Картинки.Количество() = 1);
Сообщить(Документ.Ссылки.Количество() = 1);
Сообщить(Документ.Формы.Количество() = 1);
Сообщить(Документ.Аплеты.Количество() = 0);
Сообщить(Документ.ЭлементДокумента <> Неопределено);
Сообщить(Документ.ДокументВладелец = Неопределено);
Сообщить(Документ.РодительскийУзел = Неопределено);
Сообщить(Документ.ПредыдущийСоседний = Неопределено);
Сообщить(Документ.СледующийСоседний = Неопределено);
Сообщить(Документ.ПервыйДочерний <> Неопределено);
Сообщить(Документ.ПоследнийДочерний <> Неопределено);
Сообщить(Документ.ЕстьДочерниеУзлы());
Сообщить("Узел: " + Документ.ИмяУзла);
Сообщить("Тип узла: " + Строка(Документ.ТипУзла));
Сообщить("Локальное имя: " + Строка(Документ.ЛокальноеИмя));
Сообщить("Префикс: " + Строка(Документ.Префикс));
Сообщить("Значение: " + Строка(Документ.ЗначениеУзла));
Сообщить("Текст: " + Строка(Документ.ТекстовоеСодержимое));
Сообщить("Атрибуты документа: " + Строка(Документ.Атрибуты));
Сообщить("Есть атрибуты: " + Строка(Документ.ЕстьАтрибуты()));
Для Индекс = 0 По Документ.ДочерниеУзлы.Количество() - 1 Цикл
Ребёнок = Документ.ДочерниеУзлы.Элемент(Индекс);
Сообщить(Ребёнок.РодительскийУзел = Документ);
КонецЦикла;Разбор по шагам
Источник задан строкой, поэтому не обещаем реальный домен, URL или кодировку сетевого ответа.
Документ не имеет документа-владельца или родителя, но имеет корневой элемент и детей.
Узел документа не равен элементу: Атрибуты и ЗначениеУзла изучаем как фактические значения, не пытаемся обращаться к ним как к тексту input.
Перебираем детей только по допустимым индексам, проверяя обратную ссылку на документ.
Как проверить результат
Для собственного заказа: одна картинка, одна ссылка, одна форма и ноль аплетов; все четыре сравнения Истина.
Проверки границ документа Истина; у каждого полученного ребёнка родитель — данный документ.
Ожидаемый результат
Прочитан паспорт собственного дерева, не браузера или веб-сервера.
На что обратить внимание
Строковый URL не является результатом выполненного HTTP-запроса.
Картинки.Количество() считает img, а не успешно загруженные изображения.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Проверить ограничения корня и редактировать правильный HTML-контейнер
На собственном документе намеренно проверяем четыре документированных ошибки корневых операций, затем выполняем вставку, замену и удаление обычных дочерних элементов своего блока.
Где и как запускать
Полный серверный общий модуль УчебныйДокументHTML85. Свой HTML создаётся строкой и разбирается в памяти, без браузера и внешних источников.
Подготовка
Используйте отдельную учебную базу 8.5.1.1343. Создайте общий модуль УчебныйДокументHTML85: Сервер — Да, Клиент — Нет, Глобальный — Нет, Вызов сервера — Нет, Привилегированный — Нет.
Вставьте весь приведённый модуль одного урока. В своей управляемой учебной обработке создайте команду и клиентский обработчик, вызывающий свою процедуру с директивой &НаСервереБезКонтекста. В её тело вставьте УчебныйДокументHTML85.ВыполнитьПример();.
Источник HTML полностью записан в коде: свой вымышленный заказ, покупатель, книга, ручка и элементы с явно заданными id. ЧтениеHTML и ПостроительDOM получают строку, а не URL или внешний файл.
Разбор HTML в этом уроке не открывает браузер, не отправляет форму, не загружает картинки и не исполняет JavaScript. Файлы, сеть, печать, рабочие документы и регистры не используются.
Каждый запуск создаёт новый собственный документ в памяти. Поставьте точку останова перед конечными Сообщить и исследуйте Документ, его ЭлементДокумента и указанные переменные урока в серверном отладчике.
ДокументHTML — корневой объект дерева, а его ЭлементДокумента, Тело и отдельный блок — другие узлы. Одинаковые имена методов не означают одинаковые правила допустимых дочерних узлов.
Результаты ниже ожидаемые. В 1С код не запускался; статическая сверка сигнатур и readonly не подтверждает все особенности реализации HTML DOM вашей среды. Выполните проверки только на своём учебном стенде.
Процедура ВыполнитьПример() Экспорт
HTML = "<html><head><title>Учебный заказ</title><meta id='meta' name='description' content='Вымышленный заказ'></head>
|<body id='body'><p id='note'>Заказ существует только в памяти</p><pre id='code'>A-01: 3
|B-02: 1</pre>
|<form id='order' name='order' action='' method='get'>
|<input id='customer' name='customer' type='text' value='Учебный покупатель'>
|<input id='accepted' name='accepted' type='checkbox' value='yes'>
|<button id='preview' name='preview' type='button' value='preview'>Предпросмотр</button></form>
|<table id='items' summary='Книга и ручка'><caption id='caption'>Товары</caption><colgroup><col id='column'></colgroup><tbody>
|<tr id='book'><td id='book-name'>Книга</td><td>3</td></tr><tr id='pen'><td>Ручка</td><td>1</td></tr>
|</tbody></table><a id='help' name='help' href='#note'>Пояснение</a><img id='logo' alt='Учебная картинка без источника'>
|</body></html>";
Чтение = Новый ЧтениеHTML;
Чтение.УстановитьСтроку(HTML);
Попытка
Построитель = Новый ПостроительDOM;
Документ = Построитель.Прочитать(Чтение);
Исключение
Чтение.Закрыть();
ВызватьИсключение;
КонецПопытки;
Чтение.Закрыть();
Если ТипЗнч(Документ) <> Тип("ДокументHTML") Тогда
ВызватьИсключение "Ожидался ДокументHTML, а не XML-документ";
КонецЕсли;
Форма = Документ.ПолучитьЭлементПоИдентификатору("order");
Если Форма = Неопределено Тогда
ВызватьИсключение "В своём HTML нужна форма order";
КонецЕсли;
Если ТипЗнч(Форма) <> Тип("ЭлементФормаHTML") Тогда
ВызватьИсключение "order должен быть собственной HTML-формой";
КонецЕсли;
Блок = Документ.СоздатьЭлемент("div");
Блок.УстановитьАтрибут("id", "own-work");
Форма.ДобавитьДочерний(Блок);
Корень = Документ.ЭлементДокумента;
НовыйКорень = Документ.СоздатьЭлемент("html");
Отклонено = 0;
Попытка
Документ.ДобавитьДочерний(НовыйКорень);
Исключение
Отклонено = Отклонено + 1;
КонецПопытки;
Попытка
Документ.ВставитьПеред(НовыйКорень, Корень);
Исключение
Отклонено = Отклонено + 1;
КонецПопытки;
Попытка
Документ.ЗаменитьДочерний(Документ, Корень);
Исключение
Отклонено = Отклонено + 1;
КонецПопытки;
Попытка
Документ.УдалитьДочерний(Документ);
Исключение
Отклонено = Отклонено + 1;
КонецПопытки;
Если Отклонено <> 4 Или Не Документ.ЭлементДокумента.УзелИдентичен(Корень) Тогда
ВызватьИсключение "Реализация не подтвердила ожидаемые ограничения собственного корня";
КонецЕсли;
Книга = Документ.СоздатьЭлемент("span");
Книга.ТекстовоеСодержимое = "Книга";
Ручка = Документ.СоздатьЭлемент("span");
Ручка.ТекстовоеСодержимое = "Ручка";
Блок.ДобавитьДочерний(Книга);
Блок.ВставитьПеред(Ручка, Книга);
Сообщить(Блок.ДочерниеУзлы.Количество() = 2);
Сообщить(Блок.ПервыйДочерний.УзелИдентичен(Ручка));
Замена = Документ.СоздатьЭлемент("span");
Замена.ТекстовоеСодержимое = "Блокнот";
Блок.ЗаменитьДочерний(Замена, Книга);
Сообщить(Блок.ДочерниеУзлы.Количество() = 2);
Сообщить(Блок.ПоследнийДочерний.УзелИдентичен(Замена));
Блок.УдалитьДочерний(Ручка);
Сообщить(Блок.ДочерниеУзлы.Количество() = 1);
Сообщить(Блок.ТекстовоеСодержимое = "Блокнот");
КонецПроцедурыРазбор по шагам
Свой документ уже имеет один корневой html. Отдельный новый html создан той же фабрикой документа, поэтому ошибка второго корня не маскируется ошибкой другого документа-владельца.
ДобавитьДочерний и ВставитьПеред на уровне ДокументHTML намеренно пытаются добавить второй элемент корня. Это отрицательные проверки документированного ограничения, не рецепт создания страницы.
ЗаменитьДочерний(Документ,Корень) пытается поместить документ внутрь самого себя; УдалитьДочерний(Документ) ищет ребёнка, которым документ не является. Оба вызова намеренно проверяют исключения.
Каждое исключение учитывается; четыре отказа и сохранение прежнего корня проверяются до позитивной части. Сырые сообщения ошибок не интерпретируются как доказательство конкретного языка или одинакового текста ошибки.
Для нормальной работы используется собственный div внутри тела: добавляем Книга и вставляем Ручка перед ней. Обе созданы тем же ДокументHTML.
Заменяем только дочернюю Книга на свой Блокнот, затем удаляем только Ручка из правильного родительского блока.
Проверяем порядок, число детей и конечную надпись. Меняется дерево в памяти; файлы и любые пользовательские окна не трогаются.
Как проверить результат
Отрицательная часть ожидает четыре исключения и неизменный корень; при иной реализации урок выдаёт явную ошибку вместо ложного успеха.
Шесть конечных сравнений позитивной части Истина. После всех изменений один ребёнок с текстом Блокнот.
Не переносите отрицательные вызовы в прикладной код. Для обычных элементов используйте реальные родительские контейнеры и узлы собственного документа.
Ожидаемый результат
Ограничения корневого узла отделены от корректных операций со своим обычным HTML-контейнером.
На что обратить внимание
Этот урок намеренно содержит отрицательные вызовы внутри Попытка. Они проверяют ошибки API; сами по себе не считаются успешной правкой документа.
Метод с тем же именем у ДокументHTML и ЭлементHTML может иметь разные ограничения на дочерние узлы.
Не создавайте второй корень, не вставляйте узел сам в себя и не удаляйте ребёнка у неверного родителя.
Узлы другого документа нужно отдельно переносить документированным механизмом; этот урок не придумывает аргументы для противоречивой страницы АдаптироватьУзел.
Статические проверки не доказали фактические исключения платформы. Проверьте именно ожидаемые отказы на своём учебном стенде.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.