Présentation
Ce plugin permet d’insérer des graphes dans SPIP. Il inclut 6 types (courbe, barre, camembert, radar, doughtnut) ainsi qu’une solution pour les vieilles versions d’Internet Explorer.
Ce plugin utilise la bibliothèque javascript http://www.chartjs.org/ crée par Nick Downie.
Basé sur HTML5
Chart.js utilise le javascript et repose sur le tag HTML5 canvas. Il est compatible avec tous les navigateurs modernes et offre un support polyfills pour IE7/8.
Il est aussi responsive par défaut.
Simple et flexible
Chart.js ne dépend pas d’une autre librairie et il est assez léger une fois compressé.
Installation
Le plugin est répertorié dans le dépôt proposé par défaut : « SPIP-Zone - Plugins ». Aussi, il est installable depuis la page Gestion des plugins, onglet Ajouter des plugins si vous avez activé ce dépôt. Pour le retrouver dans la liste des plugins, il vous suffit de rechercher "chartjs".
En cas de besoin, référez-vous à l’article dédié à ce sujet sur spip.net.
Une fois installé, vous pouvez consulter la page de démonstration spip.php?page=demo/demo_chartjs
Utiliser le modèle <chart>
Le plugin introduit un nouveau modèle pour insérer les graphes dans vos articles.
<chart|param1=...|param2=...>
Exemple : Modèle pour un camembert
<chart
|id=camembert1
|canvaswidth=250
|canvasheight=250
|type=pie
|labels=Tôkyô,Kyoto,Osaka,Chiba,Hiroshima
|data=10,32,50,25,5>
Attention la syntaxe est précise, il faut être vigilant lors de la saisie des données.
- Chaque graphe doit comporter les attributs obligatoires id (unique), type
et data ou datasets - Pour les types Pie, Doughnut et PolarArea s’utilisent avec l’attribut data (tableau à 1 dimension)
- Pour les types Bar, Line et Radar s’utilisent avec l’attribut datasets (tableau à plusieurs dimensions). On utilise le mot réservé next pour séparer un jeu de données.
- Les chiffres à virgules sont à indiquer en notation anglaise (avec un point) :
3.14 et non 3,14
Syntaxe complète du modèle <chart>
Le nom des paramètres et leurs valeurs sont en anglais.
Paramètres obligatoires
Paramètres | Exemple | Explications |
---|---|---|
type | pie | Type de graphique, choisir entre pie doughnut radar polararea bar line |
id | camembert23 | identifiant du graphique, il doit être unique et ne pas comporter de caractères spéciaux |
data | 30,50,100 | Données pour les graphes du type pie, doughnut et polarArea |
datasets | 30,50,100 next 20,90,75 | Données pour les graphes du type bar, line et radar Pour séparer un ensemble de données, on utilise le mot séparateur next |
Paramètres facultatifs
Paramètres | Exemple | Explications |
---|---|---|
labels | Jan,Fev,Mars | Légende |
canvaswidth | 500 | Largeur du graphe. Exprimé en px |
canvasheight | 500 | Hauteur du graphe. Exprimé en px |
width | 45% | Largeur du conteneur du graphe. Valeurs possibles auto ou une valeur en unités em, px, % |
height | auto | Hauteur du conteneur du graphe. Valeurs possibles auto ou une valeur en unités em, px, % |
align | right | Alignement du graphe : left center right |
class | no-print | Ajouter une classe supplémentaire au conteneur du graphe |
colors | #E0E4CC,#F38630 | Jeu de couleurs personnalisé |
fillopacity | 0.7 | Opacité du remplissage pour les graphes de type line, bar et polararea |
pointstrokecolor | #FFFFFF | Couleur du point les graphes de type line et polararea |
animation | true | Activer ou non l’animation du graphe |
scaleFontSize | 12 | Taille de police en px |
scaleFontColor | #666 | Change l’échelle de couleur de police |
scaleOverride | false | Si true, le script tente d’appliquer l’échelle. Requiert les paramètres suivants |
scaleSteps | null | requiert scaleOverride=true, Nombre de pas de l’échelle |
scaleStepWidth | null | requiert scaleOverride=true, Valeur du pas de l’échelle |
scaleStartValue | null | requiert scaleOverride=true, Valeur de départ de l’échelle |
scaleLabelUnit | € | Uniquement pour les graphes de type line et bars, pour afficher l’unité à la suite de chaque label |
Usage avancé : utilisation dans des boucles SPIP
Il est aussi possible d’utiliser le plugin dans vos boucles SPIP pour créer des graphes avec des données dynamiques.
Dans ce cas on utilisera la balise #MODELE{chart}
avec les paramètres requis.
Exemple : afficher le cours du yen des 30 derniers jours.
#SET{data,''}
#SET{labels,''}
<BOUCLE_cours(DATA){source simplexml,http://www.ecb.europa.eu/stats/eurofxref/eurofxref-hist-90d.xml?#ENV{date}}{datapath root/children/cube/0/children/cube}{0,30}>
#SET{labels, #GET{labels}|concat{",",#VALEUR{attributes/time}|affdate{d/m/y}}}
<BOUCLE_yen(DATA){source tableau,#VALEUR{children/cube}}>[
(#VALEUR{attributes/currency}|=={JPY}|oui)
#SET{data,#GET{data}|concat{",",#VALEUR{attributes/rate}}
]</BOUCLE_yen>
</BOUCLE_cours>
#SET{data,#GET{data}|substr{1}}
#SET{labels,#GET{labels}|substr{1}}
[(#MODELE{chart}{id=coursduyen,type=line,width=auto,height=auto,canvaswidth=850,canvasheight=350,datasets=#GET{data},labels=#GET{labels}})]
Affichera
Aucune discussion
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |