Module:Diagramme/Documentation
Ceci est la page de documentation pour Module:Diagramme
Ce module exporte deux fonctions :
histogramme: un diagramme en colonnes (bar chart)camembert: un diagramme en secteurs, circulaire (pie chart)
Histogramme
[modifier le wikicode]Le module est appelé par le code {{#invoke:Diagramme | histogramme |…|…|…}}
Paramètres
[modifier le wikicode]| Paramètre | Résultat |
|---|---|
| séparateur | Délimite plusieurs valeurs lorsqu'il est spécifié en utilisant par défaut le symbole à deux points (:). En principe vous n'avez pas à toucher à ce paramètre |
| largeur | Si ce paramètre est renseigné, la valeur indiquée doit être au minimum de 200. (La valeur par défaut est de 500.) |
| hauteur | Si ce paramètre est renseigné, la valeur minimale est de 200. (La valeur par défaut est de 350.) |
| groupe n | « n » étant un nombre, écrivez groupe 1, groupe 2, etc. en fonction de groupes de colonnes présents dans le graphique ; les valeurs devant être renseignées, voir l'exemple illustré. |
| infobulle n | Info-bulle associée à une colonne spécifique. Si aucune info-bulle n'est définie spécifiquement pour une colonne, et que cette dernière a un lien, alors ce lien sera utilisée comme info-bulle. Sinon, l'info-bulle sera combiné à partir du nom du groupe et la valeur, éventuellement avec "unités préfixe" et "unités suffixe" .. |
| liens n | Les liens vers les articles associés à chaque colonne. |
| empilement | Empilement au sein d'une même colonne. Le seul fait de mentionner ce paramètre signifie « oui » (même en laissant la valeur en blanc). Pour dire « non », il suffit de l'omettre. |
| valeur cumulée | Fonctionne uniquement avec le paramètre empilement, destinée à faire afficher dans l'info-bulle la valeur cumulée de tous les blocs (non testé).
|
| couleurs | Couleurs désignant les différents groupes ; il devrait y avoir en avoir autant que le nombre de groupes. Utilisez les noms de couleurs html ou les notations #xxx ou #xxxxxx. |
| légendes | Les légendes pour chaque groupe de colonne ; la syntaxe wiki peut être employée pour insérer un lien interne. |
| légendes cachées | Les légendes du groupe ne seront pas affichés en dessous du tableau. Toute valeur signifie « oui ». Pour dire « non », il suffit de ne pas spécifier ce paramètre, ou laisser la valeur à blanc. |
| échelle par groupe | Configure une échelle Y distincte pour chaque groupe. Incompatible avec empilement. Même si certaines de ces échelles sont identiques, elles seront tirées au sort séparément lorsque ce paramètre est activé. Toute valeur non-vide signifie « oui ». Pour dire « non », il suffit de ne spécifiez pas ce paramètre, ou laisser la valeur à blanc.
|
| préfixe | Préfixe qui apparaîtrait dans l'info-bulle. Par exemple, si vous ajoutiez le symbole $, si les valeurs s'afficheraient sous la forme « $500 » au lieu de « 500 » dans l'info-bulle |
| unité | Suffixe qui apparaîtrait dans l'info-bulle. Si vous utilisez € l'info-bulle affichera par exemple 88€ au lieu de 88. Utiliser _€ affichera 88 € (le tiret bas est remplacé par un espace dans l'info-bulle).
|
| noms | Les légendes affectées aux différents groupes de colonnes. |
Modules externes et autres éléments dont ce module a besoin pour fonctionner :
Table des couleurs
[modifier le wikicode]Table des couleurs
Page d’aide principale : Aide:Couleurs
|
Exemple basique
[modifier le wikicode]{{ #invoke:Diagramme | histogramme
| groupe 1 = 40 : 50 : 60 : 20
| groupe 2 = 20 : 60 : 12 : 44
| groupe 3 = 55 : 14 : 33 : 5
| liens 1 = Pomme : McIntosh (pomme) : Golden delicious
| liens 2 = Banane : Abricot : Pêche (fruit)
| liens 3 = Orange : Poire : Raisin
| infobulle 2 = infobulle 1 : infobulle 2 : infobulle 3 : infobulle 4
| couleurs = green : yellow : orange
| noms = Pomme: Banane : Orange
| légendes = Avant : Pendant : Après : Post mortem
}}
10
20
30
40
50
60
70
Avant
Pendant
Après
Post mortem
- Pomme
- Banane
- Orange
Exemple avec empilement
[modifier le wikicode]Le même graphique, avec une taille plus petite, utilisant les paramètres hauteur, largeur, empilement, unité.
{{ #invoke:Diagramme | histogramme
| hauteur = 250
| largeur = 300
| empilement = 1
| groupe 1 = 40 : 50 : 60 : 20
| groupe 2 = 20 : 60 : 12 : 44
| groupe 3 = 55 : 14 : 33 : 5
| couleurs = green : yellow : orange
| noms = Pomme : Banane : Orange
| unité = kg
| légendes = Avant : Pendant : Après : Post mortem
}}
25
50
75
100
125
150
Avant
Pendant
Après
Post mortem
- Pomme
- Banane
- Orange
Exemple avec une échelle différente par groupe
[modifier le wikicode]Il est possible d'afficher une échelle et des unités différentes pour chaque groupe :
{{ #invoke:Diagramme | histogramme
| largeur = 800
| groupe 1 = 1500000 : 2500000 : 3500000
| groupe 2 = 200 : 5000 : 45000
| groupe 3 = 2000 : 5000 : 20000
| couleurs = red : blue : green
| noms = Population : Auto : Coût moyen
| légendes = 1920 : 1965 : 2002
| infobulle 2 = : Il n'y a pas de donnée fiable pour le nombre de voiture en 1965. Nous avons pris 5000 comme étant la meilleure estimation.
| unité =::_€
| échelle par groupe = 1
}}
Regardez le paramètre "unit suffix" : nous n'avons pas besoin du préfixe pour les 2 premiers groupes, nous utilisons donc des colonnes sans contenu.
Prenez connaissance aussi de l'info-bulle spéciale pour "Auto"
1 000 000
2 000 000
3 000 000
4 000 000
10 000
20 000
30 000
40 000
50 000
5 000
10 000
15 000
20 000
25 000
30 000
1920
1965
2002
- Population
- Auto
- Coût moyen
Exemple avec un grand nombre de légendes
[modifier le wikicode]{{ #invoke:Diagramme | histogramme
| largeur = 800
| hauteur = 550
| groupe 1 = 1:2:3:4:5:4:3:2:1
| groupe 2 = 1:2:3:4:5:4:3:2:1
| groupe 3 = 1:2:3:4:5:4:3:2:1
| groupe 4 = 1:2:3:4:5:4:3:2:1
| groupe 5 = 1:2:3:4:5:4:3:2:1
| groupe 6 = 1:2:3:4:5:4:3:2:1
| groupe 7 = 1:2:3:4:5:4:3:2:1
| groupe 8 = 1:2:3:4:5:4:3:2:1
| groupe 9 = 1:2:3:4:5:4:3:2:1
| groupe 10 = 1:2:3:4:5:4:3:2:1
| groupe 11 = 1:2:3:4:5:4:3:2:1
| groupe 12 = 1:2:3:4:5:4:3:2:1
| groupe 13 = 1:2:3:4:5:4:3:2:1
| groupe 14 = 1:2:3:4:5:4:3:2:1
| groupe 15 = 1:2:3:4:5:4:3:2:1
| groupe 16 = 1:2:3:4:5:4:3:2:1
| groupe 17 = 1:2:3:4:5:4:3:2:1
| groupe 18 = 1:2:3:4:5:4:3:2:1
| groupe 19 = 1:2:3:4:5:4:3:2:1
| groupe 20 = 1:2:3:4:5:4:3:2:1
| groupe 21 = 1:2:3:4:5:4:3:2:1
| couleurs = Silver:Gray:Black:Red:Maroon:Yellow:Olive:Lime:Green:Aqua:Teal:Blue:Navy:Fuchsia:Purple:ForestGreen:Tomato:LightSeaGreen:RosyBrown:DarkOliveGreen:MediumVioletRed
| noms = Alabama:Alaska:Arizona:Arkansas:California:Colorado:Connecticut:Delaware:Florida:Georgia: Hawaii:Idaho:Illinois:Indiana:Iowa:Kansas:Kentucky:Louisiana:Maine:Maryland:Massachusetts
| légendes = 1920 : 1930 : 1940: 1950 : 1960 : 1970 : 1990 : 2000 : 2010
| préfixe = $
| unité = _Billion
| empilement = 1
}}
Principalement pour tester l'affichage avec un grand nombre de groupes.
25
50
75
100
125
150
1920
1930
1940
1950
1960
1970
1990
2000
2010
- Alabama
- Alaska
- Arizona
- Arkansas
- California
- Colorado
- Connecticut
- Delaware
- Florida
- Georgia
- Hawaii
- Idaho
- Illinois
- Indiana
- Iowa
- Kansas
- Kentucky
- Louisiana
- Maine
- Maryland
- Massachusetts
Exemple divers
[modifier le wikicode]{{ #invoke:Diagramme | histogramme
| groupe 1 = 1:2:3:4:5:6:7:8:9:10:11:12:13:14:15:16:17:18:19:20:21:22:23:24:25:26:27:28:29:30
:31:32:33:34:35:36:37:38:39:40:41:42:43:44:45:46:47:48:49:50:51:52:53:54:55:56:57:58:59
| unité = _Things
| noms = Some
| légendes = ::::1940::::::::::1950::::::::::1960::::::::::1970::::::::::1980::::::::::1990::::
}}
10
20
30
40
50
60
1940
1950
1960
1970
1980
1990
Diagramme circulaire
[modifier le wikicode]Le module est appelé par le code {{#invoke:Diagramme | camembert |…|…|…}}
Paramètres
[modifier le wikicode]| Paramètres | Résultat |
|---|---|
| séparateur | Idem tableau précédent |
| rayon | Le nombre exprimant le nombre de pixels |
| secteurs | Utilisez le paramètre séparateur à l'intérieur des parenthèses (Table Uplet (Tuple)) = ( Value1 : Name1 : Color1 : Link1 ) ( Value2 : Name2 : Color2 : Link2 ) ... Les valeurs sont des nombres qui peuvent être entiers ou des fractions décimales, ou utilisant la notation scientifique : 7.24e6, 7,240,000, ou 7240000.00 sont toutes acceptables pour 7 millions et 240 mille. Les couleurs sont optionnelles. Vous pouvez utiliser les couleurs du web, comme "red" ou "#FF0000". Jusqu'à 26 couleurs sont définies, mais si votre diagramme comporte plus de 26 secteurs, vous devez définir les couleurs à partir du 27e et plus. Les liens peuvent être externes ou internes, y compris des liens ancrés à des sections présentes dans l'article lui-même.
|
| secteur n | Syntaxe alternative à secteurs. n est le numéro de la tranche, en commençant par 1. Veillez à ne pas sauter de numéro : si vous définissez secteur 1, secteur 2, secteur 4, secteur 5 ..., en sautant secteur 3, seuls les deux premières tranches seront affichées. La syntaxe est incompatible avec secteurs, c'est à dire qu'ils ne doivent pas être utilisés en association dans le même appel. Les deux codes secteurs et secteur n dans le même appel entraînerait des résultats imprévisibles. La valeur est comme un « tuple », comme expliqué ci-dessus, mais sans les parenthèses:
| secteur 1 = Value1 : Name1 : Color1 : Link1 | secteur 2 = Value2 : Name2 : Color2 : Link2 | ... L'intérêt de cette syntaxe alternative est de vous permettre d'utiliser des parenthèses dans les noms, des liens et des couleurs. |
| pourcentage | Si utilisé, le pourcentage de chaque tranche sera calculé et ajouté à la légende: si vous avez deux tranches, comme suit: ( 1: younglings ) ( 3 : Elders ), et utilisez pourcentage, les légendes deviendront « younglings: 1 (25%) » et « aînés: 3 (75%) », au lieu de simplement « Younglings: 1 » and « elders: 3 ». Toute valeur non-vide signifie « oui ». Pour dire « non », il suffit de ne pas spécifier ce paramètre à tout, ou laisser la valeur à blanc.
|
| préfixe | Idem tableau précédent |
| unité | Idem tableau précédent |
| légendes cachées | Idem tableau précédent |
Exemple avec paramètre « secteurs »
[modifier le wikicode]{{#invoke:Diagramme|camembert
| rayon = 150
| secteurs =
( 1000000 : Pommes)
( 2000000 : Bananes : gold)
( 1440000 : Abricots )
( 6.4e5 : Pêches : : [[Pêche (fruit)|Pêches]] )
( 750,000 : Ananas)
| unité = _tonnes
| pourcentage = true
}}
Vous pouvez laisser la couleur vide pour utiliser la valeur par défaut, mais pour ajouter le lien « pêche », nous avons du ajouter un séparateur supplémentaire pour marquer le paramètre de couleur omis. Également, les valeurs peuvent être fournies avec le format « langage spécifique » (comme 1,000), ou la notation scientifique comme 6.4e5. Dans les légendes, les numéros seront toujours affichés normalement (peut être différent si le module est importé dans d'autres wikis).
- Pommes: 1 000 000 tonnes (19,7 %)
- Bananes: 2 000 000 tonnes (39,4 %)
- Abricots: 1 440 000 tonnes (28,3 %)
- Pêches: 640 000 tonnes (12,6 %)
- Ananas: 750 tonnes (0 %)
Exemple avec paramètre « secteur n »
[modifier le wikicode]Un exemple avec la syntaxe alternative avec "secteur 1", "secteur 2" etc.
{{#invoke:Diagramme|camembert
|rayon= 200
|unité = _Unités
| secteur 1 = 1 : 1
| secteur 2 = 7 : 7
| secteur 3 = 8 : 8
| secteur 4 = 9 : 9
| secteur 5 = 10 : 10
| secteur 6 = 11 : 11
| secteur 7 = 12 : 12
| secteur 8 = 13 : 13
| secteur 9 = 14 : 14
| secteur 10 = 15 : 15
| secteur 11 = 16 : 16
| secteur 12 = 17 : 17
| secteur 13 = 18 : 18
| secteur 14 = 19 : 19
| secteur 15 = 20 : 20
| secteur 16 = 21 : 21
| secteur 17 = 22 : 22
| secteur 18 = 23 : 23
| secteur 19 = 24 : 24
| secteur 20 = 25 : 25
| secteur 21 = 26 : 26
| secteur 22 = 27 : 27
| secteur 23 = 28 : 28
| secteur 24 = 29 : 29
| secteur 25 = 30 : 30
| secteur 26 = 31 : 31
| pourcentage = true
}}
- 1: 1 Unités (0,2 %)
- 7: 7 Unités (1,5 %)
- 8: 8 Unités (1,7 %)
- 9: 9 Unités (1,9 %)
- 10: 10 Unités (2,1 %)
- 11: 11 Unités (2,3 %)
- 12: 12 Unités (2,5 %)
- 13: 13 Unités (2,7 %)
- 14: 14 Unités (2,9 %)
- 15: 15 Unités (3,2 %)
- 16: 16 Unités (3,4 %)
- 17: 17 Unités (3,6 %)
- 18: 18 Unités (3,8 %)
- 19: 19 Unités (4 %)
- 20: 20 Unités (4,2 %)
- 21: 21 Unités (4,4 %)
- 22: 22 Unités (4,6 %)
- 23: 23 Unités (4,8 %)
- 24: 24 Unités (5 %)
- 25: 25 Unités (5,3 %)
- 26: 26 Unités (5,5 %)
- 27: 27 Unités (5,7 %)
- 28: 28 Unités (5,9 %)
- 29: 29 Unités (6,1 %)
- 30: 30 Unités (6,3 %)
- 31: 31 Unités (6,5 %)