Permet d’afficher un graphique à partir de plusieurs datasets. Des classes CSS sont disponibles pour modifier l’aspect du widget : widget-meter, widget-meter-bar / widget-meter-doughnut, widget-meter-legend, widget-meter-btn.
Hérite de WidgetButton.
Fonction
Rendu
Utilisation
L’ensemble des options de WidgetMeter acceptent des valeurs dynamiques ({dataset.field} ou ~some javascript code~).
ATTENTION :
- Si une valeur dynamique passée à une option renvoie une valeur vide, le widget se mettra en erreur (et sera remplacé par un WidgetErrors) même si l’option est facultative.
- L’affichage en anneau ne supporte pas pour l’instant les conditions d’affichage et le redimmensionnement (développement à venir).
Imprimer un WidgetMeter
Les navigateurs n’imprimant pas par défaut les couleurs d’arrière plan (background-color), un WidgetMeter peut disparaître lors de l’impression (transformation en PDF ou impression sur imprimante) d’un formulaire. Pour régler cette situation, l’utilisateur devra trouver et activer dans la boîte de dialogue d’impression un paramètre du type “Imprimer les couleurs d’arrière plan”, “Graphiques d’arrière plan”, “Imprimer les arrières plan”, etc.
Attributs
Les attributs nécessaires au bon fonctionnement du widget sont signalés par un astérisque.
Ce widget hérite de fonctionnalités issues d’un autre widget. Consultez la documentation dédiée au WidgetButton pour vérifier si d’autres attributs sont disponibles.
action
Action souhaitée lors du click sur l’action_target.
-
Version : >=2.26
-
Valeurs possibles : ‘exit’, ‘none’
label
Titre du graphique.
-
Version : >=2.26
-
Valeurs possibles : ‘titre’ ou {dataset.field}
Options
Les options nécessaires au bon fonctionnement du widget sont signalées par un astérisque.
Ce widget hérite de fonctionnalités issues d’un autre widget. Consultez la documentation dédiée au WidgetButton pour vérifier si d’autres options sont disponibles.
data
Données utilisées pour le graphique. Il est obligatoire de renseigner au moins une option data_field_n. Chaque option data_field/color/label doit être suivie d’un chiffre n.
-
Version : >=2.26
-
Valeurs possibles : null
data_color_n*
Couleur appliquée à la donnée n au sein du graphique.
-
Version : >=2.26
-
Valeurs possibles : nom de couleur (RGB, Hexa, etc + couleurs bootstrap) ou {dataset.field}
data_field_n*
Valeur de la donnée n à intégrer au graphique.
-
Version : >=2.26
-
Valeurs possibles : string contenant un nombre ou {dataset.field}
data_label_n*
Label de la donnée n à afficher dans la légende.
-
Version : >=2.26
-
Valeurs possibles : string ou {dataset.field}
action_target
Cible de l’action spécifiée via l’attribut ‘action’ : partie du graphique sur laquelle l’utilisateur doit cliquer pour déclencher l’action.
-
Version : >=2.26
-
Valeurs possibles : ‘global’, ‘title’, ‘data_to_print’ ou ‘chart’ ou {dataset.field}
-
Valeur par défaut : global
data_to_print
Numéro de l’option data (n dans data_field_n) que l’utilisateur souhaite mettre en avant. Permet d’afficher la valeur et le label.
-
Version : >=2.26
-
Valeurs possibles : String contenant un nombre ou {dataset.field}
data_to_print_color
Couleur de police du texte affiché via data_to_print.
-
Version : >=2.26
-
Valeurs possibles : Nom de couleur (RGB, Hexa, etc + couleurs bootstrap) ou {dataset.field}
denominator_color
Couleur de police du label du dénominateur.
-
Version : >=2.26
-
Valeurs possibles : Nom de couleur (RGB, Hexa, etc + couleurs bootstrap) ou {dataset.field}
-
Valeur par défaut : black
denominator_field
Valeur qui servira de dénominateur commun pour calculer les ratios. S’il n’est pas précisé, le dénominateur commun sera la somme des valeurs fournies via les options data_field_n.
-
Version : >=2.26
-
Valeurs possibles : string contenant un nombre ou {dataset.field}
denominator_label
Label du dénominateur à utiliser dans la légende.
-
Version : >=2.26
-
Valeurs possibles : String ou {dataset.field})
is_denominator_printed
Permet d’afficher la valeur et le label du dénominateur.
-
Version : >=2.26
-
Valeurs possibles : Boolean ou {dataset.field}
legend
Positionnement de la légende. Si l’option n’est pas renseignée, la légende n’est pas affichée.
-
Version : >=2.26
-
Valeurs possibles : ‘top’, ‘bottom’, ‘right’ ou ‘left’ ou {dataset.field}
refresh_btn
Permet d’afficher un bouton pour rafraîchir les datasets.
-
Version : >=2.26
-
Valeurs possibles : Boolean ou {dataset.field}
title_color
Couleur de police du titre.
-
Version : >=2.26
-
Valeurs possibles : Nom de couleur (RGB, Hexa, etc + couleurs bootstrap) ou {dataset.field}
-
Valeur par défaut : black
type
Type de graphique.
-
Version : >=2.26
-
Valeurs possibles : String (‘doughnut’ ou ‘bar’) ou {dataset.field}
-
Valeur par défaut : doughnut