Просмотр

{{Documentation subpage}}
<includeonly><!-----------------Interwiki Doc page pattern------------------->{{-}}
<small>''This '{{BASEPAGENAME}}' template documentation is [[w:Wikipedia:Template doc page pattern|transcluded]] for all Bar box/doc including templates'' [<span class="plainlinks">[{{fullurl:Template:Bar box/doc |action=edit}} edit]</span>].{{#ifeq:{{SITENAME}}|Wikipedia|&nbsp;|[[W:template:{{PAGENAMEE}}|Masterpage]]
&nbsp;}}</small></includeonly><noinclude>
{{-}}
<!-- Add the Categories for this doc or usage page (only-- not for the calling template) BELOW THIS LINE --->

<!-- EDIT the /doc (or THIS usage page only) Interwiki's BELOW THIS LINE -->

<!-- -----------------------------------------------------------
---- Self declarations, this page, not the parent template. 
---- ------------------------------------------------------ --->

</noinclude><includeonly> 
<!-- EDIT IN (calling) TEMPLATE CATEGORIES BELOW THIS LINE -->
[[Category:Bar chart templates|{{PAGENAME}}]]
<!-- EDIT IN (calling) TEMPLATE CATEGORIES ABOVE THIS LINE -->
</includeonly>

<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE --> 
{{tl2|bar box}}, {{tl2|bar percent}} and {{tl2|bar pixel}} are a family of templates for construction of horizontal bar charts.
==Usage==
 <nowiki>{{</nowiki>Bar box
 |width   =  ''width of the graph'' (optional)
 |barwidth=  ''width of the bararea'' (optional, defaults to 100px)
 |float   =  (left|right|none) (optional, defaults to none)
 |title   =  ''title of the chart'' (optional)
 |titlebar=  ''title bar colour'' (optional, defaults to none)
 |left1   =  ''first left column header'' (optional)
 |left2   =  ''second left column header'' (optional)
 |right1  =  ''first right column header'' (optional)
 |right2  =  ''second right column header'' (optional)
 |bars    =  ''chart contents''(see below)
 |caption =  ''caption under the chart''   (optional)}
 <nowiki>}}</nowiki>
===Chart contents===
Bar box can contain any number of bars. There are two types of bars:
*Percentage bar: 
 <nowiki>{{</nowiki>bar percent|row label|colour|value (width in percents)|optional value label<nowiki>}}</nowiki>
If value label is not provided, it is constructed from the percentage and "%".
*Pixel bar: 
 <nowiki>{{</nowiki>bar pixel|row label|colour|value (width in pixels)|value suffix|optional value label<nowiki>}}</nowiki>
If value label is provided, value suffix is ignored. Otherwise, the value label is constructed from the value and the value suffix. This is used as shorthand. Both following examples give identical results:
 <nowiki>{{</nowiki>bar pixel|foo|red|12||12,345<nowiki>}}</nowiki>
 <nowiki>{{</nowiki>bar pixel|foo|red|12|3,45<nowiki>}}</nowiki>

==Examples==
<pre><nowiki>{{bar box
|float=right
|caption=distribution of stuff
|width=200px
|bars=
{{bar percent|foo|red|30}}
{{bar percent|bar|green|40}}
{{bar percent|baz|blue|20}}
{{bar percent|bla|orange|8}}
{{bar percent|bla|teal|2|1/50}}
}}</nowiki></pre>
{{bar box
|float=right
|caption=distribution of stuff
|barwidth=200px
|bars=
{{bar percent|foo|red|30}}
{{bar percent|bar|green|40}}
{{bar percent|baz|blue|20}}
{{bar percent|bla|orange|8}}
{{bar percent|bla|teal|2|1/50}}
}}

{{clear}}
<pre>
{{bar box
|title=Quantity of stuff
|titlebar=#DDD
|left1=kinds of stuff
|right2=pcs.
|width=400px
|bars=
{{bar pixel|Foobar|red|33|,213}}
{{bar pixel|Barfoo|green|123|,123}}
{{bar pixel|Bazbar|blue|210|,121}}
{{bar pixel|Barfoobaz|orange|13||12,854}}
|caption=Some stuff displayed by quantity.
}}
</pre>
{{bar box
|title=Quantity of stuff
|titlebar=#DDD
|left1=kinds of stuff
|right2=pcs.
|width=400px
|bars=
{{bar pixel|Foobar|red|33|,213}}
{{bar pixel|Barfoo|green|123|,123}}
{{bar pixel|Bazbar|blue|210|,121}}
{{bar pixel|Barfoobaz|orange|13||12,854}}
|caption=Some stuff displayed by quantity.
}}

{{clear}}
<pre><nowiki>
{{bar box
|float=right
|title=Election results
|titlebar=#AAF
|left1=party
|left2=year
|right1=votes
|right2=change
|width=300px
|bars=
{{bar percent 2|Left|1898|silver|33|1902|red|42|+9%}}
{{bar percent 2|Right|1898|silver|40|1902|black|35|-5%}}
{{bar percent 2|Middle|1898|silver|17|1902|blue|10|-7%}}
{{bar percent 2|Other|1898|silver|10|1902|gray|13|+3%}}
|caption=1902 and 1898 election results in Freedonia compared.
}}
</nowiki></pre>
{{bar box
|float=right
|title=Election results
|titlebar=#AAF
|left1=party
|left2=year
|right1=votes
|right2=change
|width=300px
|bars=
{{bar percent 2|Left|1898|silver|33|1902|red|42|+9%}}
{{bar percent 2|Right|1898|silver|40|1902|black|35|-5%}}
{{bar percent 2|Middle|1898|silver|17|1902|blue|10|-7%}}
{{bar percent 2|Other|1898|silver|10|1902|gray|13|+3%}}
|caption=1902 and 1898 election results in Freedonia compared.
}}

== See also ==
* {{tl|bar chart}}
* [[WP:Graphs]]

<!-- ---------------------------------------------------------------------------
---- Calling or parent template declarations, the parent template, not this page. 
---- ----------------------------------------------------------------------- -----
---><includeonly>
<!---  This is correct placement (inside includeonly block + towards the 'doc/usage' page bottom) and the call is correct for auto-categorization of many tools templates pages' generating internal links. This template call can be located anywhere in the documentation, but
should be kept inside the includeonly fence. A bottom location like this interferes least with display and formating of comprehensible documentation, but moving it up so text ends about the same point as the template display is a good thing for later edit needs. By keeping template interwiki's inside an includeonly block, this page can be given it's own, which is unimportant when the page is a collected usage page for similar templates, but good for /doc pages.

Quick Usage on V=## parameter: 1==internal links, 2==interwiki links, 3==Miscellaneous, 4==1+3, 5==2+3, 6==1+2+3 or just (1+2) when 'inhib=yes|' parameter defined as well... such as {{Tl|Commonscat1A}}, where a category link is interwiki, and a link is to main article. Parameter: 'cat=bare cat name ' supplants miscellaneous, and is used for typing-aid or uncategorized types (sub-cats of miscellaneous); 'CATS=must be given full names with square parenthesis, and add on to the V=## auto-categories. <nowiki> {{{1}}}} is pipelink sort name for the auto-cats, in 'CATS=' calls, you must add such to the pass parameter. {{{2}}} is 'universal' override name, otherwise template name defaults to {{PAGENAME}} in links built and displayed. This is primarily used in Name Case Variants, where a naming collision occurs on a sister project.  --->

<!-- EDIT/ADD TEMPLATE Interwiki's BELOW THIS LINE -->
</includeonly>