Преобразование содержимого HTML в объект DOM

HTML-содержимое можно преобразовать в объект DOM, который можно добавить в отчет. Содержимое HTML может быть в строке или файле. Чтобы преобразовать HTML-содержимое в строку, используйте один из следующих подходов:

Создание mlreportgen.dom.HTML из строки содержимого HTML и добавьте объект в отчет. Этот подход можно использовать с отчетом DOM API или Report API.
Преобразование HTML-содержимого и добавление его в mlreportgen.dom.Document или mlreportgen.dom.DocumentPart с помощью addHTML способ. Этот метод возвращает HTML объект. Этот подход можно использовать только с отчетом DOM API.

См. раздел Преобразование содержимого HTML в строке.

Чтобы преобразовать содержимое HTML, которое находится в файле, используйте один из следующих подходов:

Создание mlreportgen.dom.HTMLFile и добавьте объект в отчет. Этот подход можно использовать с отчетом DOM API или Report API.
Преобразование HTML-содержимого и добавление его в mlreportgen.dom.Document или mlreportgen.dom.DocumentPart с помощью addHTMLFile способ. Этот метод возвращает HTMLFile объект. Этот подход можно использовать только с отчетом DOM API.

См. раздел Преобразование содержимого HTML-файла.

Подготовка HTML перед преобразованием

Отчет MATLAB ® 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 объекты. Эти функции:

Исправьте недопустимую разметку путем вызова 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 и mlreportgen.dom.HTMLFile объекты.
Преобразует документ HTML DOM в разметку HTML, поддерживаемую mlreportgen.dom.HTML и mlreportgen.dom.HTMLFile объекты. Атрибут style для каждого элемента определяет свойства CSS элемента, вычисленные веб-браузером MATLAB.

Как правило, программа должна будет продолжить обработку подготовленного HTML для удаления допустимых, но нежелательных объектов, таких как каналы строк, которые находились в необработанном содержимом.

Пример подготовки содержимого HTML из файла см. в разделе Подготовка HTML к преобразованию в объект DOM.

Преобразование содержимого HTML в строку

Чтобы преобразовать содержимое HTML в строке в объект DOM, создайте mlreportgen.dom.HTML и добавьте объект в отчет.

import mlreportgen.dom.*;
d = Document('MyDoc','docx');
htmlObj = HTML('<p><b>Hello </b> <i style="color:green">World</i></p>');
append(d,htmlObj);
close(d);
rptview(d);

Также можно преобразовать HTML и добавить его в документ с помощью addHTML способ. Метод возвращает HTML объект.

import mlreportgen.dom.*;
d = Document('MyDoc','docx');
addHTML(d, '<p><b>Hello </b> <i style="color:green">World</i></p>');
close(d);
rptview(d);

После создания HTML к объекту можно добавить большее количество HTML-содержимого. Например:

import mlreportgen.dom.*;
d = Document('MyDoc','docx');
htmlObj = HTML('<p><b>Hello </b> <i style="color:green">World</i></p>');

append(htmlObj,'<p>This is <u>me</u> speaking</p>');
append(d,htmlObj);

close(d);
rptview(d);

Добавление содержимого HTML объект более одного раза в отчете, используйте clone с помощью HTML объект. Затем добавьте клон к отчету.

Преобразовать содержимое HTML-файла

Чтобы преобразовать содержимое HTML-файла в объект DOM, создайте mlreportgen.dom.HTMLFile и добавьте объект в отчет.

Создание файла, MyHTML.html, который содержит этот HTML:

<html><p style="color:green;font-family:arial">Hello World</p></html>

Создание отчета PDF на основе содержимого HTML-файла.

import mlreportgen.dom.*;
d = Document('MyPDF','pdf');
htmlObj = HTMLFile('MyHTML.html');
append(d,htmlObj);
close(d);
rptview(d);

Также можно преобразовать HTML и добавить его в документ с помощью addHTMLFile способ.

import mlreportgen.dom.*;
d = Document('MyPDF','pdf');
addHTMLFile(d,'MyHTML.html');
close(d);
rptview(d);

См. также

Документация