Editing Template:Navbox with columns/doc

<includeonly>{{template doc page transcluded}}</includeonly><noinclude>{{template doc page viewed directly}}</noinclude>
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
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="font-size:95%; 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 ==
Required parameters in '''bold'''.  Parameters marked with a cross'''<sup>†</sup>''' are parameters in common with the sister template {{t1|Navbox}}.  A much more complete description of those parameters is available there.

===Setup parameters===
:;name<sup>†</sup>
::The name of the template. The name of this template, for example, is "Navigation with columns".

:;state<sup>†</sup>
::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''<sup>†</sup>
::Possible values are <code>plain</code>, <code>off</code>, and the default value of blank.  See {{t1|Navbox}} for more information.

:;''border''<sup>†</sup>
::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 sections}}.  See {{t1|Navbox}} for more information and examples.

===Basic data parameters===
:;'''''title'''''<sup>†</sup>
::The title of the template, displayed centered in the titlebar at the top of the template.

:;''above''<sup>†</sup>
::Text or other elements to appear above the columns.

:;''image''<sup>†</sup>
::Image to the right of all of the columns.

:;''imageleft''<sup>†</sup>
::Image to the left of all of the columns.

:;''below''<sup>†</sup>
::Text or other elements to appear below the columns.

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

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

:;''abovestyle''<sup>†</sup>
:;''belowstyle''<sup>†</sup>
::CSS style/s to apply to the ''above'' and ''below'' parameters, respectively.

:;''basestyle''<sup>†</sup>
::CSS style/s to apply to the ''title'', ''above'', ''below'', and ''group'' parameters, all at the same time.

:;''imagestyle''<sup>†</sup>
::CSS style/s to apply to the ''image'' parameter.

:;''imageleftstyle''<sup>†</sup>
::CSS style/s to apply to the ''imageleft'' parameter 

:;''colsstyle''
::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.

:;''colheader2style''
::CSS style/s to apply to all second level columns headers.

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

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

:;''col<sub>n</sub>footer''
::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>

:;''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.  <code>col1</code> is required.  There can be a maximum of 12 columns.

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

:;''col<sub>n</sub>header2
::A second header cell for the n<sup>th</sup> column that appears above the column, but below the first header cell.

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

===Customization parameters for the column headers and footer===
:;''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>headerrowspan
::Set to either 1 or 2; defaults to 1.  The number of rows that the n<sup>th</sup> column header should span.  Only set to two if you intend to set colNheader2 for the remaining columns.

:;''col<sub>n</sub>header2colspan
::A number specifying how many columns the n<sup>th</sup> second level 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>col1header2colspan = 3</code>, then leave <code>col2header2</code> and <code>col3header3</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>col1footerspan = 3</code>, then leave <code>col2footer</code> and <code>col3footer</code> blank.

===Additional groups/lists===
You may wish to add a few extra 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.  Groups are not allowed.

:;''list<sub>n</sub>''
::Allows up to 6 additional lists below the columns.

:;''liststyle''
::The general CSS style/s for the lists.

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


== 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/> {{CAM}}<br/> {{IND}}
|col2 = {{IDN}}<br/> {{JPN}}<br/> {{LAO}}<br/> {{MAS}}
|col3 = {{MYA}}<br/> {{NZL}}<br/> {{CHN-PRC}}<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/> {{CAM}}<br/> {{IND}}
|col2 = {{IDN}}<br/> {{JPN}}<br/> {{LAO}}<br/> {{MAS}}
|col3 = {{MYA}}<br/> {{NZL}}<br/> {{CHN-PRC}}<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

}}


===Advanced col<sub>n</sub>header example===
This example shows how to use the col<sub>n</sub>headerrowspan and col<sub>n</sub>headercolspan features to make the headers look the way you want.  This one uses both header levels.  The gray background for the columns is added for illustration only.
{{Navbox with columns
|name = Navbox with columns/doc
|state = uncollapsed
|title = Row/colspan tests

|colstyle = text-align:center;background:silver;
|colwidth = 15%
|col1width = 12%
|col2width = 13%

|col1headercolspan = 2
|col3headerrowspan = 2
|col4headercolspan = 3
|col7headerrowspan = 2

|col1header = Col1Header
|col1header2 = Col1Header2
|col2header2 = Col2Header2
|col3header = Col3Header
|col4header = Col4Header
|col4header2 = Col4Header2
|col5header2 = Col5Header2
|col6header2 = Col6Header2
|col7header = Col7Header

|col1 = Col1
|col2 = Col2
|col3 = Col3
|col4 = Col4
|col5 = Col5
|col6 = Col6
|col7 = Col7
}}


==Using child navboxes==
All three types of navbox templates, namely {{t1|Navbox}}, {{t1|Navbox with columns}}, and {{t1|Navbox with collapsible sections}}, 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 section to view 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 sections}} and {{t1|Navbox with columns}} all working together.  Press the edit button for the section to view the code.  Note that each of the child navboxes has the first parameter set to <code>child</code>
{{User:CapitalR/Navbox with collapsible sections
|name = Navbox with collapsible sections
|title = Navbox, Navbox with columns, and Navbox with collapsible sections together
|selected = {{{1|}}}

|section1header = [[:Category:Scouting|The Scouting Movement]]
|section1abbr = movement
|section1content = [[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]]

|section2content = {{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 = &nbsp;
|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 = &nbsp;
|list6  = [[History of Djibouti#French Interest|French Somaliland (Djibouti)]]{{·}} [[History of Madagascar#French Control|Madagascar]]{{·}} [[Mauritius|Ile de France]]{{·}} [[Seychelles]]

}}

|section3header = [[:Category:Scouting in the United Kingdom|Scouting in the United Kingdom]]
|section3abbr = Scouting
|section3content = [[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]]

|section4content = {{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
}}

}}

== See also ==
* {{t1|Navbox}} &ndash; Allows groups/lists instead of columns
* {{t1|Navbox with collapsible sections}} &ndash; Another variation.

{{Navigational templates}}


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

<!--Other languages-->
[[ja:Template:Navbox with columns]]
[[mk:Шаблон:Navbox with columns]]
[[sl:Predloga:Navigacija s stolpci]]
</includeonly>