Template:Navbox with collapsible groups/doc

This template produces a navigational template that has groups of relevant articles on a certain topic. All groups are hidden by default. However, with a parameter call, an individual group can be shown that has the other articles in the same group.

Usage

Please remove the parameters that are left blank. The template currently supports up to 10 groups/lists but more can be added if needed. You should use a minimum of two groups/lists; otherwise, use {{Navbox}} instead.

{{Navbox with collapsible groups
|name = {{subst:PAGENAME}}
|state = 
|selected = {{{1|}}}

|title = 
|titlestyle = 
|groupstyle = 
|image = 

|group1 = 
|abbr1 = 
|list1 =

|group2 = 
|abbr2 = 
|list2 = 

 ...

|group10 = 
|abbr10 = 
|list10 = 
}}

Parameters

This template shares many common parameters with its sister templates {{Navbox}} and {{Navbox with columns}}. The common parameters are marked with a cross^†. Please refer to the documentation of {{Navbox}} for more in depth descriptions and examples of those parameters.

Setup parameters

name^†

The name of the template. The name of this template, for example, is "Navbox with collapsible groups".

state^† [autocollapse, uncollapsed, collapsed, plain, off]

The initial state of the show/hide feature for the main title. See {{Navbox}} for more information. Does not affect display or hiding of group items, see state_n, below.

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}}, the columns of a {{Navbox with columns}}, or a list area of {{Navbox with collapsible groups}}. See {{Navbox}} for more information and examples.

Basic data parameters

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 groups/lists.

image^†

Image to the right of all of the groups/lists.

imageleft^†

Image to the left of all of the groups/lists.

below^†

Text or other elements to appear below the groups/lists.

Group/list parameters

group_n^†

The title of each section.

list_n^†

The content/wikilinks that will be shown in the group. Use dots or bullets as separators (see the See also section). A {{Navbox}} or {{Navbox with columns}} can optionally be used here with its border = child parameter set. If this is done, leave the corresponding group_n blank, as the child navbox will already provide the collapsible feature.

abbr_n

This is the abbreviation of the group. See selected parameter immediately below to see how to use this parameter. This parameter is optional, but recommended.

selected

If the value of selected equals the value of abbrn, then list_n is uncollapsed and all other lists are collapsed. If selected is left blank, or if it does not match any abbrn, then all groups are collapsed. Usually this parameter should be set to {{{1|}}}. Since this template is a base template for others, there has to be a way to pass the group parameter from the article, to the secondary template to this one.

state_n [autocollapse, uncollapsed, collapsed, plain, off]

The initial collapsible state of list_n. Set to collapsed by default. Overridden to uncollapsed if selected equals abbrn.

image_n

An image to appear in the list_n content area on the right side.

imageleft_n

An image to appear in the list_n content area on the left side.

Style parameters

bodystyle^†

CSS style/s to apply to the entire template

titlestyle^†

CSS style/s to apply to titlebar; usually background:color. The color of wikilink text must be manually changed using span tags. For example use title = [[Scouting|<span style="color:ivory;">Scouting</span>]] to change the color of the link to ivory. The [show]/[hide] button and the vde link button use the color set in the titlestyle parameter. Here is an example of setting the titlestyle:

titlestyle = background:darkgreen;color:ivory;

abovestyle^†

belowstyle^†

CSS style/s to apply to the above and below parameters, respectively.

basestyle^†

CSS style/s to apply to the title, above, below, and group_n parameters, all at the same time.

imagestyle^†

CSS style/s to apply to the image parameter. Does not get applied to the image_n parameters.

imageleftstyle^†

CSS style/s to apply to the imageleft parameter. Does not get applied to the imageleft_n parameters.

groupstyle^†

CSS style/s to apply to all group heading parameters. Visit this website to get a lighter color similar to the title background color. Example:

groupstyle = background:lightgreen;

group_nstyle^†

