View source for Template:Navbox with columns/doc

{{Documentation subpage}}
{{Navbox suite}}
A navigation box that presents its content in columns. Originally intended to provide a relatively straightforward means to align links prefixed by flag icons, e.g. in templates offering links to country articles.

== Basic syntax ==
Only required parameters and ''colwidth'' included.

<pre style="overflow:auto;">
{{Navbox with columns
|name  = {{subst:PAGENAME}}
|title = 
|colwidth =  <!--(to set a default width for each column,
                  preferably in a proportional unit such as 'em'*)-->
|col1  = 
|col2  = 
}}
</pre>
<div style="line-height:1.35em; font-size:90%;">* See [[Em (typography)]]. Using proportional units means the template should still be displayed correctly across a range of browser font-sizes. If ''colwidth'' not specified, a default 10em is used.</div>

== Parameters ==
=== Setup parameters ===
:;''name''<ref name="common">Parameters marked with a footnote '''<sup>[1]</sup>''' are parameters in common with the sister templates {{t1|Navbox}} and {{t1|Navbox with collapsible groups}}. A much more complete description of those parameters is available at {{t1|Navbox}}.</ref>
::The name of the template. The name of this template, for example, is "Navbox with columns".

:;''state''<ref name="common"/>
::Possible values are <code>collapsed</code>, <code>uncollapsed</code>, <code>plain</code>, <code>off</code>, and the default <code>autocollapse</code>.  See {{t1|Navbox}} for more information.

:;''navbar''<ref name="common"/>
::Possible values are <code>plain</code>, <code>off</code>, and the default value of blank.  See {{t1|Navbox}} for more information.

:;''border''<ref name="common"/>
::Possible values are <code>child</code>, <code>none</code>, and the default value of blank.  Set to <code>child</code> if you wish to use the navbox inside of another navbox; with this option, the child navbox is borderless and fits snuggly inside of its parent navbox.  The parent navbox may be the list area of {{t1|Navbox}}, a columns of another {{t1|Navbox with columns}}, or a section of {{t1|Navbox with collapsible groups}}.  See {{t1|Navbox}} for more information and examples.

===Basic data parameters===
:;'''''title'''''<ref name="common"/>
::The title of the template, displayed centered in the titlebar at the top of the template.

:;''above''<ref name="common"/>
::Text or other elements to appear above the columns.

:;''image''<ref name="common"/>
::Image to the right of all of the columns.

:;''imageleft''<ref name="common"/>
::Image to the left of all of the columns.

:;''below''<ref name="common"/>
::Text or other elements to appear below the columns.

===Style parameters===
:;''style''<ref name="common"/>
::CSS style/s to apply to the template's body (i.e. including space not used by columns)

:;''titlestyle''<ref name="common"/>
::[[Wikipedia:CSS|CSS]] style/s to apply to titlebar; usually <code>background:''color''</code> (background defaults to [[Wikipedia:NavFrame|NavHead]] default).

:;''abovestyle''<ref name="common"/>
:;''belowstyle''<ref name="common"/>
::CSS style/s to apply to the ''above'' and ''below'' parameters, respectively.

:;''basestyle''<ref name="common"/>
::CSS style/s to apply to the ''title'', ''above'', and ''below'', parameters, all at the same time.

:;''imagestyle''<ref name="common"/>
::CSS style/s to apply to the ''image'' parameter.

:;''imageleftstyle''<ref name="common"/>
::CSS style/s to apply to the ''imageleft'' parameter 

:;''colstyle''
::CSS style/s to apply across all columns; if used, usually <code>background:''color''</code> per ''titlestyle'' above.

:;''oddcolstyle''
:;''evencolstyle''
::CSS style/s to apply to all odd/even-numbered columns, respectively.

:;''col<sub>n</sub>style''
::CSS style/s to apply to the n<sup>th</sup> column only.

:;''colheaderstyle''
::CSS style/s to apply to all column headers.

:;''col<sub>n</sub>headerstyle''
::CSS style/s to apply to the n<sup>th</sup> column header.

:;''col<sub>n</sub>footerstyle''
::CSS style/s to apply to the n<sup>th</sup> column footer cell.

===Columns parameters===
:;''colwidth''
::Width, preferably in a proportional unit such as '[[Em (typography)|em]]', or as a percentage, used for each column whose width not specified by ''colNwidth'' below. Defaults to 10em.  Examples:
:::<code>colwidth = 15em</code>
:::<code>colwidth = 25%</code>

