Brontekst bekijken van Sjabloon:Datastaven

{{#invoke:Datastaven|main}}<noinclude>

{{Sjabdoc|1=
{{Gebruikt Lua|Datastaven}}

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

== Gebruik ==
Data toevoegen gaat door middel van {{tl|Item}}'s. Elk Item representeert een staaf in de te vormen grafiek. Een Item ziet er in vereenvoudigde vorm als volgt uit:
<br /><code><nowiki>{{Item | x= | y= }}</nowiki></code><br />
Alle parameters zijn optioneel. Voor een leeg Item wordt een lege ruimte getoond. Een simpel voorbeeld:
{{Kolommen
| Kolom1=
<pre>
{{Datastaven
| {{Item|x=Milan|y=20}}
| {{Item|x=Maria|y=60}}
| {{Item|x=Max  |y=40}}
| {{Item|x=Maud |y=30}}
}}</pre>
| Kolom2=
{{Datastaven
| {{Item|x=Milan|y=20}}
| {{Item|x=Maria|y=60}}
| {{Item|x=Max  |y=40}}
| {{Item|x=Maud |y=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:
{{Kolommen
| Kolom1=
<pre>
{{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}}
}}</pre>
| Kolom2=
{{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}}
}}
}}

=== Definities ===
Groepen kunnen ook eigenhandig gedefinieerd worden met de groep''n''-parameters. Op deze manier kunnen alternatieve labels en/of kleuren worden ingesteld voor een groep. Voor groepen worden eveneens Items gebruikt, met dezelfde parameters:
{{Kolommen
| Kolom1=
<pre>
{{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}}
}}</pre>
| Kolom2=
{{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}}
}}
}}

=== 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:
<pre>
{{Datastaven
| groepen = Naam van pagina met groepen

| {{Item|x=..|y=..|groep=code}}
| ...
}}</pre>

== Eindstanden ==
Voor eindstanden van bijvoorbeeld een sportclub over meerdere jaren kan {{para|type|eindstanden}} worden toegevoegd. Dit zorgt voor een aantal voorinstellingen, zoals het omkeren van y (laagste nummers boven) en smallere staven:
{{Kolommen
| Kolom1=
<pre>
{{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}}
| ...
}}</pre>
| Kolom2=
{{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}}
| {{Seizoen|1984|18|okls}}
| {{Seizoen|1985|12|adiv|afd=B}}
| {{Seizoen|1986| 5|ediv|afd=A}}
| {{Seizoen|1987| 6|adiv|afd=A}}
| {{Seizoen|1988| 6|adiv|afd=A}}
| {{Seizoen|1989| 4|okls}}
| {{Seizoen|1990| 9|okls}}
| {{Seizoen|1991|10|okls}}
| {{Seizoen|1992|14|okls}}
| {{Seizoen|1993| 1|ediv|afd=B}}
| {{Seizoen|1994| 7|ediv|afd=B}}
}}
}}

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

== Parameteroverzicht ==
; {{para|grafiekhoogte}} {{nobold|''(getal)''}}: Hoogte van de grafiek in px.
; {{para|staafbreedte}} {{nobold|''(getal)''}}: Breedte van een staaf in em. De breedte van de gehele grafiek past zich hier op aan.
; {{para|1}}, {{para|2}}, {{para|3}}, ... {{nobold|''(Item)''}}: {{tl|Item}}'s die de staven van de grafiek voorstellen. Een Item kan de volgende parameters hebben:
:; {{para|x}} {{nobold|''(wikitekst)''}}: Waarde van x. Wordt getoond op de x-as.
:; {{para|y}} {{nobold|''(getal)''}}: Waarde van y. Wordt getoond boven de staaf.
:; {{para|yLabel}} {{nobold|''(tekst)''}}: Alternatieve waarde voor y.
:; {{para|yOpm}} {{nobold|''(wikitekst)''}}: Opmerking bij y, zichtbaar in de tooltip.
:; {{para|groep}} {{nobold|''(wikitekst)''}}: Naam van een groep of een groepscode die verwijst naar een voorgedefinieerde groep.
:; {{para|subgroep}} / {{para|afd}} {{nobold|''(wikitekst)''}}: Naam van een subgroep of afdeling.
; {{para|groep1}}, {{para|groep2}}, ... {{para|groep''n''}} {{nobold|''(Item)''}}: {{tl|Item}}'s die groepen definiëren. Een Item heeft ten minste de volgende parameters:
:; {{para|groep}} {{nobold|''(tekst)''}}: Een korte code voor de groep.
:; {{para|label}} {{nobold|''(wikitekst)''}}: Naam van de groep. Wordt o.a. in de legenda getoond.
; {{para|xAfkappen}} {{nobold|''(boolean)''}}: Toon alleen de laatste twee tekens van x op de x-as. Dit is eigenlijk alleen handig bij jaartallen en een smalle staafbreedte.
; {{para|yOmkeren}} {{nobold|''(boolean)''}}: Y-as omkeren. Hoge nummers komen onderaan, lage nummers bovenaan.
; {{para|aangepasteLegenda}} {{nobold|''(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:

; {{para|kleur}} {{nobold|''([[Lijst van HTML-kleuren|CSS-kleur]])''}}: De kleur van de staven. Bijvoorbeeld: <code>indianred</code> of <code>#00FFFF</code> of <code>rgb(255, 255, 0)</code>.
; {{para|yMax}} {{nobold|''(getal)''}}: Maximale hoogte van y of als {{para|yOmkeren|ja}} is ingesteld dan de maximale laagte. Bij rangschikkingen of posities betekent dat dan meestal het totaal aantal deelnemers.
; {{para|ySuffix}} {{nobold|''(tekst)''}}: Een achtervoegsel voor y, bijvoorbeeld een eenheid of ''e'' voor posities (1e, 2e, 3e etc.).
; {{para|niveau}} {{nobold|''(getal)''}}: Het niveau. Niveaus worden gestapeld. 1 is het hoogste niveau.

== Zie ook ==
* {{tl|Graph:Chart}}
}}

[[Categorie:Wikipedia:Sjablonen opmaak]]
</noinclude>