CSS style/s to apply to a specific group heading; overrides any CSS styles set in groupstyle.

liststyle^†

CSS style/s to apply to all list content parameters.

list_nstyle^†

CSS style/s to apply to specific list content parameters; overrides any CSS styles set in liststyle.

listpadding^†

Padding to have in each list cell; defaults to 0.25em on the left/right and 0em on the top/bottom.

Microformat parameters

bodyclass^†

This parameter is inserted into the "class" attribute for the infobox as a whole.

titleclass^†

This parameter is inserted into the "class" attribute for the infobox's title caption.

See Wikipedia:WikiProject Microformats for more information on adding microformat information to Wikipedia, and microformat for more information on microformats in general.

Examples

Basic example

{{Navbox with collapsible groups
|name = Patch-nav
|title = [[patch notes|Patches]] <small>[[:Category:Patches and updates|(Category)]]</small>
|titlestyle = background-color:#BFD7FF;
|liststyle = font-size:90%;

|group1 = [[patch notes#The Sims|The Sims]]
|group1style = background-color:#ffccaa;
|list1 = [[The Sims Deluxe Edition/patch|Deluxe Edition]] · [[The Sims: Hot Date/patch|Hot Date]] · [[The Sims: Unleashed/patch|Unleashed]]

|group2 = [[patch notes#The Sims 2|The Sims 2]]
|group2style = background-color:#ffffaa;
|list2 = [[The Sims 2/patch|The Sims 2]] · [[The Sims 2: University/patch|University]] · [[The Sims 2: Nightlife/patch|Nightlife]] · [[The Sims 2: Open for Business/patch|Open for Business]] · [[The Sims 2: Pets/patch|Pets]] · [[The Sims 2: Seasons/patch|Seasons]] · [[The Sims 2: Bon Voyage/patch|Bon Voyage]] · [[The Sims 2: FreeTime/patch|FreeTime]] · [[The Sims 2: Apartment Life/patch|Apartment Life]]

[[The Sims 2: Family Fun Stuff/patch|Family Fun Stuff]] · [[The Exchange#Patch|The Exchange]]

|group3 = [[The Sims 3/patch|The Sims 3]]
|group3style = background-color:#ccffaa;
|list3 = '''[[The Sims 3/patch|Index]]''' · [[The Sims 3/Patch 1|Patch 1]] · [[The Sims 3/Patch 2|Patch 2]] · [[The Sims 3/Patch 3|Patch 3]] · [[The Sims 3/Patch 4|Patch 4]] · [[The Sims 3/Patch 6|Patch 6]] · [[The Sims 3/Patch 7|Patch 7]] · [[The Sims 3/Patch 8|Patch 8]] · [[The Sims 3/Patch 9|Patch 9]] · [[The Sims 3/Patch 10|Patch 10]] · [[The Sims 3/Patch 11|Patch 11]] · [[The Sims 3/Patch 12|Patch 12]] · [[The Sims 3/Patch 14|Patch 14]] · [[The Sims 3/Patch 15|Patch 15]] · [[The Sims 3/Patch 17|Patch 17]] · [[The Sims 3/Patch 18|Patch 18]] · [[The Sims 3/Patch 19|Patch 19]]

[[Create a World#Download|Create a World]]
}}

Nesting other Navbox forms

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

Nesting Navboxes to get more groups/lists

You can conveniently nest Navboxes, including {{Navbox with collapsible groups}}, to get an unlimited number of groups/lists. The following example uses one instance of {{Navbox with collapsible groups}} to get the first 10 collapsible groups, a nested instance to get the next 10, and another nested instance to get the last 6. See the code to learn how it works. It is fairly simple to extend this to as many groups/lists as you like:

See also

• {{Navbox}} - Basic navbox.
• {{Navbox with columns}} - Sister template that provides columns in a navbox
• {{Navbox subgroup}} - Allows the creation of subgroups within {{Navbox}}.