Расширение поля формы для поля HTML-документа.Документ

Прочитать объект готового HTML и сведения о встроенном браузере

Читаем Документ и строку User-Agent только после ДокументСформирован. Тип внешнего объекта диагностируем, не угадываем конкретный движок браузера.

Подготовка

1. В отдельной учебной базе 8.5.1.1343 создайте внешнюю обработку УчебнаяHTMLКарточка85 с пустой управляемой основной формой. Используйте тонкий клиент Windows.

2. Не добавляйте вручную УчебныйHTML, УчебныйHTMLГотов, УчебноеHTMLПоле или учебные кнопки: полный модуль создаёт реквизиты, элементы и команды.

3. В свойствах формы → События назначьте ПриСозданииНаСервере. Вставьте один полный модуль урока на уровне модуля, сохраните собственную EPF и откройте её в учебной базе.

4. Строковый реквизит УчебныйHTML хранит свою страницу. ПолеФормы имеет ВидПоляФормы.ПолеHTMLДокумента и ПутьКДанным = УчебныйHTML.

5. Страница собирается из собственных 3 книг по 250. Нет внешних URL, изображений, скриптов, файлов, запросов и записей в базу.

6. Дождитесь отображения карточки. Обработчик ДокументСформирован назначен программно; в модуле управляемой формы он получает Элемент.

7. Отдельный флаг готовности не подменяет чтение объекта браузера. Не обращайтесь к Документ при серверном создании или до завершения формирования HTML.

8. Каждый урок запускайте в отдельной копии формы. Работа в 1С, визуальное отображение и история встроенного браузера не проверены; веб-клиент и мобильный клиент в упражнение не входят.

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Реквизиты = Новый Массив;
    Реквизиты.Добавить(Новый РеквизитФормы("УчебныйHTML", Новый ОписаниеТипов("Строка")));
    Реквизиты.Добавить(Новый РеквизитФормы("УчебныйHTMLГотов", Новый ОписаниеТипов("Булево")));
    ЭтаФорма.ИзменитьРеквизиты(Реквизиты);
    ЭтаФорма.УчебныйHTMLГотов = Ложь;
    Поле = Элементы.Добавить("УчебноеHTMLПоле", Тип("ПолеФормы"));
    Поле.Вид = ВидПоляФормы.ПолеHTMLДокумента;
    Поле.ПутьКДанным = "УчебныйHTML";
    Поле.УстановитьДействие("ДокументСформирован", "УчебныйДокументСформирован");
    Поле.Вывод = ИспользованиеВывода.Запретить;


    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Проверить свою HTML-карточку";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
    ЭтаФорма.УчебныйHTML = СформироватьСобственнуюКарточку();
КонецПроцедуры

&НаКлиенте
Процедура УчебныйДокументСформирован(Элемент)
    УчебныйHTMLГотов = Истина;
    Сообщить("Собственный HTML сформирован в элементе: " + Элемент.Имя);
КонецПроцедуры

&НаКлиенте
Процедура УчебноеДействие(Команда)
    Если Не УчебныйHTMLГотов Тогда
        Сообщить("Собственный HTML ещё формируется; нажмите после появления карточки");
        Возврат;
    КонецЕсли;
    Поле = Элементы.УчебноеHTMLПоле;
    Сообщить(СтрНайти(УчебныйHTML, "Сумма: 750") > 0);
    Сообщить(СтрНайти(УчебныйHTML, "Книга <учебная> & "цена"") > 0);
    ДокументБраузера = Поле.Документ;
    Информация = Поле.ИнформацияПрограммыПросмотра;
    Сообщить(ДокументБраузера <> Неопределено);
    Сообщить(ТипЗнч(Информация) = Тип("Строка"));
    Сообщить("Фактический тип объекта браузера: " + Строка(ТипЗнч(ДокументБраузера)));
    Сообщить("User-Agent встроенного просмотра: " + Информация);
КонецПроцедуры

&НаСервереБезКонтекста
Функция ЭкранироватьУчебныйТекст(Текст)
    Результат = СтрЗаменить(Текст, "&", "&amp;");
    Результат = СтрЗаменить(Результат, "<", "&lt;");
    Результат = СтрЗаменить(Результат, ">", "&gt;");
    Результат = СтрЗаменить(Результат, """", "&quot;");
    Возврат Результат;
КонецФункции

&НаСервереБезКонтекста
Функция СформироватьСобственнуюКарточку()
    Название = "Книга <учебная> & ""цена""";
    Количество = 3;
    Цена = 250;
    Сумма = Количество * Цена;
    Если Сумма <> 750 Тогда
        ВызватьИсключение "Нарушен собственный учебный расчёт";
    КонецЕсли;
    Возврат "<!doctype html><html lang=""ru""><head><meta charset=""utf-8""><title>Собственная учебная карточка</title></head>"
        + "<body style=""font-family:Arial,sans-serif;font-size:16px;line-height:1.6;padding:16px""><h1 id=""own-summary"">Учебный расчёт</h1>"
        + "<p id=""own-name"">" + ЭкранироватьУчебныйТекст(Название) + "</p>"
        + "<p><a href=""#own-total"">К собственной сумме</a></p>"
        + "<div style=""min-height:550px""><p>Только собственные данные: 3 книги по 250.</p></div>"
        + "<h2 id=""own-total"">Сумма: " + Строка(Сумма) + "</h2>"
        + "<p><a href=""#own-summary"">К началу собственной карточки</a></p></body></html>";
КонецФункции

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

1. ПриСозданииНаСервере создаёт элементы и задаёт содержимое, но не пытается читать клиентский объект браузера.

2. УстановитьДействие связывает ДокументСформирован с обработчиком УчебныйДокументСформирован.

3. В модуле управляемой формы обработчик принимает Элемент. Это сверено со своим исходником УНФ, а не выведено только из пустых скобок общей страницы события.

4. После формирования флаг разрешает проверку. Документ и ИнформацияПрограммыПросмотра readonly, поэтому только читаем их.

5. Не приравниваем User-Agent к версии платформы и не обещаем определённый COM/внешний тип для всех клиентов. Печатаем фактический тип.

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

1. После формирования ожидаются четыре Истина и две диагностические строки. До готовности кнопка только просит подождать.

2. Сверьте сообщение события и фактический тип в отладчике. Если User-Agent пуст, сохраните диагностический результат, не придумывая название движка.

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

Клиентский объект просмотра читается в правильный момент и не смешивается со строковым источником страницы.

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

1. Readonly Документ — не строка УчебныйHTML. В него нельзя записать новую разметку присваиванием.

2. Объектная модель браузера и доступность её членов различаются между клиентами; этот урок не вызывает сторонние DOM-методы.

3. Флаг готовности относится к своей странице и событию; после загрузки нового содержимого его нужно сбрасывать снова.

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