ДокументHTML.ДобавитьДочерний

Проверить ограничения корня и редактировать правильный HTML-контейнер

На собственном документе намеренно проверяем четыре документированных ошибки корневых операций, затем выполняем вставку, замену и удаление обычных дочерних элементов своего блока.

Подготовка

1. Используйте отдельную учебную базу 8.5.1.1343. Создайте общий модуль УчебныйДокументHTML85: Сервер — Да, Клиент — Нет, Глобальный — Нет, Вызов сервера — Нет, Привилегированный — Нет.

2. Вставьте весь приведённый модуль одного урока. В своей управляемой учебной обработке создайте команду и клиентский обработчик, вызывающий свою процедуру с директивой &НаСервереБезКонтекста. В её тело вставьте УчебныйДокументHTML85.ВыполнитьПример();.

3. Источник HTML полностью записан в коде: свой вымышленный заказ, покупатель, книга, ручка и элементы с явно заданными id. ЧтениеHTML и ПостроительDOM получают строку, а не URL или внешний файл.

4. Разбор HTML в этом уроке не открывает браузер, не отправляет форму, не загружает картинки и не исполняет JavaScript. Файлы, сеть, печать, рабочие документы и регистры не используются.

5. Каждый запуск создаёт новый собственный документ в памяти. Поставьте точку останова перед конечными Сообщить и исследуйте Документ, его ЭлементДокумента и указанные переменные урока в серверном отладчике.

6. ДокументHTML — корневой объект дерева, а его ЭлементДокумента, Тело и отдельный блок — другие узлы. Одинаковые имена методов не означают одинаковые правила допустимых дочерних узлов.

7. Результаты ниже ожидаемые. В 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);
    Сообщить(Блок.ТекстовоеСодержимое = "Блокнот");

КонецПроцедуры

Разбор по шагам

1. Свой документ уже имеет один корневой html. Отдельный новый html создан той же фабрикой документа, поэтому ошибка второго корня не маскируется ошибкой другого документа-владельца.

2. ДобавитьДочерний и ВставитьПеред на уровне ДокументHTML намеренно пытаются добавить второй элемент корня. Это отрицательные проверки документированного ограничения, не рецепт создания страницы.

3. ЗаменитьДочерний(Документ,Корень) пытается поместить документ внутрь самого себя; УдалитьДочерний(Документ) ищет ребёнка, которым документ не является. Оба вызова намеренно проверяют исключения.

4. Каждое исключение учитывается; четыре отказа и сохранение прежнего корня проверяются до позитивной части. Сырые сообщения ошибок не интерпретируются как доказательство конкретного языка или одинакового текста ошибки.

5. Для нормальной работы используется собственный div внутри тела: добавляем Книга и вставляем Ручка перед ней. Обе созданы тем же ДокументHTML.

6. Заменяем только дочернюю Книга на свой Блокнот, затем удаляем только Ручка из правильного родительского блока.

7. Проверяем порядок, число детей и конечную надпись. Меняется дерево в памяти; файлы и любые пользовательские окна не трогаются.

Как проверить результат

1. Отрицательная часть ожидает четыре исключения и неизменный корень; при иной реализации урок выдаёт явную ошибку вместо ложного успеха.

2. Шесть конечных сравнений позитивной части Истина. После всех изменений один ребёнок с текстом Блокнот.

3. Не переносите отрицательные вызовы в прикладной код. Для обычных элементов используйте реальные родительские контейнеры и узлы собственного документа.

Ожидаемый результат

Ограничения корневого узла отделены от корректных операций со своим обычным HTML-контейнером.

На что обратить внимание

1. Этот урок намеренно содержит отрицательные вызовы внутри Попытка. Они проверяют ошибки API; сами по себе не считаются успешной правкой документа.

2. Метод с тем же именем у ДокументHTML и ЭлементHTML может иметь разные ограничения на дочерние узлы.

3. Не создавайте второй корень, не вставляйте узел сам в себя и не удаляйте ребёнка у неверного родителя.

4. Узлы другого документа нужно отдельно переносить документированным механизмом; этот урок не придумывает аргументы для противоречивой страницы АдаптироватьУзел.

5. Статические проверки не доказали фактические исключения платформы. Проверьте именно ожидаемые отказы на своём учебном стенде.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.