Sjabloon:Datastaven

Geen data om weer te geven.

Sjabloondocumentatie​

Met dit sjabloon kan een staafgrafiek gemaakt worden. Gebruik voor grafieken bij voorkeur sjabloon {{Graph:Chart}} vanwege de uitgebreidere ondersteuning en betere prestaties.

Gebruik

Data toevoegen gaat door middel van {{Item}}'s. Elk Item representeert een staaf in de te vormen grafiek. Een Item ziet er in vereenvoudigde vorm als volgt uit:
{{Item | x= | y= }}
Alle parameters zijn optioneel. Voor een leeg Item wordt een lege ruimte getoond. Een simpel voorbeeld:

{{Datastaven
| {{Item|x=Milan|y=20}}
| {{Item|x=Maria|y=60}}
| {{Item|x=Max  |y=40}}
| {{Item|x=Maud |y=30}}
}}

• Milan 20
• Maria 60
• Max 40
• Maud 30

Groepen

Voor Items kan een groepnaam worden ingevuld. Items met eenzelfde groepnaam vormen één groep met een gemeenschappelijk kleur en legenda-item. Een kleur kan per staaf overschreven worden door een aparte kleur op dat Item in te stellen:

{{Datastaven
| {{Item|x=jan  |y=200|groep=Q1}}
| {{Item|x=feb  |y=120|groep=Q1|kleur=green}}
| {{Item|x=maart|y=110|groep=Q1}}
| {{Item|x=april|y= 60|groep=Q1}}
| {{Item|x=mei  |y=140|groep=Q2}}
| {{Item|x=juni |y=130|groep=Q2}}
| {{Item|x=juli |y=160|groep=Q2}}
| {{Item|x=aug  |y=140|groep=Q2}}
}}

• jan 200
  Q1
• feb 120
  Q1
• maart 110
  Q1
• april 60
  Q1
• mei 140
  Q2
• juni 130
  Q2
• juli 160
  Q2
• aug 140
  Q2

• Q1
• Q2

Definities

Groepen kunnen ook eigenhandig gedefinieerd worden met de groepn-parameters. Op deze manier kunnen alternatieve labels en/of kleuren worden ingesteld voor een groep. Voor groepen worden eveneens Items gebruikt, met dezelfde parameters:

