New book - 'Building a Better World in Your Backyard' - on Kickstarter (sponsored friend)

Template:Bar box/doc

From Appropedia
Jump to: navigation, search

{{bar box}}, {{bar percent}} and {{bar pixel}} are a family of templates for constructing horizontal bar charts.

Usage[edit]

{{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)}
}}

Chart contents[edit]

Bar box can contain any number of bars. There are two types of bars:

  • Percentage bar:
{{bar percent|row label|colour|value (width in percents)|optional value label}}

If value label is not provided, it is constructed from the percentage and "%".

  • Pixel bar:
{{bar pixel|row label|colour|value (width in pixels)|value suffix|optional value label}}

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:

{{bar pixel|foo|red|12||12,345}}
{{bar pixel|foo|red|12|3,45}}

Examples[edit]

Carbon footprint from natural gas, residential customer[edit]

{{bar box
|title=Carbon footprint from natural gas
|titlebar=#DDD
|left1=Year
|right1=kg CO<sub>2</sub>
|width=600px
|bars=
{{bar pixel|1999|gray|260||2,605}}
{{bar pixel|2000|gray|160||1,604}}
{{bar pixel|2001|gray|109||1,092}}
{{bar pixel|2002|gray|55|| 555}}
{{bar pixel|2003|gray|55|| 555}}
{{bar pixel|2004|gray|36|| 360}}
{{bar pixel|2005|gray|21|| 207}}
{{bar pixel|2006|gray|21|| 207}}
{{bar pixel|2007|gray|38|| 378}}
{{bar pixel|2008|gray|26|| 262}}
{{bar pixel|2009|gray|25|| 250}}
{{bar pixel|2010|gray|13|| 128}}
|caption=The residential customer learned to live mostly without heat in winter.
}}
Carbon footprint from natural gas
Year kg CO2
1999
  
2,605
2000
  
1,604
2001
  
1,092
2002
  
555
2003
  
555
2004
  
360
2005
  
207
2006
  
207
2007
  
378
2008
  
262
2009
  
250
2010
  
128
The residential customer learned to live mostly without heat in winter.

Carbon footprint from electricity, residential customer[edit]

{{bar box
|title=Carbon footprint from residential electricity consumption
|titlebar=#DDD
|left1=Year
|right1=kg CO<sub>2</sub>
|width=600px
|bars=
{{bar pixel|1999|gray|493||4,930}}
{{bar pixel|2000|gray|429||4,295}}
{{bar pixel|2001|gray|377||3,770}}
{{bar pixel|2002|gray|406||4,058}}
{{bar pixel|2003|gray|351|| 3,507}}
{{bar pixel|2004|gray|309|| 3,092}}
{{bar pixel|2005|gray|254|| 2,541}}
{{bar pixel|2006|gray|247|| 2,474}}
{{bar pixel|2007|gray|227|| 2,270}}
{{bar pixel|2008|gray|204|| 2,042}}
{{bar pixel|2009|#66FF33|167|| ''1,669''}}
{{bar pixel|2010|#66FF33|150|| ''1,496''}}
|caption=Green bars indicate years in which customer purchased green electricity.
}}
Carbon footprint from residential electricity consumption
Year kg CO2
1999
  
4,930
2000
  
4,295
2001
  
3,770
2002
  
4,058
2003
  
3,507
2004
  
3,092
2005
  
2,541
2006
  
2,474
2007
  
2,270
2008
  
2,042
2009
  
1,669
2010
  
1,496
Green bars indicate years in which customer purchased green electricity.

Example of Template:Bar percent, meaningless data[edit]

{{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}}
}}
foo
  
30%
bar
  
40%
baz
  
20%
bla
  
8%
bla
  
1/50
distribution of stuff

Example with Template:Bar pixel, meaningless data[edit]

{{bar box
|title=Quantity of stuff
|titlebar=#DDD
|left1=kinds of stuff
|right2=pcs.
|width=300px
|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.
}}
Quantity of stuff
kinds of stuff pcs.
Foobar
  
33,213
Barfoo
  
123,123
Bazbar
  
210,121
Barfoobaz
  
12,854
Some stuff displayed by quantity.

Example with Template:Bar percent 2, meaningless data[edit]

{{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.
}}
Election results
party year votes change
Left 1898
  
33% +9%
1902
  
42%
Right 1898
  
40% -5%
1902
  
35%
Middle 1898
  
17% -7%
1902
  
10%
Other 1898
  
10% +3%
1902
  
13%
1902 and 1898 election results in Freedonia compared.


External links[edit]

Wikipedia
This page or section includes content from Wikipedia. The original article was at Template:Bar box. The list of authors can be seen in the history for that page. As with Appropedia, the text of Wikipedia is available under the CC-BY-SA.