Modèle:Bar chart/Documentation
Ceci est la page de documentation de Modèle:Bar chart [modifier] [purger].
Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.
Utilisation
modifierCe modèle affiche un tableau de barres horizontales. Chaque ligne associe un libellé à une barre générée par le modèle {{Bar chart/bar}}.
Syntaxe avec une colonne de données :
{{Bar chart |title= |label_type= |data_type= |data_max= |bar_width= |width_units= |table_width= |float= |table_style= |class= |label1= |data1= |comment1= |label2= |data2= |comment2= … |total= |caption= }}
Les colonnes supplémentaires (2 à 9) reprennent les paramètres de la première colonne avec le préfixe colk_ :
|col2_data_type= |col2_data_max= |col2_data1= |col2_comment1= |col2_data2= … |col2_total=
Paramètres
modifierLes paramètres de ligne sont numérotés de 1 à 25. La description ci-dessous ne détaille que la première ligne et les deux premières colonnes.
Tableau de barres horizontales : jusqu’à 25 lignes et 9 colonnes de données, avec une ligne de total et une note de bas de tableau facultatives.
| Paramètre | Description | Type | État | |
|---|---|---|---|---|
| Titre | title | Titre du tableau, affiché en gras au-dessus.
| Chaîne | facultatif |
| En-tête des libellés | label_type | En-tête de la première colonne, qui contient les libellés des lignes.
| Chaîne | facultatif |
| En-tête de la colonne 1 | data_type col1_data_type | En-tête de la première colonne de données.
| Chaîne | facultatif |
| En-tête de la colonne 2 | col2_data_type | En-tête de la deuxième colonne de données (idem de col3_data_type à col9_data_type). Sans ce paramètre, la colonne n’a pas d’en-tête. | Chaîne | facultatif |
| Largeur des colonnes de données | bar_width | Largeur des colonnes de données et des barres, dans l’unité définie par width_units.
| Nombre | facultatif |
| Unité des largeurs | width_units | Unité CSS utilisée pour table_width et bar_width.
| Chaîne | facultatif |
| Largeur du tableau | table_width | Largeur du tableau, sous forme d’un nombre seul ; l’unité est définie par width_units. Par défaut, aucune largeur n’est imposée. | Nombre | facultatif |
| Habillage | float | Position du tableau par rapport au texte : left, right ou center. Toute autre valeur est ignorée.
| Chaîne | facultatif |
| Style du tableau | table_style | Style CSS supplémentaire, ajouté à la fin de l’attribut style du tableau. | Chaîne | facultatif |
| Classe CSS | class | Classes CSS ajoutées à la classe BarChartTemplate du tableau. | Chaîne | facultatif |
| Libellé de la ligne 1 | label1 | Libellé de la première ligne (idem pour label2 à label25). | Chaîne | obligatoire |
| Valeur de la ligne 1, colonne 1 | data1 col1_data1 | Valeur de la première ligne dans la première colonne de données. Une ligne n’est générée que si ce paramètre est renseigné. | Nombre | obligatoire |
| Commentaire de la ligne 1, colonne 1 | comment1 col1_comment1 | Commentaire associé à la valeur. | Chaîne | facultatif |
| Valeur maximale de la colonne 1 | data_max col1_data_max | Valeur maximale de l’échelle de la première colonne. Par défaut, la valeur de la première ligne. | Nombre | facultatif |
| Valeur de la ligne 1, colonne 2 | col2_data1 | Valeur de la première ligne dans la deuxième colonne de données et pour les colonnes 3 à 9). Une cellule n’est générée que si ce paramètre est renseigné. | Nombre | facultatif |
| Commentaire de la ligne 1, colonne 2 | col2_comment1 | Commentaire associé à la valeur de la deuxième colonne, transmis au paramètre comment de Bar chart/bar. | Chaîne | facultatif |
| Valeur maximale de la colonne 2 | col2_data_max | Valeur maximale de l’échelle de la deuxième colonne. Par défaut, la valeur de la première ligne de la colonne. | Nombre | facultatif |
| Total de la colonne 1 | total col1_total | Total de la première colonne. Ce paramètre affiche une ligne de total, dont l’en-tête est « Total ». Le nombre est saisi sans mise en forme. | Nombre | facultatif |
| Total de la colonne 2 | col2_total | Total de la deuxième colonne (idem de col3_total à col9_total). À utiliser avec total, sans quoi la ligne n’a pas d’en-tête et ses cellules sont décalées. | Nombre | facultatif |
| Note de bas de tableau | caption | Texte affiché sous le tableau. | Chaîne | facultatif |
Une ligne n’est générée que si la valeur de sa première colonne (datan) est renseignée. Dans les colonnes suivantes, une cellule n’est générée que si le paramètre correspondant est renseigné : une valeur omise au milieu d’une ligne décale vers la gauche les cellules qui la suivent.
La ligne de total ne comporte pas de barres : les valeurs sont affichées avec formatnum.
Les couleurs des barres sont définies par {{Bar chart/bar}}.
Exemple
modifierExemple minimal, avec le titre et les en-têtes par défaut :
| Année | Population | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| 1891 | 1 083 770 | ||||||||
| 1901 | 1 647 396 | ||||||||
| 1911 | 2 162 288 | ||||||||
| 1921 | 2 413 978 | ||||||||
| 1931 | 3 217 219 | ||||||||
| 1939 | 4 250 788 | ||||||||
| 1951 | 4 517 588 | ||||||||
| 1961 | 4 499 737 | ||||||||
| 1971 | 4 420 585 | ||||||||
| 1981 | 4 254 900 | ||||||||
| 1991 | 4 230 000 | ||||||||
| 2001 | 4 463 100 | ||||||||
| 2011 | 4 942 040 | ||||||||
| Total | 46 384 399 | ||||||||
|
Note et total sont facultatifs. | |||||||||