组自定义语法参考

项目
01/12/2024

groupProps

对组相关的自定义选项进行分组。在“列表”、“压缩列表”和“库”布局中有效。

headerFormatter

定义组头格式的 JSON 对象。此 JSON 对象的架构与列格式的架构相同。有关此架构及其功能的详细信息，请参阅格式语法参考。在“列表”、“压缩列表”和“库”布局中有效。

footerFormatter

定义组和列表页脚格式的 JSON 对象。此 JSON 对象的架构与列格式的架构（以及 rowFormatter 的架构）相同。有关此架构及其功能的详细信息，请参阅格式语法参考。在 “列表” 和 “压缩列表” 布局中有效。

hideFooter

可选元素。指定是否隐藏视图中的列表页脚或组尾。 false 是默认行为（这意味着页脚是可见的）。 true 这意味着该视图不显示页脚。在 “列表” 和 “压缩列表” 布局中有效。

对于列表和压缩列表布局，如果存在，hideFooter 将覆盖 footerFormatter。

特殊字符串值

txtContent、style 和 attributes 的值可以是字符串，也可以是表达式对象。支持使用一些来自于组和聚合中特殊字符串模式的检索值。

“@group”

提供对分组列的数据、显示名称和项目计数的访问权限。在“列表”、“压缩列表”和“库”布局中有效。仅支持在 groupProps 内部使用。

@group 对象具有以下属性 (含示例值):

{
    "fieldData": "California",
    "columnDisplayName": "City",
    "count": 3
}

也可以访问具有丰富数据字段的子属性，例如在格式化特殊字符串值下提到的“人员”字段。

{
  "fieldData": {
    "id": "122",
    "title": "Kalya Tucker",
    "email": "kaylat@contoso.com",
    "sip": "kaylat@contoso.com",
    "picture": "https://contoso.sharepoint.com/kaylat_contoso_com_MThumb.jpg?t=63576928822",
    "department": "Human Resources",
    "jobTitle": "HR Manager"
  },
  "columnDisplayName": "Author",
  "count": 5
}

“@columnAggregate”

提供对聚合列的值、显示名称和聚合类型的访问权限。在 “列表” 和 “压缩列表” 布局中有效。仅支持在 footerFormatter 内部使用。

@columnAggregate 对象具有以下属性 (含示例值):

{
  "value": "3",
  "columnDisplayName": "Approved",
  "type": "Count"
}

“@aggregates”

提供对聚合列值的数值、显示名称和聚合类型的访问权限。在“列表”、“压缩列表”和“库”布局中有效。仅支持在 groupProps 内部使用。

@aggregates 对象具有以下属性 (含示例值)，并可通过使用格式化 forEach 属性进行迭代。

[
  {
    "value": "3",
    "columnDisplayName": "Approved",
    "type": "Count"
  },
  {
    "value": "1.2",
    "columnDisplayName": "Growth",
    "type": "Average"
  },
  {
    "value": "0.33%",
    "columnDisplayName": "Rate of change",
    "type": "Variance"
  }
]

通过