imported>Urbancowgurl777 at 15:41, 11 February 2012

2012-02-11T15:41:30Z

New page

{{documentation}}
==Usage==
This template can be used to make a standard navigation box. It is intended for use within another template that standardises the title and contents of the box, for example, [[Template:Rune running]]. In general, it SHOULD NOT be used directly within articles, as it creates a maintenance burden to do so whenever the contents of the box have to be updated.

The purpose of this template is to standardise certain attributes of all navigation boxes, for example, their colours and other CSS attributes. While at the moment the template is simple, in the future it could be extended to add other features. Using this template now allows changes like this to be implemented much quicker and easier than editing each template separately.

==Syntax==
<pre>
{{navbox
| name = mandatory - name of the template
| state = uncollapsed, collapsed, plain, autocollapse (default)
| style = optional styles to be added for the whole table
| title = mandatory - template header
| gtitleN = optional - title of N-th group of items
| styleN = optional - style; i.e. (line-height, font-size, etc.)
| groupN = mandatory - list of items
| titlewidth = optional - width of the group title column
}}
</pre>

* '''Groups:''' Currently, the maximum number of groups allowed is '''14'''.
** Groups of items can be added as parameters: ''group1'', ''group2'', ''group3'', ... up to ''groupN''.
* '''Group title:''' Each group has its own title parameter: ''gtitle1'', ''gtitle2'', ''gtitle3'', ... up to ''gtitleN''. Note that the default width for the first column is 15%.
* '''Group style:''' Style may also be customised to each group in: ''style1'', ''style2'', ''style3'', ... up to ''styleN''.
** Note that neither the title nor the items have any wiki-links built into the template. As a result, users of the template are free to use wiki-links as they wish.
* '''Line breaks:''' Line-breaks (<code><nowiki> </nowiki></code>) are '''unnecessary''', as text wrapping is done automatically by the template. This also includes links and text in ''gtitleN'' and ''groupN''.
* '''Pipe links:''' Because of the nature of template syntax, it may be necessary to use [[Template:!]] (<code><nowiki>{{!}}</nowiki></code>) in place of actual pipes between items, otherwise the template will ignore text after the first pipe.
* '''Bullets:''' It is '''highly recommended''' that [[Template:*]] (<code><nowiki>{{*}}</nowiki></code>) be used instead. This adds a bullet ({{*}}) instead of a pipe.

==States==
* '''Autocollapse:''' By default, the state of a navbox is "autocollapsed". This means that if the number of navboxes in a page exceeds the maximum allocation of the collapsible navboxes, then the remaining navboxes are collapsed automatically. For more information (or to change the setting), see [[MediaWiki:Common.js]].
** Currently, the ''autocollapse'' allocation is '''2''' (see [[MediaWiki:Common.js]]). This means that if there are 3 navboxes in a page, the third and subsequent navboxes will be collapsed automatically.
* '''Uncollapsed:''' Forces the navbox to be displayed.
** All of the navboxes in this documentation are in the ''uncollapsed'' state.
* '''Collapsed:''' The reverse of ''uncollapsed''. Forces the navbox to be hidden instead.
** Navboxes with a height of '''more than 300 pixels''' will also be collapsed automatically. For more information (or to change the setting), see [[MediaWiki:Common.js]].
* '''Plain:''' Removes the "show/hide" link.

==Sub-groups==
* For larger navboxes, it may be necessary to include sub-groups within a particular group of items (although it is possible to create navboxes within navboxes to support multiple collapses). This template allows the creation of sub-groups within <code><nowiki>{{navbox}}</nowiki></code>, provided that certain parameters are included:
** The nested navbox (sub-group) requires the inclusion of the sub-group parameter (''subgroup = Yes''). This enables the template to differentiate between the nested and the parent navbox.
** The parent navbox group (i.e. ''group2'' in the example below) requires the style parameter (''style2 = padding:0''). This fixes the "padding" bug that occurs when sub-groups are used.

===Syntax===
<pre>
{{navbox
| name =
| state =
| title =
| gtitle1 =
| group1 =
| gtitle2 =
| style2 = padding:0 (mandatory)
| group2 =
{{navbox
| subgroup = Yes (mandatory)
| gtitle1 =
| group1 =
| gtitle2 =
| group2 =
}}
}}
</pre>

==Examples==

===Use of style; without group title===
<pre style="width:95%; overflow:scroll">
{{navbox
| name = Rune running
| title = [[Rune running]]
| style1 = text-align:center
| group1 = [[Air running|Air]] {{*}} [[Mind running|Mind]] {{*}} [[Chaos running|Chaos]] {{*}} [[Nature running|Nature]] {{*}} [[Law running|Law]]
}}</pre>

