Mal:Navbox with columns/dok

Dette er en underside med dokumentasjon for Mal:Navbox with columns (se denne siden for selve malen). Den inneholder brukerinformasjon, kategorier og annet som ikke er del av den originale malsiden.

Mal: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[rediger kilde]

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[rediger kilde]

Setup parameters[rediger kilde]

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

state^[1]: Possible values are collapsed, uncollapsed, plain, off, and the default autocollapse. See Mal:T1 for more information.

navbar^[1]: Possible values are plain, off, and the default value of blank. See Mal:T1 for more information.

border^[1]: 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 Mal:T1, a columns of another Mal:T1, or a section of Mal:T1. See Mal:T1 for more information and examples.

Basic data parameters[rediger kilde]

title^[1]: The title of the template, displayed centered in the titlebar at the top of the template.

above^[1]: Text or other elements to appear above the columns.

image^[1]: Image to the right of all of the columns.

imageleft^[1]: Image to the left of all of the columns.

below^[1]: Text or other elements to appear below the columns.

Style parameters[rediger kilde]

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

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

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

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

imagestyle^[1]: CSS style/s to apply to the image parameter.

imageleftstyle^[1]: CSS style/s to apply to the imageleft parameter

colstyle: 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[rediger kilde]

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. If any columns are used, then 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 groups/lists[rediger kilde]

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 Mal:T1 for a more complete description of how they work, and for more examples.

group_n^[1]: Allows up to 6 additional groups to go along with the lists below the columns.

list_n^[1]: Allows up to 6 additional lists below the columns.

groupstyle^[1]: The general CSS style/s for the groups.

group_nstyle^†: CSS style/s for the n^th group parameter.^[1]
liststyle^[1]: The general CSS style/s for the lists.

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

listpadding^[1]: 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 [swap, even, odd, off]: See Mal:T1 for description.

Examples[rediger kilde]

Basic example[rediger kilde]

{{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> {{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[rediger kilde]

{{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[rediger kilde]

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

Example with col_nheader using col_nheadercolspan[rediger kilde]

The gray background for the columns is added for illustration only. This example shows the col_nheadercolspan parameter being used, but you may also use col_nfootercolspan to adjust the span of the footer cells.

Example to illustrate most fields[rediger kilde]

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.

Using child navboxes[rediger kilde]

All three types of navbox templates, namely Mal:T1, Mal:T1, and Mal:T1, 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[rediger kilde]

This example shows how one can nest multiple Mal:T1 templates to get the right look. Edit this page to see the code. There is a main Mal:T1 and two additional Mal:T1 templates, with the "child" option set (see code).

Nesting other Navbox forms[rediger kilde]

This example shows Mal:T1, Mal:T1 and Mal:T1 all working together. Edit this page to see the code. Note that each of the child navboxes has the first parameter set to child. Mal:Navbox with collapsible groups

Footnote[rediger kilde]

^ ^a ^b ^c ^d ^e ^f ^g ^h ⁱ ^j ^k ^l ^m ⁿ ^o ^p ^q ^r ^s ^t ^u ^v Parameters marked with a footnote ^[1] are parameters in common with the sister templates Mal:T1 and Mal:T1. A much more complete description of those parameters is available at Mal:T1.

vis diskuter rediger	collapsible	Header color^†	Image	Groups	Style (body) parameter/s	Example
{{Navigation}}	`NavFrame`	NavHead	Nei	Nei	Ja	{{OPEC}}
{{Navbox}} compatible w/above	`collapsible`	navbox	Left/right of body	Ja	discouraged	{{Apollo program}}
{{Navigation with columns}}	`NavFrame`	NavHead	Nei	Nei	Ja	{{UK subdivisions}}
{{Navbox generic}}	`collapsible`	navbox	Right-hand side	Ja	Ja	{{Dilbert}}
{{NavigationBox}}	Nei	navbox	Right of title+body	Nei	Nei	{{Bowl Games}}

^† 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	Default header color	Font size
NavFrame div	NavFrame, NavHead, NavContent	NavContent style="display:none;"	Ja*	Ja	#ccccff	95%
Collapsible table	collapsible, navbox	2 or more autocollapse on page	Ja	Ja	#ccccff	90%
*NavFrames have custom initial state since August 8, 2007. For the technically minded, see Common.css and Common.js.