Syntaxreferenz zur Gruppenanpassung

groupProps

Gruppiert die gruppenbezogenen Anpassungsoptionen. Gültig in den Layouts „Liste“, „Kompaktliste“ und „Katalog“.

headerFormatter

JSON-Objekt, welches das Format für die Gruppenkopfzeile definiert. Das Schema dieses JSON-Objekts ist identisch mit dem Schema eines Spaltenformats. Ausführliche Informationen zu diesem Schema und seinen Funktionen finden Sie in der Referenz zur Formatierungssyntax. Gültig in den Layouts „Liste“, „Kompaktliste“ und „Katalog“.

footerFormatter

JSON-Objekt, welches das Format für die Gruppen- und LIstenfußzeilen definiert. Das Schema dieses JSON-Objekts ist identisch mit dem Schema eines Spaltenformats (und dem von "rowFormatter"). Ausführliche Informationen zu diesem Schema und seinen Funktionen finden Sie in der Referenz zur Formatierungssyntax. Gültig in den Layouts „Liste“ und „Kompaktliste“.

hideFooter

Optionales Element. Gibt an, ob die Listen- oder Gruppenfußzeilen in der Ansicht ausgeblendet sind oder nicht. false ist das Standardverhalten (die Fußzeile ist sichtbar). true bedeutet, dass die Ansicht keine Fußzeilen anzeigt. Gültig in den Layouts „Liste“ und „Kompaktliste“.

Für die Layouts Liste & Kompaktliste überschreibt hideFooter den footerFormatter, falls vorhanden.

Spezialzeichenfolgenwerte

Die Werte für txtContent, Formatvorlagen und Attribute können entweder Zeichenfolgen oder Objekte des Typs „Ausdruck“ sein. Einige spezielle Zeichenfolgemuster zum Abrufen von Werten aus der Gruppe und dem Aggregat werden unterstützt.

„@group“

Bietet Zugriff auf die Daten, den Anzeigenamen und die Anzahl der Elemente der gruppierten Spalte. Gültig in den Layouts „Liste“, „Kompaktliste“ und „Katalog“. Nur innerhalb von groupProps verfügbar.

Das @group-Objekt verfügt über die folgenden Eigenschaften (mit Beispielwerten):

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

Sie können auch auf Untereigenschaften für Felder mit umfangreichen Daten zugreifen, z. B. das Feld „Personen“, wie unter Formatierung spezieller Zeichenfolgewerte erwähnt.

{
  "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“

Bietet Zugriff auf den Wert, den Anzeigenamen und den aggregierten Typ der aggregierten Spalte. Gültig in den Layouts „Liste“ und „Kompaktliste“. Nur innerhalb von footerFormatter verfügbar.

Das @columnAggregate-Objekt verfügt über die folgenden Eigenschaften (mit Beispielwerten):

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

„@aggregates“

Bietet Zugriff auf ein Array mit dem Wert, dem Anzeigenamen und dem aggregierten Typ der aggregierten Spalte. Gültig in den Layouts „Liste“, „Kompaktliste“ und „Katalog“. Nur innerhalb von groupProps verfügbar.

Das @aggregates-Objekt verfügt über die folgenden Eigenschaften (mit Beispielwerten) und kann über die Eigenschaft ForEach-Formatierung iteriert werden.

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