ЭлементТаблицаHTML.ПолучитьТелаТаблицы

Создать и убрать заглавие, шапку и подвал таблицы

Caption, thead и tfoot решают разные задачи. Создаём их в копии своей таблицы и контролируем количество соответствующих тегов.

Подготовка

1. Используйте учебную базу платформы 8.5.1.1343 и серверную процедуру учебного общего модуля. Каждый пример выполняйте отдельно.

2. Все данные заказа вымышлены и находятся в строке. ЧтениеHTML разбирает данные, но не является браузером: форма не отправляется, ссылки не открываются, картинки не скачиваются.

3. Никакие файлы, адреса сайтов, токены и документы информационной базы не нужны. Не заменяйте учебную строку произвольным внешним HTML без отдельной проверки безопасности.

4. Индексы коллекций начинаются с нуля. Перед обращением к найденному узлу проверяйте Неопределено; перед специальными свойствами элемента проверяйте его тип.

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-документ";
КонецЕсли;
Таблица = Документ.ПолучитьЭлементПоИдентификатору("items");
Если Таблица = Неопределено Тогда
    ВызватьИсключение "Не найден учебный элемент items";
КонецЕсли;
Если ТипЗнч(Таблица) <> Тип("ЭлементТаблицаHTML") Тогда
    ВызватьИсключение "Неожиданный тип учебного элемента items";
КонецЕсли;
Копия = Таблица.КлонироватьУзел(Истина);
Копия.УдалитьЗаголовок();
Заглавие = Копия.СоздатьЗаголовок();
Заглавие.ДобавитьДочерний(Документ.СоздатьТекстовыйУзел("Учебный заказ, 4 единицы"));
Если ТипЗнч(Заглавие) = Тип("ЭлементЗаголовокТаблицыHTML") Тогда
    Заглавие.Выравнивание = "top";
КонецЕсли;
Шапка = Копия.СоздатьЗаголовокТаблицы();
Подвал = Копия.СоздатьПодвалТаблицы();
Сообщить(Заглавие.ТекстовоеСодержимое = "Учебный заказ, 4 единицы");
Сообщить(Шапка.РодительскийУзел = Копия);
Сообщить(Подвал.РодительскийУзел = Копия);
Сообщить(Копия.ПолучитьТелаТаблицы().Количество() = 1);
Копия.УдалитьЗаголовокТаблицы();
Копия.УдалитьПодвалТаблицы();
Копия.УдалитьЗаголовок();
Сообщить(Копия.ПолучитьЭлементыПоИмени("caption").Количество() = 0);
Сообщить(Копия.ПолучитьЭлементыПоИмени("thead").Количество() = 0);
Сообщить(Копия.ПолучитьЭлементыПоИмени("tfoot").Количество() = 0);
Сообщить(Таблица.ПолучитьЭлементыПоИмени("caption").Количество() = 1);

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

1. Удаляем только прежний caption копии и создаём новое пояснение текстовым узлом.

2. СоздатьЗаголовокТаблицы создаёт thead, а СоздатьПодвалТаблицы — tfoot; это не caption.

3. Пустые шапка и подвал не увеличивают число строк товаров; затем удаляем все три служебных элемента копии.

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

1. Все восемь сравнений Истина; в оригинале остаётся его исходный caption.

2. Пустые thead и tfoot показаны для жизненного цикла API, не как заполненная печатная форма.

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

Уяснены три разных элемента таблицы и парные операции создания/удаления.

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

1. Создаваемые методы возвращают ЭлементHTML по справке; специальное Выравнивание используем только после проверки типа.

2. Удаление заглавия копии не должно удалять caption оригинала.

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