produces:

{{navbox
| name = Rune running
| state = uncollapsed
| title = [[Rune running]]
| style1 = text-align:center
| group1 = [[Air running|Air]] {{*}} [[Mind running|Mind]] {{*}} [[Chaos running|Chaos]] {{*}} [[Nature running|Nature]] {{*}} [[Law running|Law]]
}}

===Multiple groups===
<pre style="width:95%; overflow:scroll">
{{navbox
| name = Amulet
| title = [[Amulet]]s
| gtitle1 = Standard
| group1 = [[Gold amulet|Gold]] {{*}} [[Sapphire amulet|Sapphire]] {{*}} [[Emerald amulet|Emerald]] {{*}} [[Ruby amulet|Ruby]] {{*}} [[Diamond amulet|Diamond]] {{*}} [[Dragonstone amulet|Dragonstone]] {{*}} [[Onyx amulet|Onyx]]
| gtitle2 = Enchanted
| group2 = [[Amulet of magic|Magic]] {{*}} [[Amulet of defence|Defence]] {{*}} [[Amulet of nature|Nature]] {{*}} [[Amulet of strength|Strength]] {{*}} [[Amulet of power|Power]] {{*}} [[Amulet of glory|Glory]] {{*}} [[Amulet of fury|Fury]]
| gtitle3 = [[Treasure Trail]]
| group3 = [[Amulet of magic (t)]] {{*}} [[Amulet of strength (t)]] {{*}} [[Amulet of glory (t)]] {{*}} [[Third age amulet|Third Age]]
| gtitle4 = Translation
| group4 = [[Camulet]] {{*}} [[Catspeak amulet|Catspeak]] {{*}} [[Ghostspeak amulet|Ghostspeak]] {{*}} [[M'speak amulet|Monkeyspeak]]
| gtitle5 = Others
| group5 = [[Amulet of accuracy|Accuracy]] {{*}} [[Crone-made amulet|Crone-made]] {{*}} [[Cat training medal|Cat Training]] {{*}} [[Amulet of farming|Farming]] {{*}} [[Glarial's amulet|Glarial's]] {{*}} [[Gnome amulet|Gnome]] {{*}} [[Lunar amulet|Lunar]] {{*}} [[Pre-nature amulet|Pre-nature]] {{*}} [[Salve amulet (unenchanted)|Salve]] {{*}} [[Yin yang amulet|Yin Yang]]
}}</pre>

produces:

{{navbox
| name = Amulet
| state = uncollapsed
| title = [[Amulet]]s
| gtitle1 = Standard
| group1 = [[Gold amulet|Gold]] {{*}} [[Sapphire amulet|Sapphire]] {{*}} [[Emerald amulet|Emerald]] {{*}} [[Ruby amulet|Ruby]] {{*}} [[Diamond amulet|Diamond]] {{*}} [[Dragonstone amulet|Dragonstone]] {{*}} [[Onyx amulet|Onyx]]
| gtitle2 = Enchanted
| group2 = [[Amulet of magic|Magic]] {{*}} [[Amulet of defence|Defence]] {{*}} [[Amulet of nature|Nature]] {{*}} [[Amulet of strength|Strength]] {{*}} [[Amulet of power|Power]] {{*}} [[Amulet of glory|Glory]] {{*}} [[Amulet of fury|Fury]]
| gtitle3 = [[Treasure Trail]]
| group3 = [[Amulet of magic (t)]] {{*}} [[Amulet of strength (t)]] {{*}} [[Amulet of glory (t)]] {{*}} [[Third age amulet|Third Age]]
| gtitle4 = Translation
| group4 = [[Camulet]] {{*}} [[Catspeak amulet|Catspeak]] {{*}} [[Ghostspeak amulet|Ghostspeak]] {{*}} [[M'speak amulet|Monkeyspeak]]
| gtitle5 = Others
| group5 = [[Amulet of accuracy|Accuracy]] {{*}} [[Crone-made amulet|Crone-made]] {{*}} [[Cat training medal|Cat Training]] {{*}} [[Amulet of farming|Farming]] {{*}} [[Glarial's amulet|Glarial's]] {{*}} [[Gnome amulet|Gnome]] {{*}} [[Lunar amulet|Lunar]] {{*}} [[Pre-nature amulet|Pre-nature]] {{*}} [[Salve amulet (unenchanted)|Salve]] {{*}} [[Yin yang amulet|Yin Yang]]
}}

===Sub-groups===
<pre style="width:95%; overflow:scroll">
{{navbox
| name = Rune equipment
| title = [[Rune equipment]]
| gtitle1 = [[Rune weapons|Weapons]]
| group1 =
| gtitle2 = [[Rune armour|Armour]]
| group2 =
| gtitle3 = [[Gilded armour]]
| group3 =
| gtitle4 = [[God armour]]
| style4 = padding:0
| group4 =
{{navbox
| subgroup = Yes
| gtitle1 = [[Guthix]]
| group1 =
| gtitle2 = [[Saradomin]]
| group2 =
| gtitle3 = [[Zamorak]]
| group3 =
}}
| gtitle5 = Ranged
| group5 =
| gtitle6 = [[Runite (metal)|Other]]
| group6 =
}}</pre>

produces:

{{navbox
| name = Rune equipment
| state = uncollapsed
| title = [[Rune equipment]]
| gtitle1 = [[Rune weapons|Weapons]]
| group1 = ''Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum porttitor quam quis neque tincidunt commodo.''
| gtitle2 = [[Rune armour|Armour]]
| group2 = ''Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi lacinia augue aliquet nibh fringilla molestie. Nullam nunc nibh, bibendum nec mollis scelerisque, rutrum quis lacus.''
| gtitle3 = [[Gilded armour]]
| group3 = ''Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum porttitor quam quis neque tincidunt commodo.''
| gtitle4 = [[God armour]]
| style4 = padding:0
| group4 =
{{navbox
| subgroup = Yes
| gtitle1 = [[Guthix]]
| group1 = ''Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi lacinia augue aliquet nibh fringilla molestie. Nullam nunc nibh, bibendum nec mollis scelerisque, rutrum quis lacus.''
| gtitle2 = [[Saradomin]]
| group2 = ''Lorem ipsum dolor sit amet.''
| gtitle3 = [[Zamorak]]
| group3 = ''Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi lacinia augue aliquet nibh fringilla molestie. Nullam nunc nibh, bibendum nec mollis scelerisque, rutrum quis lacus.''
}}
| gtitle5 = Ranged
| group5 = ''Lorem ipsum dolor sit amet, consectetur adipiscing elit.''
| gtitle6 = [[Runite (metal)|Other]]
| group6 = ''Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vestibulum porttitor quam quis neque tincidunt commodo.''
}}

===Collapsed navbox===
<pre style="width:95%; overflow:scroll">
{{navbox
| name = Rune running
| state = collapsed
| title = [[Rune running]]
| style1 = text-align:center
| group1 = [[Air running|Air]] {{*}} [[Mind running|Mind]] {{*}} [[Chaos running|Chaos]] {{*}} [[Nature running|Nature]] {{*}} [[Law running|Law]]
}}</pre>

produces:

{{navbox
| name = Rune running
| state = collapsed
| title = [[Rune running]]
| style1 = text-align:center
| group1 = [[Air running|Air]] {{*}} [[Mind running|Mind]] {{*}} [[Chaos running|Chaos]] {{*}} [[Nature running|Nature]] {{*}} [[Law running|Law]]
}}

===Plain navbox with Tnavbar===
<pre style="width:95%; overflow:scroll">
{{navbox
| name = Rune running
| state = plain
| title = [[Rune running]]
| style1 = text-align:center
| group1 = [[Air running|Air]] {{*}} [[Mind running|Mind]] {{*}} [[Chaos running|Chaos]] {{*}} [[Nature running|Nature]] {{*}} [[Law running|Law]]
}}</pre>

produces:

{{navbox
| name = Rune running
| state = plain
| title = [[Rune running]]
| style1 = text-align:center
| group1 = [[Air running|Air]] {{*}} [[Mind running|Mind]] {{*}} [[Chaos running|Chaos]] {{*}} [[Nature running|Nature]] {{*}} [[Law running|Law]]
}}

===Plain navbox without Tnavbar===
<pre style="width:95%; overflow:scroll">
{{navbox
| state = plain
| title = [[Rune running]]
| style1 = text-align:center
| group1 = [[Air running|Air]] {{*}} [[Mind running|Mind]] {{*}} [[Chaos running|Chaos]] {{*}} [[Nature running|Nature]] {{*}} [[Law running|Law]]
}}</pre>

produces:

{{navbox
| state = plain
| title = [[Rune running]]
| style1 = text-align:center
| group1 = [[Air running|Air]] {{*}} [[Mind running|Mind]] {{*}} [[Chaos running|Chaos]] {{*}} [[Nature running|Nature]] {{*}} [[Law running|Law]]
}}

<noinclude>[[Category:Navigational templates|*{{PAGENAME}}]]</noinclude>
<includeonly>[[Category:Navigational templates| ]]</includeonly>

Template:Navbox/doc - Revision history

imported>Urbancowgurl777 at 15:41, 11 February 2012