View source for Template:Navbox with collapsible groups/doc

This template produces a [[Wikipedia:Navigational templates|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 {{t|Navbox}} instead.

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

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

|group1 = 
|abbr1 = 
|list1 =

|group2 = 
|abbr2 = 
|list2 = 

 ...

|group10 = 
|abbr10 = 
|list10 = 
}}</pre>

== Parameters ==
This template shares many common parameters with its sister templates {{t|Navbox}} and {{t|Navbox with columns}}.  The common parameters are marked with a cross<sup>'''†'''</sup>.  Please refer to the documentation of {{t|Navbox}} for more in depth descriptions and examples of those parameters.

=== Setup parameters ===
:;name<sup>†</sup>
::The name of the template. The name of this template, for example, is "Navbox with collapsible groups".

:; ''state''<sup>†</sup> <span style="font-weight:normal;">[<code>autocollapse, uncollapsed, collapsed, plain, off</code>]</span>
::The initial state of the show/hide feature for the main title.  See {{t|Navbox}} for more information.  Does not affect display or hiding of group items, see ''state<sub>n</sub>'', below.

:;''navbar''<sup>†</sup>
::Possible values are <code>plain</code>, <code>off</code>, and the default value of blank.  See {{t|Navbox}} for more information.

:;''border''<sup>†</sup>
::Possible values are <code>child</code>, <code>none</code>, and the default value of blank.  Set to <code>child</code> 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 {{t|Navbox}}, the columns of a {{t|Navbox with columns}}, or a list area of {{t|Navbox with collapsible groups}}.  See {{t|Navbox}} for more information and examples.

=== Basic data parameters ===
:;'''''title'''''<sup>†</sup>
::The title of the template, displayed centered in the titlebar at the top of the template.

:;''above''<sup>†</sup>
::Text or other elements to appear above groups/lists.

:;''image''<sup>†</sup>
::Image to the right of all of the groups/lists.

:;''imageleft''<sup>†</sup>
::Image to the left of all of the groups/lists.

:;''below''<sup>†</sup>
::Text or other elements to appear below the groups/lists.

=== Group/list parameters ===
:; ''group<sub>n</sub>''<sup>†</sup>
:: The title of each section.

