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

mlreportgen.dom.Collapsible 类

命名空间: mlreportgen.dom

HTML 表中的可折叠行

自 R2025a 起

全页展开

描述

使用 mlreportgen.dom.Collapsible 类中的对象来指定 HTML 表中要折叠的表行数。

此类仅与以下 MATLAB® Report Generator™ 输出类型兼容：

  • "html"

  • "html-file"

  • "html-multipage" (自 R2024a 起)

mlreportgen.dom.Collapsible 类是一个 handle 类。

类属性

HandleCompatible
true
ConstructOnLoad
true

有关类属性的信息，请参阅类属性。

创建对象

输入参量

全部展开

折叠格式化行后的行数，指定为整数。

属性

全部展开

要折叠的行数，指定为整数。此属性的值表示点击格式化行后，将折叠的格式化行之后的行数。

属性：

NonCopyable
true

数据类型: uint64

标记，指定为字符向量或字符串标量。DOM API 在创建此对象的过程中生成一个会话唯一标记。生成的标记形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。使用此值来帮助确定在文档生成过程中出现的问题的位置。

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

目标标识符，指定为字符向量或字符串标量。DOM API 在创建文档元素对象时会生成一个会话唯一标识符。

属性：

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

示例

全部折叠

打开实时脚本

此示例演示了如何创建带有可折叠行或嵌套可折叠行的 HTML 表。您可以使用可折叠父行来隐藏或显示与每行父行关联的子级行中的内容。

创建带可折叠行的表

导入 mlreportgen.report 和 mlreportgen.dom 命名空间，这样就无需为对象构造函数和方法包含完全限定名称。 

import mlreportgen.report.*
import mlreportgen.dom.*

创建一个 HTML 文档。

rpt = Report("myCollapsibleTables","html");
open(rpt);

为包含可折叠行的表创建一个章节。

chap1 = Chapter("Table with collapsible rows");

将表数据指定为字符串的元胞数组。数组中的每个字符串都包含表中一行对应的文本。

collapsibleTableData = { ...
    "Parent Row: Click to expand next 2 rows"; ...
    "  Collapsible Content for Parent Row"; ...
    "  More Collapsible Content for Parent Row"; ...
    "Static Row" ...
    };

创建表并设置基本样式。若要保留行首的空格，请在第二行和第三行中使用 WhiteSpace("preserve")。

tbl = Table(collapsibleTableData);
tbl.Border = "solid";
tbl.RowSep = "solid";
tbl.ColSep = "solid";
tbl.Style = [tbl.Style {WhiteSpace("preserve")}];

将表的第一行设置为可折叠状态，这样点击该行即可折叠其下方的两行。

row1 = tbl.row(1);
row1.Style = [row1.Style {Collapsible(2)}];

将表附加到章节，将章节附加到报告。

append(chap1,tbl);
append(rpt,chap1);

关闭并查看报告。

close(rpt);
rptview(rpt);

要打开或关闭一组可折叠行，请点击父行。将鼠标悬停在可折叠行上时，该行会以浅灰色高亮显示。

此图显示了在报告中完全展开并折叠第二行时表的外观。

Chapter 1 heading followed by a table with 4 rows. The rows describe their function as parent, collapsible, or static.

所有行均展开的表

Chapter 1 heading followed by a table with 2 of the 4 rows collapsed.

第二行折叠的表

版本历史记录

在 R2025a 中推出

另请参阅

|