View source for Template:Bar box/doc

{{Documentation subpage}}
<includeonly><!-----------------Interwiki Doc page pattern------------------->{{clear}}
<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>{{clear}}</includeonly>
{{tl2|Bar box}}, {{tl2|bar percent}}, {{tl2|bar pixel}}, {{tl2|bar log}}, {{tl2|bar stacked}} and {{tl2|bar gap}} 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 bar area''      (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)
 }}

=== Chart contents ===
The chart can contain any number of bars. There are four types:

'''Percentage bar'''
<pre>{{bar percent|row label|colour|value (width in percents)|optional value label}}</pre>
If value label is not provided, it is constructed from the percentage and "%". This bar type also has the {{tl2|bar percent 2}} and {{tl2|bar percent 3}} variations which display more bars for the same row label.

'''Pixel bar'''
<pre>{{bar pixel|row label|colour|value (width in pixels)|value suffix|optional value label}}</pre>
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:
<pre>{{bar pixel|foo|red|12||12,345}}
{{bar pixel|foo|red|12|,345}}</pre>
This bar type also has the {{tl2|bar pixel 2}} variation which displays two bars for the same row label.

'''Logarithmic bar'''
<pre>{{bar log|log base|row label|colour|value|value suffix|optional value label}}</pre>
Identical to Pixel bar, except the width is calculated as ''log{{sub|base}}(value)&times; 30''. Default base is 2, which makes a regular sidebar sized graph for values <100. Increase the base to handle larger numbers and make the bars shorter. As with {{tl2|bar pixel}}, when <code>value + value_suffix = optional_value_label</code>, they display the same:
<pre>{{bar log|2|foo|red|100||100,345}}
{{bar log|2|foo|red|100|,345}}</pre>

'''Stacked bars'''
<pre>{{bar stacked|1st left label|1st right label|color 1|width 1 (in pixels)|...|color 5|width 5 (in pixels)|note1=2nd left label|note2=2nd right label|title1="tooltip" 1|...|title5="tooltip" 5|align=xxxx(l|c|r|d)|collapsed=(yes|y|1)|id=collapsible id}}</pre>
<code>titlex</code> sets the "tooltip" of the respective bar and is viewed when hovered over. <code>align</code> sets the text-alignment (left, center, right or default) for each column based on the respective initials. All parameters are optional, but if <code>id</code> is not supplied, <code>collapsed</code> has no effect. Use a custom toggle as the default toggle will distort the chart (see the last example).

'''Gap bar'''
<pre>{{bar gap|optional separator|height=any valid length (omitting unit defaults to px, default is 10px)}}</pre>
Omitting the <code>separator</code> generates a blank row. Another useful <code>separator</code> is <code><nowiki><hr></nowiki></code> which produces a horizontal line.

== Examples ==
Using {{tl2|bar percent}}:
<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 gap|qux}}
{{bar percent|bla|orange|8}}
{{bar percent|bla1|teal|2|1/50}}
}}
</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 gap|qux}}
{{bar percent|bla|orange|8}}
{{bar percent|bla1|teal|2|1/50}}
}}

{{clear}}
Using {{tl2|bar pixel}}:
<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}}
Using {{tl2|bar log}}:
<pre>
{{Bar box
|float=right
|title=Quantity of stuff
|titlebar=#DDD
|left1=kinds of stuff
|right2=pcs.
|width=400px
|bars=
{{bar log|10|Foobar|red|33|,213}}
{{bar log|10|Barfoo|green|123|,123}}
{{bar log|10|Bazbar|blue|910|,121}}
{{bar log|10|Foobaz|orange|2||1,854}}
|caption=Some stuff displayed on a log scale.
}}
</pre>
{{Bar box
|float=right
|title=Quantity of stuff
|titlebar=#DDD
|left1=kinds of stuff
|right2=pcs.
|width=400px
|bars=
{{bar log|10|Foobar|red|33|,213}}
{{bar log|10|Barfoo|green|123|,123}}
{{bar log|10|Bazbar|blue|910|,121}}
{{bar log|10|Foobaz|orange|2||1,854}}
|caption=Some stuff displayed on a log scale.
}}

{{clear}}
Using {{tl2|bar percent 2}}:
<pre>
{{Bar box
|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.
}}
</pre>
{{Bar box
|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.
}}

{{clear}}
Using {{tl2|bar stacked}}:
<pre>
{{Bar box
|float=right
|width=300px
|title=
<div class="mw-customtoggle-a mw-customtoggle-b">Toggle all</div>
<div class="mw-customtoggle-b">Toggle last item</div>
|bars=
{{bar stacked|January|(---)|red|3|blue|22|align=ddcd|id=a}}
{{bar stacked|February|+60.3%|red|8|blue|26|green|6|id=a}}
{{bar stacked|March|99|red|11|blue|18|green|8|orange|11|magenta|20|note2=+25%|align=cdrl|id=a}}
{{bar stacked|April|142|red|15|blue|24|green|8|orange|13|magenta|26|note1=foo|note2=+11%|collapsed=yes|id=b}}
}}
</pre>
{{Bar box
|float=right
|width=300px
|title=
<div class="mw-customtoggle-a mw-customtoggle-b">Toggle all</div>
<div class="mw-customtoggle-b">Toggle last item</div>
|bars=
{{bar stacked|January|(---)|red|3|blue|22|align=ddcd|id=a}}
{{bar stacked|February|+60.3%|red|8|blue|26|green|6|id=a}}
{{bar stacked|March|99|red|11|blue|18|green|8|orange|11|magenta|20|note2=+25%|align=cdrl|id=a}}
{{bar stacked|April|142|red|15|blue|24|green|8|orange|13|magenta|26|note1=foo|note2=+11%|collapsed=yes|id=b}}
}}

== Tracking category ==
* {{clc|Pages using bar box without float left or float right}}

== See also ==
* {{tl|Vertical bar chart}}
* {{tl|Bar chart}}
* {{tl|Data bars}}
* [[WP:Graphs]]

<includeonly>{{Sandbox other||
<!-- EDIT/ADD TEMPLATE Categories BELOW THIS LINE -->
[[Category:Bar chart templates]]
[[Category:Graph, chart and plot templates]]
[[Category:Templates that add a tracking category]]
}}</includeonly>