imported>深鸣来自 2025年1月4日 (六) 06:19

2025-01-04T06:19:25Z

新页面

{{Documentation subpage}}


== Usage ==

This is a template for displaying a bar chart.

{| cellpadding="0" cellspacing="0"
|- style="vertical-align:top;"
|
{|
| Simple example in the default style:<syntaxhighlight lang="wikitext">
{{Data bars
| columns = 6 | Jan| Feb| Mar| Apr| May| Jun
| blue|Berries| 65| 38| 72| 47| 20| 30
}}
</syntaxhighlight>
|}
|
{{Data bars
| columns = 6 | Jan| Feb| Mar| Apr| May| Jun
| blue|Berries| 65| 38| 72| 47| 20| 30
}}
|- style="vertical-align:top;"
|
{|
| Same thing, but horizontal ('''style=2'''):<syntaxhighlight lang="wikitext">
{{Data bars
| style = 2
| columns = 6 | Jan| Feb| Mar| Apr| May| Jun
| blue|Berries| 65| 38| 72| 47| 20| 30
}}
</syntaxhighlight>
|}
|
{{Data bars
| style = 2
| columns = 6 | Jan| Feb| Mar| Apr| May| Jun
| blue|Berries| 65| 38| 72| 47| 20| 30
}}
|}

{| cellspacing="0" cellpadding="o"
|- style="vertical-align:bottom;"
| Given multiple data rows that look like this:
|-
| style="text-align:right;padding-right:48px;" | <big>'''↔'''</big> '''Max. data columns:''' 16 <big>'''↔'''</big>
|-
|
<syntaxhighlight lang="wikitext">
{{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
}}
</syntaxhighlight>
| style="vertical-align:middle;padding-left:16px;" | <big>'''↕'''</big> '''Max. data rows:''' 8 <big>'''↕'''</big>
|-
| colspan="2" |
: ...the template displays a complex, color-keyed chart that looks like this:
{| style="float:right;"
|
{{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
}}
|}
|}


== 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.

{|
|- style="vertical-align:top;"
|
{|
| {{center|1='''title = Small numbers, large scale'''}}{{center|1='''scale = 10'''}}{{center|1='''source = Data invented for this example.'''}}
<syntaxhighlight lang="wikitext">
{{Data bars
| title = Small numbers, large scale
| scale = 10
| source = Data invented for this example.
| columns = 6 |Jan|Feb|Mar|Apr|May|Jun
| red|Cherries| 6| 7| 9| 3| 5| 3
| blue| Berries| 9| 8| 11| 6| 7| 8
|purple| Grapes| 5| 4| 6| 11| 9| 6
}}
</syntaxhighlight>
|-
| style="text-align:center;" |
{{Data bars
| title = Small numbers, large scale
| scale = 10
| source = Data invented for this example.
| columns = 6 |Jan|Feb|Mar|Apr|May|Jun
| red|Cherries| 6| 7| 9| 3| 5| 3
| blue| Berries| 9| 8| 11| 6| 7| 8
|purple| Grapes| 5| 4| 6| 11| 9| 6
}}
|}
| style="padding-left:38px;" |
{|
| {{center|1='''title = Large numbers, small scale'''}}{{center|1='''scale = 0.1        style = 2'''}}{{center|1='''source = Data invented for this example.'''}}
<syntaxhighlight lang="wikitext">
{{Data bars
| title = Large numbers, small scale
| scale = 0.1 | style = 2
| source = Data invented for this example.
| columns = 6 | Jul| Aug| Sep| Oct| Nov| Dec
| green| Apples| 600| 700| 900| 300| 500| 300
|yellow| Bananas| 900| 800|1100| 600| 700| 800
|orange| Oranges| 500| 400| 600|1100| 900| 600
}}
</syntaxhighlight>
|-
|
{{Data bars
| title = Large numbers, small scale
| scale = 0.1 | style = 2
| source = Data invented for this example.
| columns = 6 | Jul| Aug| Sep| Oct| Nov| Dec
| green| Apples| 600| 700| 900| 300| 500| 300
|yellow| Bananas| 900| 800|1100| 600| 700| 800
|orange| Oranges| 500| 400| 600|1100| 900| 600
}}
|}
|}

Also, to center or to float a chart left or right, specify ''center'', ''right'' or ''left'' in parameter '''align''' (aka '''float'''). For example:

{{Data bars
| align = right
| columns = 6 | Jan| Feb| Mar| Apr| May| Jun
| blue|Berries| 65| 38| 72| 47| 20| 30
}}
{|
| <syntaxhighlight lang="wikitext">
{{Data bars
| align = right
| columns = 6 | Jan| Feb| Mar| Apr| May| Jun
| blue|Berries| 65| 38| 72| 47| 20| 30
}}
</syntaxhighlight>
|}

== 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 <kbd>'''style=8'''</kbd>:
{| cellspacing="0" cellpadding="0"
| style="text-align:center;" | Horizontal, with borders, shading and visible detail.
|-
|
{| align="center" cellspacing="0" cellpadding="0"
|
{| align="center"
|- style="vertical-align:bottom;"
|<syntaxhighlight lang="wikitext">
{{Data bars
| style = 8
| scale = 0.1
| title = Fruit Amounts (lbs)
| source = Data invented for this example.
| columns = 6 |2009|2010|2011|2012|2013|2014
| green| Apples| | 700| 900| 300| 500| 300
|yellow| Bananas| 900| |1100| 600| 700| 800
|orange| Oranges| 500| 400| |1100| 900| 600
| red|Cherries| 700| 300| 600| | 900| 600
| blue| Berries| 300| 500| 600| 900| 700|
}}
</syntaxhighlight>

|}
|}
|-
|
{{Data bars
| style = 8
| scale = 0.1
| title = Fruit Amounts (lbs)
| source = Data invented for this example.
| columns = 6 |2009|2010|2011|2012|2013|2014
| green| Apples| | 700| 900| 300| 500| 300
|yellow| Bananas| 900| |1100| 600| 700| 800
|orange| Oranges| 500| 400| |1100| 900| 600
| red|Cherries| 700| 300| 600| | 900| 600
| blue| Berries| 300| 500| 600| 900| 700|
}}
|-
| 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;" |
{{Data bars
| style = 13
| scale = 0.1
| title = Fruit Amounts (lbs)
| source = Data invented for this example.
| columns = 6 |2009|2010|2011|2012|2013|2014
| green| Apples| | 700| 900| 300| 500| 300
|yellow| Bananas| 900| |1100| 600| 700| 800
|orange| Oranges| 500| 400| |1100| 900| 600
| red|Cherries| 700| 300| 600| | 900| 600
| blue| Berries| 300| 500| 600| 900| 700|
}}
|}

== Method ==

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.
: <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>{{Sandbox other||

[[Category:條形圖模板]]
}}</includeonly>

Template:Data bars/doc - 版本历史

imported>深鸣 来自 2025年1月4日 (六) 06:19

imported>深鸣来自 2025年1月4日 (六) 06:19