:;''fullwidth''
::If set to anything, then the total width of the columns are scaled linearly to make the sum of the widths 100%.  A rather advanced parameter, this usually need not be used and should be left blank.  If a colheader or colfooter is used, then fullwidth is used automatically.  Example:
:::<code>fullwidth = true</code>

:;''padding''
::Padding before first column, preferably in a proportional unit. Defaults to 5em.  Padding is disabled by setting it to 0 (or 0em, or 0%).

:;''col<sub>n</sub>width''
::The n<sup>th</sup> column's width (overrides ''colwidth'' above).

:;'''''col<sub>n</sub>'''''
::The content of the n<sup>th</sup> column.  If any columns are used, then <code>col1</code> is required.  There can be a maximum of 20 columns.

:;''col<sub>n</sub>header''
::A header cell for the n<sup>th</sup> column that appears above the column.  See below for examples.

:;''col<sub>n</sub>footer
::A footer cell that appears below the n<sup>th</sup> column.

:;''col<sub>n</sub>headercolspan
::A number specifying how many columns the n<sup>th</sup> column header should span.  It defaults to 1.  If it is greater than one, then do not specify column headers that it covers.  For example, if <code>col1headercolspan = 3</code>, then leave <code>col2header</code> and <code>col3header</code> blank.

:;''col<sub>n</sub>footercolspan
::A number specifying how many columns the n<sup>th</sup> column footer should span.  It defaults to 1.  If it is greater than one, then do not specify column footers that it covers.  For example, if <code>col1footercolspan = 3</code>, then leave <code>col2footer</code> and <code>col3footer</code> blank.

===Additional groups/lists===
You may wish to add a few extra groups and/or lists below the columns.  The following parameters are given to provide such functionality.  See {{t1|Navbox}} for a more complete description of how they work, and for more examples.

:;''group<sub>n</sub>''<ref name="common"/>
::Allows up to 6 additional groups to go along with the lists below the columns.

:;''list<sub>n</sub>''<ref name="common"/>
::Allows up to 6 additional lists below the columns.

:;''groupstyle<ref name="common"/>
::The general CSS style/s for the groups.

:;''group<sub>n</sub>''style<sup>†</sup>
::CSS style/s for the n<sup>th</sup> group parameter.<ref name="common"/>
:;''liststyle''<ref name="common"/>
::The general CSS style/s for the lists.

:;''list<sub>n</sub>style''
::CSS style/s for the n<sup>th</sup> list parameter.

:;''listpadding''<ref name="common"/>
::Amount of padding to have in each list cell.

:; ''oddstyle''
:; ''evenstyle''
::Applies to odd/even list numbers.  Overrules styles defined by ''liststyle''.  The default behavior is to add striped colors (white and gray) to odd/even rows, respectively, in order to improve readability.  These should not be changed except in extraordinary circumstances.

:; ''evenodd'' <span style="font-weight:normal;"><code>[swap, even, odd, off]</code></span>
::See {{t1|Navbox}} for description.

== Examples ==
===Basic example===
<pre style="overflow:scroll;">
{{Navbox with columns
|name    = East Asia Summit (EAS)
|title   = Member states of the [[East Asia Summit|East Asia Summit (EAS)]]
|width   = 18.25em
|padding = 10em

|above = ''This is where the <nowiki>{{{above}}}</nowiki> would appear.''

|col1 = {{AUS}}<br> {{BRU}}<br> {{flag|CHN|name=PR China}}<br> {{CAM}}
|col2 = {{IND}}<br> {{IDN}}<br> {{JPN}}<br> {{LAO}}
|col3 = {{MAS}}<br> {{MMR}}<br> {{NZL}}<br> {{PHI}}
|col4width = 17em
|col4 = {{SIN}}<br> {{KOR}}<br> {{THA}}<br> {{VIE}}

|below = '''Potential future members'''{{spaces|6}}{{TLS}}{{spaces|3}}{{RUS}}
}}
</pre>
{{Navbox with columns
|name    = East Asia Summit (EAS)
|state   = uncollapsed
|title   = Member states of the [[East Asia Summit|East Asia Summit (EAS)]]
|width   = 18.25em
|padding = 10em

|above = ''This is where the <nowiki>{{{above}}}</nowiki> parameter would appear.''

|col1 = {{AUS}}<br> {{BRU}}<br> {{flag|CHN|name=PR China}}<br> {{CAM}}
|col2 = {{IND}}<br> {{IDN}}<br> {{JPN}}<br> {{LAO}}
|col3 = {{MAS}}<br> {{MMR}}<br> {{NZL}}<br> {{PHI}}
|col4width = 17em
|col4 = {{SIN}}<br> {{KOR}}<br> {{THA}}<br> {{VIE}}

|below = '''Potential future members'''{{spaces|6}}{{TLS}}{{spaces|3}}{{RUS}}
}}

