Тип: Строка. Префикс узла HTML. Свойство имеет значение Неопределено для узлов, отличных от АтрибутHTML и ЭлементHTML.
Полное описание, параметры и ограничения
ЭлементКнопкаHTML.Префикс (HTMLButtonElement.Prefix)
ЭлементКнопкаHTML (HTMLButtonElement)
Префикс (Prefix)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Тип: Строка.
Префикс узла HTML.
Свойство имеет значение Неопределено для узлов, отличных от Атрибут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-документ";
КонецЕсли;
Ожидаемые = Новый Соответствие;
Ожидаемые.Вставить("guide-section", "ЭлементHTML");
Ожидаемые.Вставить("div", "ЭлементБлокHTML");
Ожидаемые.Вставить("pre", "ЭлементФорматированногоТекстаHTML");
Ожидаемые.Вставить("form", "ЭлементФормаHTML");
Ожидаемые.Вставить("input", "ЭлементВводаHTML");
Ожидаемые.Вставить("button", "ЭлементКнопкаHTML");
Ожидаемые.Вставить("table", "ЭлементТаблицаHTML");
Ожидаемые.Вставить("tr", "ЭлементСтрокаТаблицыHTML");
Ожидаемые.Вставить("td", "ЭлементЯчейкаТаблицыHTML");
Ожидаемые.Вставить("col", "ЭлементКолонкаТаблицыHTML");
Ожидаемые.Вставить("caption", "ЭлементЗаголовокТаблицыHTML");
Ожидаемые.Вставить("a", "ЭлементЯкорьHTML");
Ожидаемые.Вставить("img", "ЭлементКартинкаHTML");
Ожидаемые.Вставить("meta", "ЭлементМетаHTML");
Ожидаемые.Вставить("link", "ЭлементСвязьHTML");
Ожидаемые.Вставить("head", "ЭлементЗаголовокHTML");
Ожидаемые.Вставить("html", "ЭлементРазметкаHTML");
Ожидаемые.Вставить("hr", "ЭлементЛинияHTML");
Ожидаемые.Вставить("script", "ЭлементСкриптHTML");
Ожидаемые.Вставить("iframe", "ЭлементПлавающийФреймHTML");
Ожидаемые.Вставить("frame", "ЭлементФреймHTML");
Ожидаемые.Вставить("frameset", "ЭлементНаборФреймовHTML");
Ожидаемые.Вставить("embed", "ЭлементВставкаHTML");
Ожидаемые.Вставить("object", "ЭлементОбъектHTML");
Ожидаемые.Вставить("applet", "ЭлементАплетHTML");
Для Каждого Пара Из Ожидаемые Цикл
Узел = Документ.СоздатьЭлемент(Пара.Ключ);
Если ТипЗнч(Узел) <> Тип(Пара.Значение) Тогда
ВызватьИсключение "Фактический тип фабрики отличается для " + Пара.Ключ;
КонецЕсли;
Сообщить(СтрШаблон("%1: %2 / %3 / %4", Пара.Ключ,
Узел.ИмяУзла, Узел.ИмяЭлемента, Узел.ТипУзла));
Сообщить(СтрШаблон("Локальное имя: %1; префикс: %2", Узел.ЛокальноеИмя, Узел.Префикс));
Сообщить("Значение узла: " + Строка(Узел.ЗначениеУзла));
Сообщить("Текст: " + Узел.ТекстовоеСодержимое);
Сообщить(Узел.ДочерниеУзлы.Количество() = 0);
Сообщить(Не Узел.ЕстьДочерниеУзлы());
Сообщить(Узел.ПервыйДочерний = Неопределено);
Сообщить(Узел.ПоследнийДочерний = Неопределено);
Сообщить(Узел.ПредыдущийСоседний = Неопределено);
Сообщить(Узел.СледующийСоседний = Неопределено);
Сообщить(Узел.ЕстьАтрибуты() = (Узел.Атрибуты.Количество() > 0));
КонецЦикла;Разбор по шагам
Пустые элементы созданы отдельно, а не найдены в заполненном внешнем документе.
ИмяУзла обозначает тег; ЗначениеУзла не заменяет значение input или текст кнопки.
Узел не вставлен в дерево, поэтому у него нет соседей; у пустого элемента нет детей.
Фактическое количество атрибутов сопоставляем с ЕстьАтрибуты, не предполагая отсутствие значений по умолчанию.
Как проверить результат
В каждом блоке семь сравнений Истина: пустые дети, границы и согласованность признака атрибутов.
Вывод имён и значений изучите отдельно: регистр тегов и представление Неопределено не объявлены бизнес-данными.
Ожидаемый результат
Новичок видит, какие свойства общего узла допустимы и где нужна проверка границы.
На что обратить внимание
Не обращайтесь к ПервыйДочерний.Данные без проверки наличия ребёнка.
У ЭлементТело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", "ЭлементФормаHTML");
ОжидаемыеУзлы.Вставить("customer", "ЭлементВводаHTML");
ОжидаемыеУзлы.Вставить("preview", "ЭлементКнопкаHTML");
ОжидаемыеУзлы.Вставить("items", "ЭлементТаблицаHTML");
ОжидаемыеУзлы.Вставить("book", "ЭлементСтрокаТаблицыHTML");
ОжидаемыеУзлы.Вставить("book-name", "ЭлементЯчейкаТаблицыHTML");
ОжидаемыеУзлы.Вставить("caption", "ЭлементЗаголовокТаблицыHTML");
ОжидаемыеУзлы.Вставить("column", "ЭлементКолонкаТаблицыHTML");
ОжидаемыеУзлы.Вставить("help", "ЭлементЯкорьHTML");
ОжидаемыеУзлы.Вставить("logo", "ЭлементКартинкаHTML");
ОжидаемыеУзлы.Вставить("meta", "ЭлементМетаHTML");
Для Каждого Пара Из ОжидаемыеУзлы Цикл
Узел = Документ.ПолучитьЭлементПоИдентификатору(Пара.Ключ);
Если Узел = Неопределено Тогда
ВызватьИсключение "Не найден учебный элемент " + Пара.Ключ;
КонецЕсли;
Если ТипЗнч(Узел) <> Тип(Пара.Значение) Тогда
ВызватьИсключение "Тип учебного элемента отличается от подготовки: " + Пара.Ключ;
КонецЕсли;
Сообщить(СтрШаблон("%1: узел %2; элемент %3; тип %4", Пара.Ключ,
Узел.ИмяУзла, Узел.ИмяЭлемента, Узел.ТипУзла));
Сообщить(СтрШаблон("Локальное имя %1; префикс %2", Узел.ЛокальноеИмя, Узел.Префикс));
Сообщить("Значение узла: " + Узел.ЗначениеУзла);
Сообщить("Текстовое содержимое: " + Узел.ТекстовоеСодержимое);
Сообщить("Детей: " + Строка(Узел.ДочерниеУзлы.Количество()));
Если Не Узел.ЕстьДочерниеУзлы() Тогда
Сообщить(Узел.ПервыйДочерний = Неопределено);
Сообщить(Узел.ПоследнийДочерний = Неопределено);
КонецЕсли;
Предыдущий = Узел.ПредыдущийСоседний;
Следующий = Узел.СледующийСоседний;
Если Предыдущий <> Неопределено Тогда
Сообщить(Предыдущий.РодительскийУзел = Узел.РодительскийУзел);
КонецЕсли;
Если Следующий <> Неопределено Тогда
Сообщить(Следующий.РодительскийУзел = Узел.РодительскийУзел);
КонецЕсли;
КонецЦикла;Разбор по шагам
ИмяУзла и ИмяЭлемента описывают тег, не значение поля ввода.
ЗначениеУзла элемента не заменяет его ТекстовоеСодержимое или специальное Значение input.
У пустого элемента нет первого и последнего ребёнка; не обращаемся к свойствам Неопределено.
Соседние узлы могут быть текстовыми из-за переносов и пробелов: проверяем общего родителя, не ожидаем только теги.
Как проверить результат
Для input, img, meta и col в собственной строке нет дочерних узлов: проверки границ дают Истина.
Все полученные соседи имеют того же родителя; регистр имён тегов сравнивайте с фактическим выводом, не с предположением о lower case.
Ожидаемый результат
Разобраны границы дерева и различие общих/специальных свойств узлов.
На что обратить внимание
Нельзя получать текст HTML-поля ввода через ТекстовоеСодержимое вместо Значение.
Пробельный текст влияет на соседей и число дочерних узлов.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.