创建正式表
DOM API 正式表有页眉、正文和页脚部分。当页眉或页脚有多行时,正式表很有用。单独的页眉、正文和页脚部分方便添加行并独立于其他部分格式化页眉、正文或页脚。有关可在报告中创建的其他类型表的信息,请参阅 在报告生成器中选择要创建的表类型。有关格式化表的信息,请参阅 格式化表。
正式表由 mlreportgen.dom.FormalTable
对象表示。页眉、正文和页脚部分分别由 mlreportgen.dom.TableHeader
、mlreportgen.dom.TableBody
和 mlreportgen.dom.TableFooter
对象表示。每个节都有行和表条目。行由 mlreportgen.dom.TableRow
对象表示。正文和页脚部分的条目由 mlreportgen.dom.TableEntry
对象表示。标题中的条目由 mlreportgen.dom.TableHeaderEntry
或 mlreportgen.dom.TableEntry
对象表示。
您可以从 MATLAB® 数组创建正式表的各个部分。这种方法最简单,因为您不必创建 TableRow
和 TableEntry
或 TableHeaderEntry
对象。您还可以通过从 TableRow
和 TableEntry
或 TableHeaderEntry
对象构建表来创建节。此方法对于复杂的格式要求很有用,例如当条目跨越多列或多行时。您可以结合使用这些方法。例如,您可以从数组创建表体,并从行和条目构建表头。
从 MATLAB 数组创建正式表
使用 mlreportgen.dom.FormalTable
构造函数创建一个正式表。构造函数可选择接受二维数组或 MATLAB 数据的元胞数组作为正文、页眉和页脚部分。请参阅 mlreportgen.dom.FormalTable
参考页面上的 header
、body
和 footer
参量。有关从字符串数组创建正式表头以及从元胞数组创建正式表体的示例,请参阅 从元胞数组创建表。
从行和条目创建正式表
您可以通过将表条目追加到表行并将行追加到部分来构建正式表的表头、正文或表脚部分。
要创建标题条目,您可以使用 mlreportgen.dom.TableHeaderEntry
或 mlreportgen.dom.TableEntry
对象。如果您从数组创建标题,则 DOM API 会将条目创建为 TableHeaderEntry
对象。在 HTML 报告中,DOM API 将 TableHeaderEntry
对象呈现为 th
(表头单元格)元素。此渲染依赖于浏览器来格式化表条目。对于 Word 和 PDF 报告,默认情况下,DOM API 将 TableHeaderEntry
对象呈现为未格式化的 Word 或 PDF 表条目元素。您可以使用 TableHeaderEntry
对象属性来格式化为所有输出类型生成的表条目。例如,您可以使用这些属性来覆盖 HTML 报告中的浏览器格式。
要根据表行和条目构建正式表的一部分,可以使用 FormalTable
appendHeaderRow
、append
和 appendFooterRow
方法将行追加到表页眉、正文或页脚部分。或者,您可以使用 Header
对象的 Body
、Footer
或 FormalTable
属性访问某个部分,然后使用 append
方法将行追加到该部分。
有关从条目和行构建标题的示例,请参阅跨行和跨列创建表条目中的步骤 2正式表。
另请参阅
mlreportgen.dom.FormalTable
| mlreportgen.dom.TableEntry
| mlreportgen.dom.TableBody
| mlreportgen.dom.TableFooter
| mlreportgen.dom.TableHeader
| mlreportgen.dom.TableHeaderEntry
| appendFooterRow
| appendHeaderRow