mlreportgen.utils.html2dom.prepHTMLFile

准备 HTML 文件以转换为 DOM

自 R2020a 起

语法

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) 准备将 htmlFile 指定的文件中的 HTML 转换为 MATLAB^® Report Generator™ 内部文档对象模型(DOM)。可以使用 mlreportgen.dom.HTML 对象将 preppedHTMLStr 中准备好的 HTML 转换为 DOM API 表示。mlreportgen.utils.html2dom.prepHTMLFile 函数：

通过使用 HTML 输出设置调用 mlreportgen.utils.tidy 来纠正无效标记。
使用 MATLAB 网络浏览器将整理后的标记转换为 HTML DOM 文档。请参阅https://www.w3.org/TR/WD-DOM/introduction.html。
MATLAB 网络浏览器根据输入 HTML 指定的内部和外部样式表以及元素的样式属性来计算 HTML 输入中元素的 CSS 属性。CSS 属性计算支持所有有效的 CSS 样式表选择器，包括 mlreportgen.dom.HTML 或 mlreportgen.dom.HTMLFile 对象不直接支持的选择器。
将 HTML DOM 文档转换为 mlreportgen.dom.HTML 和 mlreportgen.dom.HTMLFile 对象支持的 HTML 标记。每个元素的样式属性指定 MATLAB 网络浏览器计算的元素 CSS 属性。
将准备好的 HTML 作为字符串标量返回。

示例

preppedHTMLFileName = mlreportgen.utils.html2dom.prepHTMLFile(htmlFile,preppedHTMLFileName) 在由 preppedHTMLFile 指定名称的文件中生成准备好的 HTML。preppedHTMLFileName 中准备好的 HTML 可以通过使用 mlreportgen.dom.HTMLFile 对象转换为 DOM API 表示。

preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLFile(___,"Tidy",false) 准备 HTML 而不先整理它。在所有其他输入参量后指定 "Tidy",false。如果您想自己整理 HTML 标记，请使用此语法。例如，您可能希望使用与 mlreportgen.utils.html2dom.prepHTMLFile 不同的选项来调用 mlreportgen.utils.tidy，然后将整理好的 HTML 作为输入传递给 mlreportgen.utils.html2dom.prepHTMLFile。

示例

全部折叠

准备 HTML 文件以转换为 DOM 对象

使用 mlreportgen.utils.html2dom.prepHTMLFile 准备一个 HTML 文件，以便转换为可以追加到报告中的 DOM 对象。

创建 CSS 样式表 myCSS.css，指定段落中的文本为红色且字体系列为 Arial。

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

创建一个包含以下 HTML 的文件 myHTML.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 因缺少结束标签而以错误结束。

使用 mlreportgen.utils.html2dom.prepHTMLFile 准备将 HTML 转换为 DOM。从准备好的 HTML 创建一个 mlreportgen.dom.HTMLFile 对象并将该对象追加到报告中。

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);

输入参数

全部折叠

`htmlFile` — HTML 文件
字符向量 | 字符串标量

准备转换为 DOM 的 HTML 文件，指定为字符向量或字符串标量。

`preppedHTMLFileName` — 准备好的 HTML 文件
字符向量 | 字符串标量

准备好的 HTML 文件，指定为字符向量或字符串标量。

示例: "myHTML.html"

输出参量

全部折叠

`preppedHTMLStr` — 准备好的 HTML
字符串标量

准备好的 HTML，以字符串标量的形式返回。

`preppedHTMLFileName` — 包含已准备好的 HTML 的文件的名称
字符串标量

包含已准备好的 HTML 的文件的名称，以字符串标量的形式返回。

提示

MATLAB Report Generator mlreportgen.dom.HTML 或 mlreportgen.dom.HTMLFile 对象通常无法接受将原生文档导出为 HTML 标记的第三方应用程序（例如 Microsoft^® Word）的原始 HTML 输出。在这些情况下，您的报告 API 报告生成程序可以使用 mlreportgen.utils.html2dom.prepHTMLString 和 mlreportgen.utils.html2dom.prepHTMLFile 函数准备原始 HTML 以供 mlreportgen.dom.HTML 或 mlreportgen.dom.HTMLFile 对象使用。通常，您的程序必须进一步处理准备好的 HTML 以删除有效但不想要的对象，例如原始内容中的换行符。