Jump to content

Template:Navbox with collapsible groups/doc

From Wikipedia, the free encyclopedia

This template produces a navigation 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

[edit]

Please remove the parameters that are left blank. The template currently supports up to 20 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}}
| title = 
| listclass = hlist
| state = {{{state|}}}
| selected = {{{selected|{{{1|}}}}}}

| above = 
| image = 

| abbr1 = 
| group1 = 
| list1 = 

| abbr2 = 
| group2 = 
| list2 = 

<!--[etc, to:]-->

| abbr20 = 
| group20 = 
| list20 = 
}}

Parameters

[edit]

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

[edit]
name
The name of the template. The name of this template, for example, is "Navbox with collapsible groups".
state [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 staten, 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

[edit]
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

[edit]
groupn
The title of each section.
listn
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 groupn blank, as the child navbox will already provide the collapsible feature.
abbrn
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 listn 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.
The collapsed/uncollapsed options can be listed on the template's page by using the {{Collapsible sections option}} template in the <noinclude> part of the page.
staten [uncollapsed, collapsed, plain, off]
The initial collapsible state of listn. Set to collapsed by default. Overridden to uncollapsed if selected equals abbrn.
imagen
An image to appear in the listn content area on the right side.
imageleftn
An image to appear in the listn content area on the left side.

Style parameters

[edit]
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 groupn parameters, all at the same time.
imagestyle
CSS style/s to apply to the image parameter. Does not get applied to the imagen parameters.
imageleftstyle
CSS style/s to apply to the imageleft parameter. Does not get applied to the imageleftn 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;
groupnstyle
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.
listnstyle
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

[edit]
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

[edit]

Basic example

[edit]
  {{Navbox with collapsible groups
  |name = University of Michigan
  |state = uncollapsed
  |title = [[University of Michigan|<span style="color:#FFD700;">The University of Michigan, Ann Arbor</span>]]
  |titlestyle = background:#00008B;color:#FFD700;
  |listclass = hlist
  |groupstyle = background:#FFD700;color:#00008B;
  |image = 
  |selected = {{{1|}}}
  
  |group1 = [[University of Michigan#Academic profile|<span style="color:#00008B;">Academics</span>]]
  |abbr1 = academics
  |list1 =
  * [[University of Michigan College of Engineering|College of Engineering]]
  * [[University of Michigan College of Literature, Science, and the Arts|College of Literature, Science and the Arts]]
  * [[Gerald R. Ford School of Public Policy]]
  * [[University of Michigan Law School|Law School]]
  * [[University of Michigan Health System|Medical School]]
  * [[Ross School of Business]]
  * [[University of Michigan School of Education|School of Education]]
  * [[University of Michigan School of Information|School of Information]]
  * [[University of Michigan School of Music, Theatre & Dance|School of Music, Theatre & Dance]]
  * [[University of Michigan School of Natural Resources and Environment|School of Natural Resources and Environment]]
  * [[University of Michigan School of Public Health|School of Public Health]]
  * [[Taubman College of Architecture and Urban Planning]]
  
  |group2 = [[Michigan Wolverines|<span style="color:#00008B;">Athletics</span>]]
  |abbr2 = athletics
  |state2 = uncollapsed
  |list2 =
  * [[Michigan Stadium]]
  * [[Crisler Arena]]
  * [[Yost Ice Arena]]
  * [[Michigan Wolverines]]
  * [[Michigan Wolverines football|Football]]
  * [[Michigan – Ohio State football rivalry|UM-OSU Rivalry]]
  * [[Little Brown Jug (American football)|Little Brown Jug]]
  * [[Paul Bunyan Trophy]]
  * [[Cold War (ice hockey)|Cold War]]
  
  |group3 = Campus
  |abbr3 = campus
  |list3 =
  * [[Angell Hall Observatory]]
  * [[Burton Memorial Tower|Burton Tower]]
  * [[The Diag]]
  * [[David M. Dennison Building|Dennison Building]]
  * [[Gerald R. Ford Presidential Library]]
  * [[Hill Auditorium]]
  * [[Lurie Tower]]
  * [[Matthaei Botanical Gardens]]
  * [[Michigan Union]]
  * [[Museums at the University of Michigan|Museums]]
  * [[Nichols Arboretum]]
  * [[University of Michigan Health System|UM Health System]]
  * [[University of Michigan Library|University Library]]
  }}

Nesting plain navboxes

[edit]

To nest a plain navbox (that is, a navbox that would be specified with the {{Navbox}} template) inside a Navbox with collapsible groups, set the listn parameter to child or subgroup. Elements of the child navbox can be specified by prepending childn_, subgroupn_, or just n_ to the parameter names (e.g. 1_list1). Child navboxes can be nested by adding an additional prefix (e.g. 1_1_list1). The basic code for doing this is as follows (which adds a subgroup for the first group/list area):

{{Navbox with collapsible groups
| name = {{subst:PAGENAME}}
| title = Title

| group1 = Group Title
| list1  = child
  | 1_title = [optional]

  | 1_group1 = [optional]
  | 1_list1  = child
    | 1_1_title = [optional]
    
    | 1_1_group1 = [optional]
    | 1_1_list1  = 
    ...list contents...
  ...
...
}}

Nesting other Navbox forms

[edit]

Other Navbox forms can be nested by including the template with the first parameter set to child. 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 this nesting can lead to a large increase in the template's post-expand include size.

Technical details

[edit]

See also

[edit]
Navigation templates comparison
Template Collapsible Image Groups Style (body)
parameter/s
{{Navbox}} collapsible Left/right of body Yes Yes
{{Navbox with collapsible groups}} collapsible Left/right of body and/or in each list Yes Yes
{{Navbox with columns}} collapsible Left/right of columns No Yes
Collapsible attributes
Type CSS classes JavaScript Collapses when Custom
initial state
Nesting
Collapsible tables mw-collapsible jQuery.makeCollapsible 2 or more autocollapse on page Yes Yes