Référence de la syntaxe de personnalisation de groupe

Article
04/08/2023

groupProps

Groupe les options de personnalisation liées au groupe. Valable dans les mises en page« Liste », « Liste compacte » et « Galerie ».

headerFormatter

Objet JSON qui définit le format de l'en-tête de groupe. Le schéma de cet objet JSON est identique à celui d’une mise en forme de colonne. Pour plus d’informations sur ce schéma et ses fonctionnalités, voir la référence de syntaxe de mise en forme. Valable dans les mises en page« Liste », « Liste compacte » et « Galerie ».

footerFormatter

Objet JSON qui définit le format du pied de page des groupes et des listes. Le schéma de cet objet JSON est identique à celui d’une mise en forme de colonne (et d’une mise en forme de ligne). Pour plus d’informations sur ce schéma et ses fonctionnalités, voir la référence de syntaxe de mise en forme. Valable dans les mises en page « Liste », « Liste compacte » et « Galerie ».

hideFooter

Élément facultatif. Spécifie si les pieds de liste ou les pieds de groupe de la vue sont masqués ou non. false est le comportement par défaut (ce qui signifie que le pied de page est visible). true signifie que la vue n'affichera pas les pieds de page. Valable dans les mises en page « Liste », « Liste compacte » et « Galerie ».

Pour la mise en page de la liste et de la liste compacte, hideFooterremplace le footerFormatter, s'il est présent.

Valeurs de chaînes spéciales

Les valeurs pour txtContent, les styles et les attributs peuvent être des chaînes ou des objets Expression. Quelques modèles spéciaux de chaînes de caractères sont pris en charge pour récupérer les valeurs des groupes et des agrégats.

« @groupe »

Permet d'accéder aux données, au nom d'affichage et au nombre d'éléments de la colonne groupée. Valable dans les mises en page« Liste », « Liste compacte » et « Galerie ». Disponible uniquement à l'intérieurgroupProps.

L'@groupobjet possède les propriétés suivantes (avec des exemples de valeurs) :

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

Vous pouvez également accéder aux sous-propriétés des champs avec des données enrichies, par exemple le champ Personnes, comme mentionné sous Mise en forme des valeurs de chaîne spéciale.

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

Permet d'accéder à la valeur, au nom d'affichage et au type d'agrégat de la colonne agrégée. Valable dans les mises en page « Liste », « Liste compacte » et « Galerie ». Disponible uniquement à l'intérieurfooterFormatter.

L'@columnAggregateobjet possède les propriétés suivantes (avec des exemples de valeurs) :

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

« @aggregates »

Permet d'accéder au tableau de la valeur de la colonne agrégée, du nom d'affichage et du type d'agrégat. Valable dans les mises en page« Liste », « Liste compacte » et « Galerie ». Disponible uniquement à l'intérieurgroupProps.

L’objet possède les propriétés suivantes (avec une valeur d’exemple) et peut être itéré à l’aide de la propriété @aggregatesFormatting forEach.

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

Partager via