===Example with percentage widths===
<pre style="overflow:scroll;">
{{Navbox with columns
| name = Plastics
| title = [[Plastic]]s
| colwidth = 33%
| colstyle = text-align: center
| col1 = [[Polyethylene]] (PE)<br> [[Polyethylene terephthalate]] (PET or PETE)<br> [[Polyvinyl chloride]] (PVC)<br> [[Polyvinylidene chloride]] (PVDC)<br> [[Polylactic acid]] (PLA)
| col2 = [[Polypropylene]] (PP)<br> [[Polyamide]] (PA)<br> [[Polycarbonate]] (PC)<br> [[Polytetrafluoroethylene]] (PTFE)<br> [[Polyurethane]] (PU)
| col3 = [[Polystyrene]] (PS)<br> [[Polyester]]<br> [[Acrylonitrile butadiene styrene]] (ABS)<br> [[Acrylic glass|Polymethyl methacrylate]] (PMMA)<br> [[Polyoxymethylene]] (POM)
}}
</pre>
{{Navbox with columns
| name = Plastics
| title = [[Plastic]]s
| state = uncollapsed
| cols = 3
| colwidth = 33%
| colstyle = text-align: center
| col1 = [[Polyethylene]] (PE)<br> [[Polyethylene terephthalate]] (PET or PETE)<br> [[Polyvinyl chloride]] (PVC)<br> [[Polyvinylidene chloride]] (PVDC)<br> [[Polylactic acid]] (PLA)
| col2 = [[Polypropylene]] (PP)<br> [[Polyamide]] (PA)<br> [[Polycarbonate]] (PC)<br> [[Polytetrafluoroethylene]] (PTFE)<br> [[Polyurethane]] (PU)
| col3 = [[Polystyrene]] (PS)<br> [[Polyester]]<br> [[Acrylonitrile butadiene styrene]] (ABS)<br> [[Acrylic glass|Polymethyl methacrylate]] (PMMA)<br> [[Polyoxymethylene]] (POM)
}}


===Example with col<sub>n</sub>header and col<sub>n</sub>footer===
The gray background for the columns is added for illustration only.
{{Navbox with columns
|name = Navbox with columns/doc
|state = uncollapsed
|title = col<sub>n</sub>header and col<sub>n</sub>footer example

|colstyle = text-align:center;background:silver;
|colwidth = 25%

|col1header = col1header
|col2header = col2header
|col3header = col3header
|col4header = col4header

|col1 = col1
|col2 = col2
|col3 = col3
|col4 = col4

|col1footer = col1footer
|col2footer = col2footer
|col3footer = col3footer
|col4footer = col4footer

}}


===Example with col<sub>n</sub>header using col<sub>n</sub>headercolspan===
The gray background for the columns is added for illustration only.  This example shows the col<sub>n</sub>headercolspan parameter being used, but you may also use col<sub>n</sub>footercolspan to adjust the span of the footer cells.
{{Navbox with columns
|name = Navbox with columns/doc
|state = uncollapsed
|title = col<sub>n</sub>header with col<sub>n</sub>colspan example

|colstyle = text-align:center;background:silver;

|col1header = col1header
|col2header = col2header (colspan=2)
|col4header = col4header
|col5header = col5header (colspan=3)

|col2headercolspan = 2
|col5headercolspan = 3

|col1 = col1
|col2 = col2
|col3 = col3
|col4 = col4
|col5 = col5
|col6 = col6
|col7 = col7
}}


===Example to illustrate most fields===
The gray background and centered text for the columns is for illustration only.  The columns default to an off-white background and left text alignment.  This example shows how you can use up to six additional groups/lists after the columns.

