Template:Navbox/doc

From FORwiki

Current revision as of 22:49, 24 December 2009

This template allows a navigational template to be set up relatively quickly by supplying it one or more lists of links. It comes equipped with default styles that should work for most navigational templates. Changing the default styles is not recommended, but is possible. Using this template, or one of its "Navbox suite" sister templates, is highly recommended for standardization of navigational templates, and for ease of use.

Usage

Please remove the parameters that are left blank.

{{Navbox
|bodyclass  = 
|name       =
|title      = 
|titleclass = 
|image      = 
|above      = 

|group1     = 
|list1      = 

|group2     = 
|list2      = 
 ...
|group20    = 
|list20     = 

|below      = 
}}

Parameter list

The navbox uses lowercase parameter names, as shown in the box (at right). The mandatory name and title will create a one-line box if other parameters are omitted.

Notice "group1" (etc.) is optional, as are sections named "above/below".
The basic and most common parameters are as follows (see below for the full list):

bodyclass - applies an HTML class attribute to the entire navbox.

name - the name of the template.

title - text in the title bar, such as: [[Widget stuff]].

titleclass - applies an HTML class attribute to the title bar.

state - autocollapse, uncollapsed, collapsed: the status of box expansion, where "autocollapse" hides stacked navboxes automatically.

titlestyle - a CSS style for the title-bar, such as: background:gray;

groupstyle - a CSS style for the group-cells, such as: background:#eee;

image - an optional right-side image, coded as the whole image. Typically it is purely decorative, so it should be coded as [[Image:XX.jpg|90px|link=|alt=]].

imageleft - an optional left-side image (code the same as the "image" parameter).

above - text to appear above the group/list section (could be a list of overall wikilinks).

groupn - the left-side text before list-n (if group-n omitted, list-n starts at left of box).

listn - text listing wikilinks, often separated by middot templates, such as: [<font/>[A]]{<font/>{·}} [<font/>[B]]

below - optional text to appear below the group/list section.

Further details, and complex restrictions, are explained below under section Parameter descriptions. See some alternate navbox formats under: Layout of table.

Layout of table

Table generated by {{Navbox}} without image, above and below parameters (gray list background color added for illustration only):

Table generated by {{Navbox}} with image, above and below parameters (gray list background color added for illustration only):

Table generated by {{Navbox}} with image, imageleft, lists, and without groups, above, below (gray list background color added for illustration only):

Examples

Child navboxes

It is possible to place multiple navboxes within a single border with the use of the border parameter, or by specifying the first parameter to be "child". The basic code for doing this is as follows (which adds a subgroup for the first group/list area):

{{Navbox
|name = {{subst:PAGENAME}}
|title = Title

|group1 = [optional]
|list1 = {{Navbox|child
   ...child navbox parameters...
 }}

...
}}

Subgroups example

Multiple Subgroup Example Above Group1 List1 Group2 Group2.1 List1 Group2.2 List2 Group2.3 List3 Group3 List3 Group4 Group4.1 List1 Group4.2 List2 Group4.3 List3 Below