Справочник по синтаксису групповой настройки

Статья
04/08/2023

groupProps

Группирует параметры настройки, связанные с группой. Применимо в макетах "Список", "Компактный список" и "Галерея".

headerFormatter

Объект JSON, который определяет формат для заголовка группы. Схема этого объекта JSON идентична схеме формата столбца. Подробные сведения об этой схеме и ее возможностях см. в статье Справочник по синтаксису форматирования. Применимо в макетах "Список", "Компактный список" и "Галерея".

footerFormatter

Объект JSON, определяющий формат для итоговой строки группы и нижнего колонтитула списка. Схема этого объекта JSON идентична схеме формата столбца (и элемента rowFormatter). Подробные сведения об этой схеме и ее возможностях см. в статье Справочник по синтаксису форматирования. Применимо в макетах "Список" и "Компактный список".

hideFooter

Необязательный элемент. Указывает, скрыты ли в представлении итоговые строки групп или нижний колонтитул списка. Значение false — это поведение по умолчанию (означает, что итоговая строка группы видима). Значение true означает, что в представлении не будут отображаться итоговые строки групп. Применимо в макетах "Список" и "Компактный список".

Для макета списка и компактного списка hideFooter, если задано, имеет приоритет над footerFormatter.

Значения специальных строк

Значения txtContent, стили и атрибуты могут представлять собой строки или объекты выражений. Поддерживаются несколько специальных шаблонов строк для извлечения значений из групп и агрегатных значений.

"@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 содержит следующие свойства (с примером значения), и по нему можно выполнить итерацию с помощью свойства Formatting forEach.

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

Поделиться через