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

mlreportgen.utils.html2dom.prepHTMLString

准备 HTML 字符串以转换为 DOM

全页折叠

语法

preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLString(htmlStr)
preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLString(htmlStr,"Tidy",false)

说明

preppedHTMLStr = mlreportgen.utils.html2dom.prepHTMLString(htmlStr) 准备将 htmlStr 指定的字符串中的 HTML 转换为 MATLAB® Report Generator™ 内部文档对象模型 (DOM)。可以使用 mlreportgen.dom.HTML 对象将 preppedHTMLStr 中准备好的 HTML 转换为 DOM API 表示。 mlreportgen.utils.html2dom.prepHTMLString 函数：

  • 通过使用 HTML 输出设置调用 mlreportgen.utils.tidy 来纠正无效标记。

  • 使用 MATLAB HTML 查看器将整理后的标记转换为 HTML DOM 文档。请参阅https://www.w3.org/TR/WD-DOM/introduction.html。

    MATLAB HTML 查看器根据输入 HTML 指定的内部和外部样式表以及元素的样式属性计算 HTML 输入中元素的 CSS 属性。CSS 属性计算支持所有有效的 CSS 样式表选择器，包括 mlreportgen.dom.HTML 对象不直接支持的选择器。

  • 将 HTML DOM 文档转换为 mlreportgen.dom.HTML 对象支持的 HTML 标记。每个元素的 style 属性指定了 MATLAB HTML 查看器计算的元素 CSS 属性。

  • 将准备好的 HTML 作为字符串标量返回。

示例

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

示例

全部折叠

使用 mlreportgen.utils.html2dom.prepHTML 准备 HTML 字符串，以便转换为可以追加到报告中的 DOM 对象。

创建一个名为 myHTMLStr 的字符串，其 HTML 内容如下：

myHTMLStr = "<html><body><p>This is the first paragraph.<p>" + ...
    "This is the second paragraph.<p></body></html>";

该段落缺少结束标记 / 中的 </p>。

尝试将 HTML 转换为 DOM 对象并将该对象追加到报告中。

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

mlreportgen.dom.HTML 因缺少结束标记而以错误结束。

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

import mlreportgen.dom.*; 
rpt = Document("MyReport","docx");
%prepare the HTML 
myPreppedHTML = mlreportgen.utils.html2dom.prepHTMLString(myHTMLStr);
htmlObj = mlreportgen.dom.HTML(myPreppedHTML);
append(rpt,htmlObj); 
close(rpt); 
rptview(rpt);

输入参数

全部折叠

准备转换为 DOM 的 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 中推出

另请参阅

| | |

主题