{{Navbox with columns
|name = Navbox with columns/doc
|state = uncollapsed
|title = Example to illustrate most fields
|colstyle = text-align:center;background:silver;

|col1 = col1
|col2 = col2
|col3 = col3
|col4 = col4
|col5 = col5

|col1header = col1header
|col2header = col2header
|col3header = col3header
|col4header = col4header
|col5header = col5header

|col1footer = col1footer
|col2footer = col2footer
|col3footer = col3footer
|col4footer = col4footer
|col5footer = col5footer

|group1 = group1
|group2 = group2
|group3 = group3
|group4 = group4
|group5 = group5
|group6 = group6

|list1 = list1
|list2 = list2
|list3 = list3
|list4 = list4
|list5 = list5
|list6 = list6

|above = above
|below = below
}}

==Using child navboxes==
All three types of navbox templates, namely {{t1|Navbox}}, {{t1|Navbox with columns}}, and {{t1|Navbox with collapsible groups}}, can be nested inside of one another using the <code>border</code> parameter (which is common to all three).  For complex templates, it may be necessary to use nesting to achieve a desired look.

===Nesting Navbox with columns in itself===
This example shows how one can nest multiple {{t1|Navbox with columns}} templates to get the right look.  Edit this page to see the code.  There is a main {{t1|Navbox with columns}} and two additional {{t1|Navbox with columns}} templates, with the "child" option set (see code).
{{Navbox with columns
|name = Navbox with columns/doc
|state = uncollapsed
|title = Subgroups with nesting
|colstyle = text-align:center;background:silver;

|col1width = 33%
|col2width = 17%
|col3width = 33%
|col4width = 17%

|col1header = Col1Header
|col2header = Col2Header
|col3header = Col3Header
|col4header = Col4Header

|col1 = {{Navbox with columns|child
  |colwidth = 50%
  |colstyle = text-align:center;background:silver;

  |col1header = Col1.1Header
  |col2header = Col1.2Header

  |col1 = Col1.1
  |col2 = Col1.2
 }}

|col2 = Col2

|col3 = {{Navbox with columns|child
  |colwidth = 33%
  |colstyle = text-align:center;background:silver;

  |col1header = Col3.1Header
  |col2header = Col3.2Header
  |col3header = Col3.3Header

  |col1 = Col3.1
  |col2 = Col3.2
  |col3 = Col3.3
 }}

|col4 = Col4
}}

