Referencia de sintaxis de personalización de grupo

groupProps

Agrupa las opciones de personalización relacionadas con el grupo. Válido en los diseños "Lista", "Lista compacta" y "Galería".

headerFormatter

Objeto JSON que define el formato del encabezado de grupo. El esquema de este objeto JSON es idéntico al esquema de formato de columna. Para obtener información detallada sobre este esquema y sus capacidades, vea la referencia de sintaxis de formato. Válido en los diseños "Lista", "Lista compacta" y "Galería".

footerFormatter

Objeto JSON que define el formato del encabezado de grupo y pie de página de lista. El esquema de este objeto JSON es idéntico al esquema de formato de columna (y al de rowFormatter). Para obtener información detallada sobre este esquema y sus capacidades, vea la referencia de sintaxis de formato. Válido en los diseños "Lista" y "Lista compacta"

hideFooter

Elemento opcional. Especifica si los pies de página de la lista o los pies de grupo en la vista están ocultos o no. false es el comportamiento predeterminado (que significa que el pie de página es visible). true quiere decir que la vista no muestra los pies de página. Válido en los diseños "Lista" y "Lista compacta"

Para el diseño de lista y lista compacta, hideFooter anula el footerFormatter, si está presente.

Valores de cadena especial

Los valores de txtContent, estilos y atributos pueden ser cadenas u objetos de expresión. Se admiten algunos modelos de cadena especial para recuperar los valores de los campos de la lista y el contexto del usuario.

"@group"

Proporciona acceso a los datos de la columna agrupada, el nombre para mostrar y el recuento de elementos. Válido en los diseños "Lista", "Lista compacta" y "Galería". Disponible solo en groupProps

El objeto @group tiene las propiedades siguientes (con valores de ejemplo):

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

También puede acceder a subpropiedades para campos con datos enriquecidos, como Campo de personas, como se menciona en Valores de cadena especiales de formato.

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

Proporciona acceso al valor de la columna agregada, el nombre para mostrar y el tipo de agregado. Válido en los diseños "Lista" y "Lista compacta" Disponible solo en footerFormatter

El objeto @columnAggregate tiene las propiedades siguientes (con valores de ejemplo):

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

"@aggregates"

Proporciona acceso a una matriz de valores de columnas agregadas, nombre para mostrar y tipo de agregación. Válido en los diseños "Lista", "Lista compacta" y "Galería". Disponible solo en groupProps

El objeto @aggregates tiene las siguientes propiedades (con un valor de ejemplo) y se puede iterar utilizando la propiedad de formato forEach.

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