{{Datastaven
| groep1 = {{Item|groep=A|label=Groep A|kleur=#606c38}}
| groep2 = {{Item|groep=B|label=Groep B|kleur=#fca311}}
| groep3 = {{Item|groep=C|label=Groep C|kleur=#bc4848}}

| {{Item|x=jan  |y=180|groep=A}}
| {{Item|x=feb  |y=140|groep=B}}
| {{Item|x=maart|y=130|groep=B}}
| {{Item|x=april|y= 80|groep=A}}
| {{Item|x=mei  |y=140|groep=C}}
| {{Item|x=juni |y=120|groep=B}}
}}

• jan 180
  Groep A
• feb 140
  Groep B
• maart 130
  Groep B
• april 80
  Groep A
• mei 140
  Groep C
• juni 120
  Groep B

• Groep A
• Groep C
• Groep B

Voor meerdere pagina's

Voor gebruik van dezelfde groepen over meerdere artikelen kan het handig zijn daarvoor een aparte pagina met groepen aan te maken. Zie voor uitleg daarover Module:Datastaven/Groepen. Door de naam van de pagina aan het sjabloon mee te geven kunnen de groepen van die pagina gebruikt worden:

{{Datastaven
| groepen = Naam van pagina met groepen

| {{Item|x=..|y=..|groep=code}}
| ...
}}

Eindstanden

Voor eindstanden van bijvoorbeeld een sportclub over meerdere jaren kan |type=eindstanden worden toegevoegd. Dit zorgt voor een aantal voorinstellingen, zoals het omkeren van y (laagste nummers boven) en smallere staven:

{{Datastaven
| type = eindstanden
| groep1 = {{Item|groep=ediv|label=Ene divisie|kleur=#ff595e}}
| groep2 = {{Item|groep=adiv|label=Andere divisie|kleur=#ffca3a}}
| groep3 = {{Item|groep=okls|label=Overgangsklasse|kleur=#8ac926}}

| {{Seizoen|1981|21|ediv|afd=A}}
| {{Seizoen|1982|13|adiv|afd=B}}
| {{Seizoen|1983|15|okls}}
| ...
}}

• 1981 21e
  Ene divisie A
• 1982 13e
  Andere divisie B
• 1983 15e
  Overgangsklasse
• 1984 18e
  Overgangsklasse
• 1985 12e
  Andere divisie B
• 1986 5e
  Ene divisie A
• 1987 6e
  Andere divisie A
• 1988 6e
  Andere divisie A
• 1989 4e
  Overgangsklasse
• 1990 9e
  Overgangsklasse
• 1991 10e
  Overgangsklasse
• 1992 14e
  Overgangsklasse
• 1993 1e
  Ene divisie B
• 1994 7e
  Ene divisie B

• Overgangsklasse
• Ene divisie
• Andere divisie

Merk op dat in plaats van Items ook {{Seizoen}}en kunnen worden gebruikt. Deze werken precies hetzelfde, alleen geven iets meer betekenis aan de data. Merk verder op dat voor |x=, |y= en |groep= ook |1=, |2= en |3= gebruikt kunnen worden.

Parameteroverzicht

|grafiekhoogte= (getal)

Hoogte van de grafiek in px.

|staafbreedte= (getal)

Breedte van een staaf in em. De breedte van de gehele grafiek past zich hier op aan.

|1=, |2=, |3=, ... (Item)

{{Item}}'s die de staven van de grafiek voorstellen. Een Item kan de volgende parameters hebben:

|x= (wikitekst)

Waarde van x. Wordt getoond op de x-as.

|y= (getal)

Waarde van y. Wordt getoond boven de staaf.

|yLabel= (tekst)

Alternatieve waarde voor y.

|yOpm= (wikitekst)

Opmerking bij y, zichtbaar in de tooltip.

|groep= (wikitekst)

Naam van een groep of een groepscode die verwijst naar een voorgedefinieerde groep.

|subgroep= / |afd= (wikitekst)

Naam van een subgroep of afdeling.

|groep1=, |groep2=, ... |groepn= (Item)

{{Item}}'s die groepen definiëren. Een Item heeft ten minste de volgende parameters:

|groep= (tekst)

Een korte code voor de groep.

|label= (wikitekst)

Naam van de groep. Wordt o.a. in de legenda getoond.

|xAfkappen= (boolean)

Toon alleen de laatste twee tekens van x op de x-as. Dit is eigenlijk alleen handig bij jaartallen en een smalle staafbreedte.

|yOmkeren= (boolean)

Y-as omkeren. Hoge nummers komen onderaan, lage nummers bovenaan.

|aangepasteLegenda= (tekst)

Lijst van groepen, kommagescheiden. Alleen de opgegeven groepen worden in de legenda getoond, in de opgegeven volgorde.

Voor staven én groepen

De volgende parameters zijn zowel instelbaar op een staaf als op een groep:

|kleur= (CSS-kleur)

De kleur van de staven. Bijvoorbeeld: indianred of #00FFFF of rgb(255, 255, 0).

|yMax= (getal)

Maximale hoogte van y of als |yOmkeren=ja is ingesteld dan de maximale laagte. Bij rangschikkingen of posities betekent dat dan meestal het totaal aantal deelnemers.

|ySuffix= (tekst)

Een achtervoegsel voor y, bijvoorbeeld een eenheid of e voor posities (1e, 2e, 3e etc.).

|niveau= (getal)

Het niveau. Niveaus worden gestapeld. 1 is het hoogste niveau.

Zie ook

• {{Graph:Chart}}