mlreportgen.utils.html2dom.prepHTMLString

Подготовьте HTML строки к преобразованию в DOM

Описание

пример

preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLString(htmlStr) подготавливает HTML в строке, заданной htmlStr для преобразования в MATLAB® Report Generator™ внутренней модели объекта документа (DOM). Подготовленный HTML в preppedHTMLStr можно преобразовать в представление DOM API при помощи mlreportgen.dom.HTML объект. mlreportgen.utils.html2dom.prepHTMLString функция:

  • Исправляет недопустимую разметку путем вызова mlreportgen.utils.tidy с параметрами для выхода HTML.

  • Использование веб-браузера MATLAB для преобразования приведенной в порядок разметки в документ HTML DOM. См. https://www.w3.org/TR/WD-DOM/introduction.html.

    Веб-браузер MATLAB вычисляет свойства CSS элементов HTML- входа на основе внутренних и внешних таблиц стилей, заданных входом HTML, и на основе атрибута стиля элемента. Расчет свойства CSS поддерживает все действительные селекторы таблиц стилей CSS, включая селекторы, не поддерживаемые непосредственно mlreportgen.dom.HTML объекты.

  • Преобразует документ HTML DOM в разметку HTML, поддерживаемую mlreportgen.dom.HTML объекты. Атрибут стиля для каждого элемента задает свойства CSS элемента, которые вычислял веб-браузер MATLAB.

  • Возвращает подготовленный HTML в виде строкового скаляра.

preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLString(htmlStr,"Tidy",false) подготавливает входной HTML, не приводя его в порядок. Используйте этот синтаксис, если вы хотите привести в порядок разметку HTML самостоятельно. Для примера можно хотеть позвонить mlreportgen.utils.tidy с другими опциями, чем таковые, используемые mlreportgen.utils.html2dom.prepHTMLString, затем передайте приведенный в порядок HTML как вход в mlreportgen.utils.html2dom.prepHTMLString.

Примеры

свернуть все

Использовать mlreportgen.utils.html2dom.prepHTML для подготовки HTML строки к преобразованию в объект DOM, который можно добавить в отчет.

Создайте строку с именем myHTMLStr который имеет этот HTML содержимого:

myHTMLStr = "<html><body><p>This is the first paragraph.<p>This is the second paragraph.<p></body></html>";

В параграфе отсутствует / в конечном теге </p>.

Попытайтесь преобразовать HTML в объект DOM и добавить объект к отчету.

import mlreportgen.dom.*; 
rpt = Document("MyReport","docx"); 
htmlObj = mlreportgen.dom.HTML(myHTMLStr);
append(rpt,htmlObj); 
close(rpt); 
rptview(rpt);
Error using mlreportgen.dom.HTML
HTML error: expected end of tag 'p'

mlreportgen.dom.HTML заканчивается ошибкой из-за отсутствующего позиционного обозначения конца.

Подготовьте HTML при помощи mlreportgen.utils.html2dom.prepHTMLString. Создайте mlreportgen.dom.HTML объект из подготовленного HTML и добавить объект к отчету.

import mlreportgen.dom.*; 
rpt = Document("MyReport","docx");
%prepare the HTML 
myPreppedHTML = mlreportgen.utils.html2dom.prepHTMLString(myHTMLStr);
htmlObj = mlreportgen.dom.HTML(myPreppedHTML);
append(rpt,htmlObj); 
close(rpt); 
rptview(rpt);

Входные параметры

свернуть все

HTML содержимого для подготовки к преобразованию в DOM, заданный как вектор символов или строковый скаляр.

Выходные аргументы

свернуть все

Подготовленный HTML, возвращенный как строковый скаляр.

Совет

  • MATLAB Report Generator mlreportgen.dom.HTML или mlreportgen.dom.HTMLFile объекты обычно не могут принимать необработанный HTML выхода сторонних приложений, таких как Microsoft® Word, который экспортирует собственные документы как разметку HTML. В этих случаях программа генерации отчетов Report API может использовать mlreportgen.utils.html2dom.prepHTMLString и mlreportgen.utils.html2dom.prepHTMLFile функции для подготовки необработанного HTML для использования со mlreportgen.dom.HTML или mlreportgen.dom.HTMLFile объекты. Как правило, ваша программа должна будет продолжить обработку подготовленного HTML для удаления допустимых, но нежелательных объектов, таких как каналы линий, которые находились в необработанном содержимом.

Введенный в R2020a
Для просмотра документации необходимо авторизоваться на сайте