Exponenta Banner

mlreportgen.utils.html2dom.prepHTMLFile

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

Свернуть все на странице

Синтаксис

preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLFile(htmlFile)
preppedHTMLFileName = mlreportgen.utils.html2dom.prepHTMLFile(htmlFile,preppedHTMLFileName)
preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLFile(___,"Tidy",false)

Описание

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

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

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

пример

preppedHTMLFileName = mlreportgen.utils.html2dom.prepHTMLFile(htmlFile,preppedHTMLFileName) генерирует подготовленный HTML в файл с именем, заданным preppedHTMLFile.The подготовили HTML в preppedHTMLFileName можно преобразовать в представление DOM API при помощи mlreportgen.dom.HTMLFile объект.

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

Примеры

свернуть все

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

Составьте таблицу стилей CSS, myCSS.css, чтобы указать, что текст в абзаце является красным и что семейство шрифтов - Arial. 

p {
    color: red;
    font-family: Arial;
   }

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

<html>
<head>
    <link rel="stylesheet" type="text/css" href="myCSS.css" >
</head>
<body>
    <p> Hello World</p>
</body>
</html>

HTML не является XML-синтаксическим, поскольку link элемент не закрыт должным образом. Косая черта / перед закрывающей угловой скобкой > отсутствует.

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

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

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

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

import mlreportgen.dom.*
import mlreportgen.utils.html2dom.*
d = Document("test","pdf");
preppedHTMLFile = prepHTMLFile("myHTML.html","mypreppedHTML.html");
htmlObj = HTMLFile(preppedHTMLFile);
append(d,htmlObj);
close(d);
rptview(d);

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

свернуть все

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

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

Пример: "myHTML.html"

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

свернуть все

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

Имя файла, который содержит подготовленный 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

MATLAB Report Generator

Поддержка