mlreportgen.dom.HTMLFile 类
命名空间: mlreportgen.dom
超类: mlreportgen.dom.HTML
将 HTML 文件转换为 DOM 文档
描述
使用 mlreportgen.dom.HTMLFile 类的实例将 HTML 文件的内容转换为一个 mlreportgen.dom.HTMLFile 对象，该对象包含内容和格式与原文件相同的 DOM 对象。您可以将 HTMLFile 对象追加到任何类型的 DOM 文档，包括 Word 和 PDF 文档。
要了解可以将 mlreportgen.dom.HTMLFile 对象追加到哪些 DOM 对象，请参阅将 mlreportgen.dom.HTMLFile 对象追加到 DOM 类对象上。
mlreportgen.dom.HTMLFile 类是一个 handle 类。
创建对象
描述
htmlFileObj = HTMLFile(htmlFile)HTMLFile 对象。不支持的 HTML 元素和属性将被忽略。此外，HTMLFile 对象接受包含自定义 CSS 属性的 HTML，这些属性以连字符开头。HTML、Microsoft® Word 和 PDF 输出支持自定义 CSS 属性。
有关支持的 HTML 元素和 CSS 格式的完整列表，请参阅 支持的 HTML 元素和 CSS 格式。
输入参量
属性
方法
示例
创建一个名为 myHTML.html 的文本文件并将其保存在当前文件夹中。将此文本添加到文件中：
<html>
<head>
<style>p {font-size:14pt;}</style>
</head>
<body>
<p style="white-space:pre"><b>Hello</b><i style="color:green"> World</i></p>
<p>This is <u>me</u> speaking</p>
</body>
</html>
要将 myHTML.html 文件转换为 Word 报告，请运行以下命令：
import mlreportgen.dom.*; rpt = Document("MyReport","docx"); htmlFile = HTMLFile("myHTML.html"); append(rpt,htmlFile); close(rpt); rptview(rpt.OutputPath);
详细信息
提示
为了使 HTML 标记在您的报告中正确显示，您必须为空元素包含结束标记，并将属性值括在引号中。如果要将保留的 XML 标记字符显示为文本，则必须使用其等效的命名或数字 XML 字符。
保留字符 描述 等效字符 >大于 ><小于 <&“&” &"双引号 "'单引号 '%百分号 %HTMLFile忽略KeepInterElementWhiteSpace属性。如果要保留空白，请使用fileread将 HTML 文件读取为文本，然后按照mlreportgen.dom.HTMLKeepInterElementWhiteSpace属性所述的步骤进行操作。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 以删除有效但不想要的对象，例如原始内容中的换行符。Word 和 PDF 文档要求在段落中包含内联元素（例如文本和链接）。为了满足此要求，HTML 解析器创建包装段落来包含段落中尚不存在的内联元素。如果从包含不在段落中的内联元素的 HTML 创建
mlreportgen.dom.HTML或mlreportgen.dom.HTMLFile对象并将该对象添加到 HTML 文档，则生成的 HTML 可能与输入的 HTML 不同。要生成不带添加包装段落的内联元素，请使用mlreportgen.dom.RawText对象将 HTML 标记插入 HTML 文档。默认情况下，DOM API 使用 12 磅的基本字体大小将
em单位转换为实际字体大小。例如，指定为2em的字体大小将转换为 24 磅。要指定不同的基本字体大小，请使用mlreportgen.dom.HTML对象将内容添加到报告中。将对象的EMBaseFontSize属性设置为基本字体大小。例如，如果将EMBaseFontSize属性设置为 14，则字体大小2em将转换为 28 磅。
版本历史记录
在 R2015a 中推出
