Exponenta Banner
exponenta event banner

mlreportgen.utils.html2dom.prepHTMLFile

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

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

Синтаксис

preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLFile (startFile)
preppedHTMLFileName = mlreportgen.utils.html2dom.prepHTMLFile (startFile, prepedHTMLFileName)
preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLFile (___, «Tidy», false)

Описание

preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLFile(htmlFile) подготавливает HTML в файле, указанном htmlFile для преобразования во внутреннюю объектную модель документа (DOM) MATLAB ® Report Generator™. Подготовленный 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 объекты. Атрибут style для каждого элемента определяет свойства CSS элемента, вычисленные веб-браузером MATLAB.

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

пример

preppedHTMLFileName = mlreportgen.utils.html2dom.prepHTMLFile(htmlFile,preppedHTMLFileName) создает подготовленный HTML в файле с именем, указанным preppedHTMLFile.Готовый 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 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

Поддержка