Difference between revisions of "Template:Data bars/doc"
Jump to navigation
Jump to search
imported>WOSlinker (tidy style for better HTML5 compatibility) |
imported>Vanisaac |
||
| (3 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{Documentation subpage}} | {{Documentation subpage}} | ||
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) --> | <!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) --> | ||
| + | |||
== Usage == | == Usage == | ||
| Line 170: | Line 171: | ||
: '''Styles 9 thru 16''' are the same as 1 thru 8, but '''averages''' are displayed with the color key, instead of totals. | : '''Styles 9 thru 16''' are the same as 1 thru 8, but '''averages''' are displayed with the color key, instead of totals. | ||
| − | For example, here's one using < | + | For example, here's one using <kbd>'''style=8'''</kbd>: |
{| cellspacing="0" cellpadding="0" | {| cellspacing="0" cellpadding="0" | ||
| style="text-align:center;" | Horizontal, with borders, shading and visible detail. | | style="text-align:center;" | Horizontal, with borders, shading and visible detail. | ||
| Line 179: | Line 180: | ||
{| align="center" | {| align="center" | ||
|- style="vertical-align:bottom;" | |- style="vertical-align:bottom;" | ||
| − | <pre> | + | |<pre> |
{{Data bars | {{Data bars | ||
| style = 8 | | style = 8 | ||
| Line 193: | Line 194: | ||
}} | }} | ||
</pre> | </pre> | ||
| + | |||
|} | |} | ||
|} | |} | ||
| Line 210: | Line 212: | ||
}} | }} | ||
|- | |- | ||
| − | | style="padding-top:32px;" | And here's the | + | | style="padding-top:32px;" | And here's exactly the same data in '''style=13''', showing '''averages''' on the right instead of totals: |
|- | |- | ||
| style="text-align:center;" | | | style="text-align:center;" | | ||
| Line 230: | Line 232: | ||
This template employs five "sub-templates." A table is created using the columns and rows of data. | This template employs five "sub-templates." A table is created using the columns and rows of data. | ||
| − | : < | + | : <kbd><nowiki>{{</nowiki>[[Template:Data bars/bar|Data bars/bar]]<nowiki>}}</nowiki></kbd> draws each vertical or horizontal rectangle optionally colored and labeled with a name and/or a value. |
| − | : < | + | : <kbd><nowiki>{{</nowiki>[[Template:Data bars/column|Data bars/column]]<nowiki>}}</nowiki></kbd> handles one column of data. |
If style is > 8, the data is passed along to other sub-templates to display averages instead of totals with the color key. | If style is > 8, the data is passed along to other sub-templates to display averages instead of totals with the color key. | ||
| − | : < | + | : <kbd><nowiki>{{</nowiki>[[Template:Data bars/averages|Data bars/averages]]<nowiki>}}</nowiki></kbd> calculates the averages of all the rows of data. |
| − | : < | + | : <kbd><nowiki>{{</nowiki>[[Template:Data bars/averages/display|Data bars/averages/display]]<nowiki>}}</nowiki></kbd> assigns the averages to named parameters for display as a single complex bar. |
| − | : < | + | : <kbd><nowiki>{{</nowiki>[[Template:Data bars/averages/column|Data bars/averages/column]]<nowiki>}}</nowiki></kbd> draws a vertical labeled bar of averages serving as a color key. |
| − | <includeonly>{{ | + | <includeonly>{{Sandbox other|| |
<!-- Categories below this line, please; interwikis at Wikidata --> | <!-- Categories below this line, please; interwikis at Wikidata --> | ||
[[Category:Bar chart templates]] | [[Category:Bar chart templates]] | ||
}}</includeonly> | }}</includeonly> | ||
Latest revision as of 22:48, 24 April 2020
| 40px | This is a documentation subpage for Template:Data bars. It contains usage information, categories and other content that is not part of the original template page. |
Contents
Usage
This is a template for displaying a bar chart.
|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
| Given multiple data rows that look like this: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ↔ Max. data columns: 16 ↔ | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{{Data bars
| columns = 12 |Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec
| green| Apples| 60| 70| 90| 30| 50| 30|100|130|120| 90| 50|110
|yellow| Bananas| 90| 80|110| 60| 70| 80| 70| 70| 40| 50| 50| 60
|orange| Oranges| 50| 40| 60|110| 90| 60| 30| 60| 70| 60| 80| 40
}}
|
↕ Max. data rows: 8 ↕ | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Title, Scale, Source and Alignment
Optional named parameters include title, scale and source.
- A title appears bolded and centered above the chart.
- A scale is needed for handling very small or large numbers.
- A source tells the viewer where the data came from.
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Also, to center or to float a chart left or right, specify center, right or left in parameter align (aka float). For example:
| Berries | ||||||||||||||||||||||||||||||||||||||||||||||||||
|
Total: 272 |
{{Data bars
| align = right
| columns = 6 | Jan| Feb| Mar| Apr| May| Jun
| blue|Berries| 65| 38| 72| 47| 20| 30
}}
|
Orientation, Borders, Details and Averages
There are sixteen styles to choose from.
- Odd numbered styles are vertical.
- Even numbered styles are horizontal.
- Styles 3 and 4 have borders and shading.
- Styles 5 thru 8 are the same as 1 thru 4, but show additional detail.
- Styles 9 thru 16 are the same as 1 thru 8, but averages are displayed with the color key, instead of totals.
For example, here's one using style=8:
| Horizontal, with borders, shading and visible detail. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| And here's exactly the same data in style=13, showing averages on the right instead of totals: | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Method
This template employs five "sub-templates." A table is created using the columns and rows of data.
- {{Data bars/bar}} draws each vertical or horizontal rectangle optionally colored and labeled with a name and/or a value.
- {{Data bars/column}} handles one column of data.
If style is > 8, the data is passed along to other sub-templates to display averages instead of totals with the color key.
- {{Data bars/averages}} calculates the averages of all the rows of data.
- {{Data bars/averages/display}} assigns the averages to named parameters for display as a single complex bar.
- {{Data bars/averages/column}} draws a vertical labeled bar of averages serving as a color key.