Проверяет, имеются ли у узла дочерние узлы.
Синтаксис
ЕстьДочерниеУзлы()Полное описание, параметры и ограничения
ЭлементHTML.ЕстьДочерниеУзлы (HTMLElement.HasChildNodes)
ЭлементHTML (HTMLElement)
ЕстьДочерниеУзлы (HasChildNodes)
Доступен, начиная с версии 8.2.
Синтаксис:
ЕстьДочерниеУзлы()
Возвращаемое значение:
Тип: Булево.
Истина - узел имеет дочерние узлы, Ложь - в противном случае.
Описание:
Проверяет, имеются ли у узла дочерние узлы.
Доступность:
Тонкий клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 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-документ";
КонецЕсли;
Форма = Документ.ПолучитьЭлементПоИдентификатору("order");
Если Форма = Неопределено Тогда
ВызватьИсключение "Не найден учебный элемент order";
КонецЕсли;
Если ТипЗнч(Форма) <> Тип("ЭлементФормаHTML") Тогда
ВызватьИсключение "Неожиданный тип учебного элемента order";
КонецЕсли;
Блок = Документ.СоздатьЭлемент("guide-section");
Если ТипЗнч(Блок) <> Тип("ЭлементHTML") Тогда
ВызватьИсключение "Учебный контейнер должен иметь общий тип ЭлементHTML";
КонецЕсли;
Форма.ДобавитьДочерний(Блок);
Поле = Документ.ПолучитьЭлементПоИдентификатору("customer");
Если Поле = Неопределено Тогда
ВызватьИсключение "Не найден учебный элемент customer";
КонецЕсли;
Если ТипЗнч(Поле) <> Тип("ЭлементВводаHTML") Тогда
ВызватьИсключение "Неожиданный тип учебного элемента customer";
КонецЕсли;
Сообщить(Поле.РодительскийУзел = Форма);
Блок.ДобавитьДочерний(Поле);
Сообщить(Поле.РодительскийУзел = Блок);
Сообщить(Поле.Форма() = Форма);
Сообщить(Форма.Элементы.Количество() = 3);
Сообщить(Документ.ПолучитьЭлементПоИдентификатору("customer").УзелИдентичен(Поле));
Форма.ДобавитьДочерний(Поле);
Сообщить(Поле.РодительскийУзел = Форма);
Сообщить(Не Блок.ЕстьДочерниеУзлы());Разбор по шагам
Проверяем исходного родителя существующего поля.
Вставляем тот же узел в новый контейнер внутри той же формы.
Форма-владелец остаётся прежней, количество контролов не увеличивается.
Возвращаем узел в форму и проверяем пустоту контейнера.
Как проверить результат
Семь проверок дают Истина; поле остаётся идентичным самому себе, а элементов формы по-прежнему три.
Значение покупателя не изменилось, повторный input не создан.
Ожидаемый результат
Различены перемещение узла, клонирование и создание нового поля.
На что обратить внимание
Перемещение в другую HTML-форму может изменить владельца и параметры будущей отправки.
Этот пример не меняет расположение элементов управляемой формы 1С.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Удалить временное пояснение из дерева, не потерять сохранённый объект
УдалитьДочерний возвращает удалённый узел. Он перестаёт быть ребёнком, но данные доступны через собственную ссылку.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте учебную базу платформы 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-документ";
КонецЕсли;
Форма = Документ.ПолучитьЭлементПоИдентификатору("order");
Если Форма = Неопределено Тогда
ВызватьИсключение "Не найден учебный элемент order";
КонецЕсли;
Если ТипЗнч(Форма) <> Тип("ЭлементФормаHTML") Тогда
ВызватьИсключение "Неожиданный тип учебного элемента order";
КонецЕсли;
Блок = Документ.СоздатьЭлемент("guide-section");
Если ТипЗнч(Блок) <> Тип("ЭлементHTML") Тогда
ВызватьИсключение "Учебный контейнер должен иметь общий тип ЭлементHTML";
КонецЕсли;
Форма.ДобавитьДочерний(Блок);
Текст = Документ.СоздатьТекстовыйУзел("Не сохранять");
Блок.ДобавитьДочерний(Текст);
Удалённый = Блок.УдалитьДочерний(Текст);
Сообщить(Удалённый.УзелИдентичен(Текст));
Сообщить(Удалённый.РодительскийУзел = Неопределено);
Сообщить(Удалённый.ДокументВладелец = Документ);
Сообщить(Удалённый.Данные = "Не сохранять");
Сообщить(Не Блок.ЕстьДочерниеУзлы());Разбор по шагам
Удаляем только собственный текст из собственного контейнера памяти.
Результат метода сохраняем как ссылку, не путаем с булевой успешностью.
Проверяем отсутствие родителя и сохранение документа-владельца.
Удаление DOM-ребёнка не является удалением файла или документа базы.
Как проверить результат
Пять сравнений дают Истина; контейнер пуст, а данные удалённого узла ещё читаются.
Таблица товаров и поля формы не удалены.
Ожидаемый результат
Разделены исключение из дерева и существование объекта в памяти.
На что обратить внимание
Не вызывайте удаление повторно на том же родителе: узел уже не является его ребёнком.
Этот урок не авторизует удаление пользовательских данных.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.