Template:Composition bar/doc

From MicrasWiki
< Template:Composition bar
Revision as of 02:54, 21 March 2019 by Hālian (talk | contribs) (Created page with "{{Documentation subpage}} <!-- Categories go where indicated at the bottom of this page, please --> This template displays the numeric composition of a thing in terms of its...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

This template displays the numeric composition of a thing in terms of its sub-units. For example, it is frequently used as part of {{Infobox political party}} to show the number of seats a given political party holds in a legislature. A single line, flexible width version of this template is available at Template:Composition bar compact.

Usage

{{Composition bar|amount|total|bar-color|options...}}
amount
The first parameter is the number of sub-units.
total
The second parameter is the total number of sub-units possible.
bar-color
(default is light grey) The third parameter is the background color of the left part of the bar - a valid web color, which can be specified by name, as a hex triplet (#rrbbgg), or rgb triplet (rgb(0–255,0–255,0–255)).
In the case of political parties, most will have their logo color available in Template:Tld templates.

Additional display options:

background-color=...
(default is transparent) is the background color of the right part of the bar - a valid web color.
border=...
(default is medium grey) is the color of the border, or "none" for no border
width=...
(default is 100px) a width value for the bar, such as "100%" or "8em" (unitless numbers are interpreted as px)
per=...
(default is false), when set to any value (true), adds a percentage to the bar as well
ref=...
(default is blank), may be used to add a reference/citation for the numbers.

Examples

Code Result
{{Composition bar|50|100|red}}
50 / 100
{{Composition bar|50|100|red|background-color=#DDD|border=none}}
50 / 100
{{Composition bar|50|100|#99F|width=85%}}
50 / 100
{{Composition bar|50|100|{{Green Party (UK)/meta/color}}}}
50 / 100
{{Composition bar|50|100|rgb(255,255,16)}}
50 / 100
{{Composition bar|75|100|#FF0}}
75 / 100
{{Composition bar|40|100|#F00|per=1}}
40 / 100 (40%)
{{Composition bar|90|100|#F0F0F0|per=1|background-color=#F00}}
90 / 100 (90%)
{{Composition bar|90|100|#F0C|per=1}}
90 / 100 (90%)
{{Composition bar|0|26|hex=#00BFFF|per=1}}
0 / 26 (0%)

TemplateData

Template:TemplateDataHeader

<templatedata> {

   "description": "A composition bar.",
   "params": {
       "1": {
           "label": "1",
           "description": "The number of sub-units.",
           "type": "string/line",
           "required": true
       },
       "2": {
           "label": "2",
           "description": "The total number of sub-units possible.",
           "type": "string/line",
           "required": true
       },
       "3": {
           "label": "3",
           "description": "The background color of the left part of the bar - a valid web color, which can be specified by name, as a hex triplet (#rrbbgg), or rgb triplet (rgb(0–255,0–255,0–255)).  In the case of political parties, most will have their logo color available in Template:Political party/meta/color templates.",
           "default": "#CCCCCC",
           "type": "string/line",
           "required": false,
           "aliases": ["hex"]
       },
       "background-color": {
           "label": "Background color",
           "description": "The background color of the right part of the bar - a valid web color.",
           "default": "transparent",
           "type": "string/line",
           "required": false
       },
       "border": {
           "label": "Border color",
           "description": "The color of the border, or 'none' for no border",
           "default": "#AAAAAA",
           "type": "string/line",
           "required": false,
           "aliases": ["border-color"]
       },
       "width": {
           "label": "Width",
           "description": "The width of the bar with units, such as 100% or 10em (unitless numbers are interpreted as px)",
           "default": "100px",
           "type": "string/line",
           "required": false
       },
       "per": {
           "label": "Show percent",
           "description": "When set to 1 (true), adds a percentage to the bar as well",
           "default": "0",
           "type": "string/line",
           "required": false
       }
   }

} </templatedata>

See also

Template:Progress templates