Template:Navbox with columns

[view] [edit] Documentation

This documentation is transcluded from Template:Navbox with columns/doc (history).

The template documentation below is transcluded from Template:Navbox with columns/doc [edit]

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[alilan ya ing pikuwanan]

Only required parameters and colwidth included.

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

* 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.

Parameters[alilan ya ing pikuwanan]

Required parameters in bold. Parameters marked with a cross^† are parameters in common with the sister templates {{Navbox}} and {{Navbox with collapsible groups}}. A much more complete description of those parameters is available at {{Navbox}}.

Setup parameters[alilan ya ing pikuwanan]

name^†: The name of the template. The name of this template, for example, is "Navbox with columns".

state^†: Possible values are collapsed, uncollapsed, plain, off, and the default autocollapse. See {{Navbox}} for more information.

navbar^†: Possible values are plain, off, and the default value of blank. See {{Navbox}} for more information.

border^†: Possible values are child, none, and the default value of blank. Set to child 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 {{Navbox}}, a columns of another {{Navbox with columns}}, or a section of {{Navbox with collapsible groups}}. See {{Navbox}} for more information and examples.

Basic data parameters[alilan ya ing pikuwanan]

title^†: The title of the template, displayed centered in the titlebar at the top of the template.

above^†: Text or other elements to appear above the columns.

image^†: Image to the right of all of the columns.

imageleft^†: Image to the left of all of the columns.

below^†: Text or other elements to appear below the columns.

Style parameters[alilan ya ing pikuwanan]

bodystyle^†: CSS style/s to apply to the template's body (i.e. including space not used by columns)

titlestyle^†: CSS style/s to apply to titlebar; usually background:color (background defaults to NavHead default).

abovestyle^†
belowstyle^†: CSS style/s to apply to the above and below parameters, respectively.

basestyle^†: CSS style/s to apply to the title, above, and below, parameters, all at the same time.

imagestyle^†: CSS style/s to apply to the image parameter.

imageleftstyle^†: CSS style/s to apply to the imageleft parameter

colsstyle: CSS style/s to apply across all columns; if used, usually background:color per titlestyle above.

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

col_nstyle: CSS style/s to apply to the n^th column only.

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

col_nheaderstyle: CSS style/s to apply to the n^th column header.

col_nfooterstyle: CSS style/s to apply to the n^th column footer cell.

Columns parameters[alilan ya ing pikuwanan]

colwidth

Width, preferably in a proportional unit such as 'em', or as a percentage, used for each column whose width not specified by colNwidth below. Defaults to 10em. Examples:

colwidth = 15em

colwidth = 25%

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:

fullwidth = true

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_nwidth: The n^th column's width (overrides colwidth above).

col_n: The content of the n^th column. col1 is required. There can be a maximum of 20 columns.

col_nheader: A header cell for the n^th column that appears above the column. See below for examples.

col_nfooter: A footer cell that appears below the n^th column.

col_nheadercolspan: A number specifying how many columns the n^th 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 col1headercolspan = 3, then leave col2header and col3header blank.

col_nfootercolspan: A number specifying how many columns the n^th 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 col1footercolspan = 3, then leave col2footer and col3footer blank.

Additional lists[alilan ya ing pikuwanan]

You may wish to add a few extra lists below the columns. The following parameters are given to provide such functionality. See {{Navbox}} for a more complete description of how they work, and for more examples. Groups are not allowed.

list_n^†: Allows up to 6 additional lists below the columns.

liststyle^†: The general CSS style/s for the lists.

list_nstyle^†: CSS style/s for the n^th list parameter.

listpadding^†: Amount of padding to have in each list cell.

Examples[alilan ya ing pikuwanan]

Basic example[alilan ya ing pikuwanan]

{{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 {{{above}}} 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[alilan ya ing pikuwanan]

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

Example with col_nheader and col_nfooter[alilan ya ing pikuwanan]

The gray background for the columns is added for illustration only.

Using child navboxes[alilan ya ing pikuwanan]

All three types of navbox templates, namely {{Navbox}}, {{Navbox with columns}}, and {{Navbox with collapsible groups}}, can be nested inside of one another using the border 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[alilan ya ing pikuwanan]

This example shows how one can nest multiple {{Navbox with columns}} templates to get the right look. Edit this section to view the code. There is a main {{Navbox with columns}} and two additional {{Navbox with columns}} templates, with the "child" option set (see code).

Nesting other Navbox forms[alilan ya ing pikuwanan]

This example shows {{Navbox}}, {{Navbox with collapsible groups}} and {{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 child

view • talk • edit	collapsible	Header color^†	Image	Groups	Style (body) parameter/s	Example
{{Navigation}}	`NavFrame`	NavHead	No	No	Yes	{{OPEC}}
{{Navigation with image}}	`NavFrame`	NavHead	Left/right of body	No	Yes	{{HolmesNovels}}
{{Navigation with columns}}	`NavFrame`	NavHead	No	No	Yes
{{Dynamic navigation box}}	`collapsible`	navbox	No	No	Yes	{{CSUHeads}}
{{Dynamic navigation box with image}}	`NavFrame`	NavHead	Upper left	No	No	{{SlovakPMs}}
{{Navbox generic}}	`collapsible`	navbox	Right-hand side	Yes	Yes	{{Dilbert}}
{{NavigationBox}}	No	navbox	Right of title+body	No	No	{{EPA}}

{{Commons:NavigationBox}}	No	#ccccff	Right of title+body	No	No
{{Commons:Dynamic navigation box}}	`NavFrame`	#ccccff	No	No	No
{{Commons:Dynamic navigation box with image}}	`NavFrame`	#ccccff	Upper left	No	No

^† The background color for the header or title is inherited from the class listed below. The templates have `titlestyle` parameters that can be used to override the default.

Type	CSS classes	Collapses when	Custom initial state	Nesting	Header color	Font size
NavFrame div	NavFrame, NavHead, NavContent	3+ of the same	No	Yes	#ccccff	95%
Collapsible table	collapsible, navbox	2+ of the same	Yes	Yes	#ccccff	90%
For the technically minded, see Common.css and Common.js.