title: table
icon: cuboidBloc tableau
Introduction
Ce bloc est fait pour afficher des données sous forme d'un tableau. Il est une enveloppe autour de la bibliothèque DataTables.
Configuration
Options du tableau
Modifier les options
Les options du tableau sont modifiables en cliquant sur le bouton Modifier les options. Cela ouvre une fenêtre modale qui permet de modifier les options du tableau.
Ces options proviennent de la bibliothèque DataTables.
⚠ Attention : Les options du tableau sont initialement écrites en JavaScript. Pour les utiliser dans ce bloc, il est nécessaire de les convertir en JSON donc toutes les fonctionnalités ne pourront pas être utilisées.
Options de colonne
La configuration des colonnes du tableau est possible en cliquant sur le bouton Modifier les colonnes. Cela ouvre une fenêtre modale qui permet de modifier les colonnes du tableau.
Cette fenêtre se compose d'une barre latérale listant les colonnes actuelles du tableau et d'une zone central permettant de configurer les colonnes.
La barre latérale permet également de masquer des colonnes.
Valeur secondaire
La valeur secondaire est une valeur qui s'affiche en dessous de la valeur principale.
Rendu :
Valeur récapitulative
La valeur récapitulative est une valeur qui s'affiche en dessous de la colonne et qui récapitule les valeurs de la colonne (exemple : somme, moyenne, etc.).
Rendu :
Il existe plusieurs opérations possibles :
- Texte : permet de définir le contenu de la cellule.
- Somme : permet de calculer la somme des valeurs de la colonne.
- Moyenne : permet de calculer la moyenne des valeurs de la colonne.
- Minimum : permet de trouver la valeur minimale de la colonne.
- Maximum : permet de trouver la valeur maximale de la colonne.
- Quantité : permet de compter le nombre de valeurs de la colonne.
Toutes ces opérations sont soumise à un filtre (si défini). Ce filtre est configurable grâce au résumé de filtre.
Interactions
Les interactions permettent de définir des actions sur les colonnes.
Actuellement, il n'existe qu'une action au clic sur la colonne, c'est ouvrir un lien :
Rendu :
Format
Le format permet de définir un format pour les valeurs de la colonne.
Les formats actuellement disponibles sont :
- Surface : permet de séparer une valeur en ha, a et ca.
- Arrondi : permet d'arrondir une valeur à une précision configurable.
- Monnaie : permet de formater une valeur en monnaie configurable.
Il est également possible d'ajouter un préfixe ou un suffixe à la valeur. Par exemple : ajouter un symbole de pourcentage à la fin d'une valeur.
rendu :
Options de lignes
La configuration des lignes du tableau est possible en cliquant sur le bouton Modifier les lignes. Cela ouvre une fenêtre modale qui permet de modifier les lignes du tableau.
Cette fenêtres permet actuellement d'appliquer un formatage à une ligne en fonction d'un filtre grâce au résumé de filtre.
Les formats disponibles sont :
rendu :
Source des données
Il y a deux cas possibles pour définir les données du tableau :
-
Si le bloc tableau est dans un bloc de données alors, cette section affichera un message indiquant que les données sont récupérées par le bloc de données.
-
Si le bloc tableau est seul, alors il est possible de définir les données directement dans le bloc tableau. L'explication du processus est faite sur la page du bloc de données.
Dans les deux cas, des transformations peuvent être appliquées sur les données au moyen d'un middleware.
De même, il est possible d'obtenir un aperçu des données sous forme de tableau ou d'obtenir un perçu du tableau grâce aux boutons :