===Nesting other Navbox forms===
This example shows {{t1|Navbox}}, {{t1|Navbox with collapsible groups}} and {{t1|Navbox with columns}} all working together.  Edit this page to see the code.  Note that each of the child navboxes has the first parameter set to <code>child</code>.
{{Navbox with collapsible groups
|name = Navbox with collapsible groups
|title = Navbox, Navbox with columns, and Navbox with collapsible groups together
|selected = {{{1|}}}

|group1 = [[:Category:Scouting|The Scouting Movement]]
|abbr1  = movement
|list1  = [[Scouting]]{{·}}''[[Scouting for Boys]]''{{·}}[[Scout method]]{{·}}[[Scout Law]]{{·}}[[Scout Promise]]{{·}}[[Scout Motto]]{{·}}[[Wood Badge]]{{·}}[[Age groups in Scouting and Guiding]]{{·}}[[Cub Scout]]{{·}}[[Boy Scout]]{{·}}[[Rover Scout]]{{·}}[[Brownie (Girl Guides)|Brownie]]{{·}}[[Girl Guiding and Girl Scouting]]{{·}}[[Ranger (Girl Guide)]]{{·}}[[Jamboree (Scouting)|Jamboree]]{{·}}[[Scout Leader]]{{·}}[[World Organization of the Scout Movement|WOSM]]{{·}}[[World Association of Girl Guides and Girl Scouts|WAGGGS]]{{·}}[[Non-aligned Scouting and Scout-like organisations|Non-aligned organisations]]{{·}}[[Scouting controversy and conflict]]{{·}}[[Scouting in popular culture]]{{·}}[[List of Scouts]]{{·}}[[List of highest awards in Scouting]]

|list2  = {{Navbox|child
|title      = [[French colonial empires|Former French colonies]] in [[Africa]] and the [[Indian Ocean]]
|titlestyle = background#
|groupstyle = background:lavender;

|group1 = [[Mahgreb]]
|list1  = [[French rule in Algeria|Algeria]]{{·}} [[French Morocco|Morocco]]&nbsp;<small>([[Arguin|Arguin Island]])</small>{{·}} [[History of Tunisia|Tunisia]]

|group2 = [[French West Africa]]
|list2  = [[History of Côte d'Ivoire#French Period|Côte d'Ivoire]]{{·}} [[French Dahomey|Dahomey]]{{·}} [[French Sudan]]{{·}} [[French Guinea|Guinea]]{{·}} [[History of Mauritania#French colonization and post-colonial history|Mauritania]]{{·}} [[History of Niger#Colonization|Niger]]{{·}} [[History of Senegal|Senegal]]{{·}} [[French Upper Volta|Upper Volta]]

|group3 = Togo
|list3  = [[French Togoland]]{{·}} [[James Island (The Gambia)|James Island]]

|group4 = [[French Equatorial Africa]]
|list4  = [[Colonial Chad|Chad]]{{·}} [[History of Gabon|Gabon]]{{·}} [[History of the Republic of the Congo|Middle Congo]]{{·}} [[Oubangui-Chari]]

|group5 = [[Comoros]]
|list5  = [[Anjouan]]{{·}} [[Grande Comore]]{{·}} [[Mohéli]]

|group6 = Southern Africa
|list6  = [[History of Djibouti#French Interest|French Somaliland (Djibouti)]]{{·}} [[History of Madagascar#French control|Madagascar]]{{·}} [[Mauritius|Ile de France]]{{·}} [[Seychelles]]

}}

|group3 = [[Scouting in the United Kingdom]]
|abbr3  = Scouting
|list3  = [[The Scout Association]]{{·}}[[Girlguiding UK]]{{·}}[[Beaver Scouts]]{{·}}[[Cub Section (UK)]]{{·}}[[Venture Scout]]{{·}}[[Explorer Scouts]]{{·}}[[Brownie (Girl Guides)]]{{·}}[[Ranger (Girl Guide)]]{{·}}[[Rainbow (Girl Guides)]]{{·}}[[Scout Network]]{{·}}[[Chief Scout (United Kingdom)]]{{·}}[[Scout Counties]]{{·}}[[Scout District]]{{·}}[[Scout Section (UK)]]{{·}}[[Scout Activity Centre]]{{·}}[[Young Leaders (The Scout Association)|Young Leaders]]

|list4  = {{Navbox with columns|child
|title = Navbox with columns nested in itself
|colstyle = text-align:center;

|col1width = 33%
|col2width = 17%
|col3width = 33%
|col4width = 17%

|col1header = Col1Header
|col2header = Col2Header
|col3header = Col3Header
|col4header = Col4Header

|col1 = {{Navbox with columns|child
  |colwidth = 50%
  |colstyle = text-align:center;

  |col1header = Col1.1Header
  |col2header = Col1.2Header

  |col1 = Col1.1
  |col2 = Col1.2
 }}

|col2 = Col2

|col3 = {{Navbox with columns|child
  |colwidth = 33%
  |colstyle = text-align:center;

  |col1header = Col3.1Header
  |col2header = Col3.2Header
  |col3header = Col3.3Header

  |col1 = Col3.1
  |col2 = Col3.2
  |col3 = Col3.3
 }}

|col4 = Col4
}}

}}

==Footnote==
<references/>

== See also ==
* {{t1|Navbox}} &ndash; Allows groups/lists instead of columns
* {{tl|Navbox subgroup long}} &ndash; expanded version of {{tl|Navbox subgroup}} allowing up to 38 subgroups
* {{t1|Navbox with collapsible groups}} &ndash; Another variation.

{{Navigational templates}}


<includeonly>
<!--Categories-->
[[Category:Navbox (navigational) templates| ]]

<!--Other languages-->
[[ar:قالب:Navbox with columns]]
[[cs:Šablona:Navbox se sloupci]]
[[eo:Ŝablono:Navigilo kun kolumnoj]]
[[fr:Modèle:Méta palette de navigation avec colonnes]]
[[ko:틀:안내/다단]]
[[hsb:Předłoha:Nawitabela ze špaltami]]
[[ja:Template:Navbox with columns]]
[[ku:Şablon:Navbox with columns]]
[[mk:Шаблон:Navbox with columns]]
[[pl:Szablon:Navbox z kolumnami]]
[[pt:Predefinição:Navbox with columns]]
[[ro:Format:Casetă de navigare cu coloane]]
[[ru:Шаблон:Навигационная таблица с колонками]]
[[sl:Predloga:Navigacija s stolpci]]
[[uk:Шаблон:Navbox with columns]]
[[vi:Tiêu bản:Navbox with columns]]
[[zh:Template:Navbox with columns]]
</includeonly>