本页采用了机器翻译。点击此处可查看英文原文。

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

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.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;
   }

创建一个包含以下 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);

输入参数

全部折叠

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

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

示例: "myHTML.html"

输出参量

全部折叠

准备好的 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 以删除有效但不想要的对象，例如原始内容中的换行符。

版本历史记录

在 R2020a 中推出

另请参阅

| | |

主题