:; ''list<sub>n</sub>''<sup>†</sup>
:: The content/wikilinks that will be shown in the group. Use dots or bullets as separators (see the [[#See also|See also]] section).  A {{t|Navbox}} or {{t|Navbox with columns}} can optionally be used here with its <code>border = child</code> parameter set.  If this is done, leave the corresponding group<sub>n</sub> blank, as the child navbox will already provide the collapsible feature.

:; ''abbr<sub>n</sub>''
:: This is the abbreviation of the group.  See <code>selected</code> parameter below to see how to use this parameter.  This parameter is optional, but recommended.

:; ''selected''
:: If the value of <code>selected</code> equals the value of <code>abbr<sub>n</sub></code>, then list<sub>n</sub> is uncollapsed and all other lists are collapsed.  If <code>selected</code> is left blank, or if it does not match any <code>abbr<sub>n</sub></code>, then all groups are collapsed.  Usually this parameter should be set to <tt><nowiki>{{{1|}}}</nowiki></tt>. 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<sub>n</sub>'' <span style="font-weight:normal;">[<code>autocollapse, uncollapsed, collapsed, plain, off</code>]</span>
:: The initial collapsible state of list<sub>n</sub>.  Set to collapsed by default.  Overridden to uncollapsed if <code>selected</code> equals <code>abbr<sub>n</sub></code>.

:; ''image<sub>n</sub>''
:: An image to appear in the list<sub>n</sub> content area on the right side.

:; ''imageleft<sub>n</sub>''
:: An image to appear in the list<sub>n</sub> content area on the left side.

=== Style parameters ===
:;''bodystyle''<sup>†</sup>
::CSS style/s to apply to the entire template

:;''titlestyle''<sup>†</sup>
::[[Wikipedia:CSS|CSS]] style/s to apply to titlebar; usually <code>background:''color''</code>.  The color of wikilink text must be manually changed using span tags.  For example use <code><nowiki>title = [[Scouting|<span style="color:ivory;">Scouting</span>]]</nowiki></code> 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:
:::<code>titlestyle = background:darkgreen;color:ivory;</code>

:;''abovestyle''<sup>†</sup>
:;''belowstyle''<sup>†</sup>
::CSS style/s to apply to the ''above'' and ''below'' parameters, respectively.

:;''basestyle''<sup>†</sup>
::CSS style/s to apply to the ''title'', ''above'', ''below'', and ''group<sub>n</sub>'' parameters, all at the same time.

:;''imagestyle''<sup>†</sup>
::CSS style/s to apply to the ''image'' parameter.  Does not get applied to the image<sub>n</sub> parameters.

:;''imageleftstyle''<sup>†</sup>
::CSS style/s to apply to the ''imageleft'' parameter.  Does not get applied to the imageleft<sub>n</sub> parameters.

:; ''groupstyle''<sup>†</sup>
:: CSS style/s to apply to all group heading parameters.  Visit [http://meyerweb.com/eric/tools/color-blend/ this website] to get a lighter color similar to the title background color. Example:
:::<code>groupstyle = background:lightgreen;</code>

:; ''group<sub>n</sub>''style<sup>†</sup>
:: CSS style/s to apply to a specific group heading; overrides any CSS styles set in ''groupstyle''.

:; ''liststyle''<sup>†</sup>
:: CSS style/s to apply to all list content parameters.

:; ''list<sub>n</sub>''style<sup>†</sup>
:: CSS style/s to apply to specific list content parameters; overrides any CSS styles set in ''liststyle''.

:; ''listpadding''<sup>†</sup>
:: Padding to have in each list cell; defaults to 0.25em on the left/right and 0em on the top/bottom.

== Examples ==
=== Basic example ===
<pre style="overflow:scroll;">
{{Navbox with collapsible groups
|name = University of Michigan
|title = <span style="color:#FFD700;">The University of Michigan, Ann Arbor</span>
|titlestyle = background:#00008B;color:#FFD700;
|groupstyle = background:#FFD700;color:#00008B;
|image = 
|selected = {{{1|}}}
|state = collapsed

|group1 = <span style="color:#00008B;">Academics</span>
|abbr1 = academics
|list1 = College of Engineering{{·}} College of Literature, Science and the Arts{{·}} Gerald R. Ford School of Public Policy{{·}} Law School{{·}} Medical School{{·}} Ross School of Business{{·}} School of Education{{·}} School of Information{{·}} School of Music, Theatre & Dance{{·}}School of Natural Resources and Environment{{·}} School of Public Health{{·}} Taubman College of Architecture and Urban Planning

|group2 = [[Michigan Wolverines|<span style="color:#00008B;">Athletics</span>]]
|abbr2 = athletics
|list2 = Michigan Stadium{{·}} Crisler Arena{{·}} Yost Ice Arena{{·}} Michigan Wolverines{{·}} Football{{·}} UM-OSU Rivalry{{·}} Little Brown Jug{{·}} Paul Bunyan Trophy{{·}} Cold War

|group3 = Campus
|abbr3 = campus
|list3 = Angell Hall Observatory{{·}} Burton Tower{{·}} The Diag{{·}} Dennison Building{{·}} Gerald R. Ford Presidential Library{{·}} Hill Auditorium{{·}} Lurie Tower{{·}} Matthaei Botanical Gardens{{·}} Michigan Union{{·}} Museums{{·}} Nichols Arboretum{{·}} UM Health System{{·}} University Library

}}
</pre>
{{Navbox with collapsible groups
|name = University of Michigan
|state = uncollapsed
|title = <span style="color:#FFD700;">The University of Michigan, Ann Arbor</span>
|titlestyle = background:#00008B;color:#FFD700;
|groupstyle = background:#FFD700;color:#00008B;
|image = 
|selected = {{{1|}}}

|group1 = <span style="color:#00008B;">Academics</span>
|abbr1 = academics
|list1 = College of Engineering{{·}} College of Literature, Science and the Arts{{·}} Gerald R. Ford School of Public Policy{{·}} Law School{{·}} Medical School{{·}} Ross School of Business{{·}} School of Education{{·}} School of Information{{·}} School of Music, Theatre & Dance{{·}}School of Natural Resources and Environment{{·}} School of Public Health{{·}} Taubman College of Architecture and Urban Planning

|group2 = <span style="color:#00008B;">Athletics</span>
|abbr2 = athletics
|list2 = Michigan Stadium{{·}} Crisler Arena{{·}} Yost Ice Arena{{·}} Michigan Wolverines{{·}} Football{{·}} UM-OSU Rivalry{{·}} Little Brown Jug{{·}} Paul Bunyan Trophy{{·}} Cold War

|group3 = Campus
|abbr3 = campus
|list3 = Angell Hall Observatory{{·}} Burton Tower{{·}} The Diag{{·}} Dennison Building{{·}} Gerald R. Ford Presidential Library{{·}} Hill Auditorium{{·}} Lurie Tower{{·}} Matthaei Botanical Gardens{{·}} Michigan Union{{·}} Museums{{·}} Nichols Arboretum{{·}} UM Health System{{·}} University Library

}}

=== Nesting other Navbox forms ===
This example shows {{t|Navbox}}, {{t|Navbox with collapsible groups}} and {{t|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 <code>child</code>
{{Navbox with collapsible groups
|name = Navbox with collapsible groups
|title = Navbox, Navbox with columns, and Navbox with collapsible groups together
|selected = {{{1|}}}

|group1 = The Scouting Movement
|abbr1  = movement
|list1  = Scouting{{·}}''Scouting for Boys''{{·}}Scout method{{·}}Scout Law{{·}}Scout Promise{{·}}Scout Motto{{·}}Wood Badge{{·}}Age groups in Scouting and Guiding{{·}}Cub Scout{{·}}Boy Scout{{·}}Rover Scout{{·}}Brownie{{·}}Girl Guiding and Girl Scouting{{·}}Ranger (Girl Guide){{·}}Jamboree{{·}}Scout Leader{{·}}WOSM{{·}}WAGGGS{{·}}Non-aligned organisations{{·}}Scouting controversy and conflict{{·}}Scouting in popular culture{{·}}List of Scouts{{·}}List of highest awards in Scouting

|list2 = {{Navbox|child
|title      = [[French colonial empires|Former French colonies]] in [[Africa]] and the [[Indian Ocean]]
|state      = {{#ifeq:{{{1|}}}|french|uncollapsed|collapsed}}
|titlestyle = background#
|groupstyle = background:lavender;

|group1 = Mahgreb
|list1  = Algeria{{·}} Morocco&nbsp;<small>(Arguin Island)</small>{{·}} Tunisia

|group2 = French West Africa
|list2  = Côte d'Ivoire{{·}} Dahomey{{·}} French Sudan{{·}} Guinea{{·}} Mauritania{{·}} Niger{{·}} Senegal{{·}} Upper Volta

|group3 = &nbsp;
|list3  = French Togoland{{·}} James Island

|group4 = French Equatorial Africa
|list4  = Chad{{·}} Gabon{{·}} Middle Congo{{·}} Oubangui-Chari

|group5 = Comoros
|list5  = Anjouan{{·}} Grande Comore{{·}} Mohéli

|group6 = &nbsp;
|list6  = French Somaliland (Djibouti){{·}} Madagascar{{·}} Ile de France{{·}} Seychelles
}}

|group3 = Scouting in the United Kingdom
|abbr3 = Scouting
|list3 = The Scout Association{{·}}Girlguiding UK{{·}}Beaver Scouts{{·}}Cub Section (UK){{·}}Venture Scout{{·}}Explorer Scouts{{·}}Brownie (Girl Guides){{·}}Ranger (Girl Guide){{·}}Rainbow (Girl Guides){{·}}Scout Network{{·}}Chief Scout (United Kingdom){{·}}Scout Counties{{·}}Scout District{{·}}Scout Section (UK){{·}}Scout Activity Centre{{·}}Young Leaders

|list4 = {{Navbox with columns|child
|state = {{#ifeq:{{{1|}}}|coltest|uncollapsed|collapsed}}
|title = Navbox with columns nested in itself
|colstyle = text-align:center;

|col1width = 33%
|col2width = 17%
|col3width = 33%
|col4width = 17%

|col1header = Col1Header
|col2header = Col2Header
|col3header = Col3Header
|col4header = Col4Header

|col1 = {{Navbox with columns|child
  |colwidth = 50%
  |colstyle = text-align:center;

  |col1header = Col1.1Header
  |col2header = Col1.2Header

  |col1 = Col1.1
  |col2 = Col1.2
 }}

|col2 = Col2

|col3 = {{Navbox with columns|child
  |colwidth = 33%
  |colstyle = text-align:center;

  |col1header = Col3.1Header
  |col2header = Col3.2Header
  |col3header = Col3.3Header

  |col1 = Col3.1
  |col2 = Col3.2
  |col3 = Col3.3
 }}

|col4 = Col4
}}

}}

<includeonly>
</includeonly>