Template:Navbox subgroup
This template employs intricate features of template syntax.
You are encouraged to familiarise yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. You can conduct experiments, and should test all major changes, in either this template's sandbox, the general template sandbox, or your user space before changing anything here. |
This template does not display in the mobile view of Wikipedia; it is desktop only. Read the documentation for an explanation. |
Navbox suite |
---|
|
Template:Navbox subgroup is deprecated. Please use Template:Navbox instead. {{Navbox subgroup}} is functionally equivalent to {{Navbox|subgroup}} , but the later is more efficient (since it doesn't use an additional template layer) and allows for more than 20 list items. |
This template was designed to be used with {{Navbox}} or other navigation templates that allow creating lists of links with groups headers or titles. This template allows for the creation of up to 20 subgroups that can be assigned to a list item within {{Navbox}}. For 20 subgroups or fewer, this template is functionally equivalent to {{Navbox|subgroup}}
, but is less efficient since it uses an additional template layer. Hence, it is recommended to use {{Navbox|subgroup}}
instead.
Blank template
{{Navbox subgroup | groupstyle = | liststyle = | group1 = | list1 = | group2 = | list2 = ... | group20 = | list20 = }}
Parameters
This template employs all parameters of {{Navbox}}. Please see the documentation there for more complete descriptions. In fact, the only differences between this template and {{Navbox}} are as follows:
- The border parameter defaults to "child"
- The group padding defaults to 0.75em on the left/right, and can only be changed with the
grouppadding
parameter. This is done to prevent the Internet Explorer box model bug from affecting the width of groups.
Everything else is exactly the same as {{Navbox}}.
Only the most common parameters are listed below.
Cells
- listn
- (i.e. list1, list2, ... list20) The body of the template, usually a list of links. Format is inline. At least one list parameter is required; each additional list is displayed in a separate row of the table. Each listn may be preceded by a corresponding groupn parameter, if provided (see below).
- groupn
- (i.e. group1, group2, ..., group20) If specified, text appears in a header cell displayed to the left of listn. If omitted, listn uses the full width of the table. The background color defaults to
#e6e6ff
, but can be changed via the groupstyle parameter (see below).
Styles
- bodystyle
- Specifies CSS styles to apply to the template body. Examples:
background:#nnnnnn;
text-align:[right/center/left/justified];
- groupstyle
- CSS styles to apply to the groupn cells. This option overrides any styles that are applied to the entire table. Examples:
background:#nnnnnn;
text-align:[left/center/right];
vertical-align:[top/middle/bottom];
white-space:nowrap;
- grouppadding
- CSS style to specify group padding. Should usually be specified using em units. It is recommended to leave this parameter alone and use the default padding. Examples:
grouppadding = 0em 1em;
(1em on left/right, 0em on top/bottom)grouppadding = 0em 0.5em 0em 1em;
(0em top, 0.5em right, 0em bottom, 1em left)
- liststyle
- CSS styles to apply to all lists. Overridden by the oddstyle and evenstyle parameters (if specified) below.
- oddstyle
- evenstyle
- CSS styles to apply to the odd-numbered list items (list1, list3, etc) or even-numbered list items (list2, list4, etc), respectively. Typically used to set background color (
background:#nnnnnn;
) in order to achieve an alternating background color between odd and even-numbered lists.
- evenodd
[swap, even, odd, off]
- If set to
swap
, then the automatic striping of even and odd rows is reversed. Normally, even rows get a light gray background for striping; when this parameter is used, the odd rows receive the gray striping instead of the even rows. Setting toeven
orodd
sets all rows to have that striping color. Setting tooff
disables automatic row striping. NOTE: Due to system limitations, do not use a semi-colon to close this command.
- evenodd
Setting the width of groups
If multiple {{Navbox subgroup}} templates are used inside of a parent {{Navbox}}, it generally looks better if the width of the groups matches up. In order to do this, one must set the groupwidth
parameter:
groupwidth = 10em
An alternative way is to set the groupstyle
parameters to contain the desired width, and the liststyle
parameters to have width:auto (due to HTML/CSS reasons). For example, place the following code in each {{Navbox subgroup}} to adjust the widths:
groupstyle = width:10em;
liststyle = width:auto;
- NOTE: For the
groupstyle
widths to work, you must set theliststyle
width to "auto".
If you also use the image
or imageleft
parameters, then you will most likely also need to set their width manually using the imagestyle
and imageleftstyle
parameters.
Example
The following is an example of Navbox subgroup used within a Navbox template.
{{Navbox | state = uncollapsed | name = Protected Areas of Colorado | title = Protected Areas of Colorado | listclass = hlist | group1 = National Park Service | list1 = {{Navbox subgroup | group1 = National Parks | list1 = *[[Black Canyon of the Gunnison National Park|Black Canyon of the Gunnison]] *[[Great Sand Dunes National Park and Preserve|Great Sand Dunes]] *[[Mesa Verde National Park|Mesa Verde]] *[[Rocky Mountain National Park|Rocky Mountain]] | group2 = National Monuments | list2 = *[[Colorado National Monument|Colorado]] *[[Florissant Fossil Beds National Monument|Florissant Fossil Beds]] *[[Hovenweep National Monument|Hovenweep]] *[[Yucca House National Monument|Yucca House]] | group3 = National Historic Sites | list3 = *[[Bent's Old Fort National Historic Site|Bent's Old Fort]] *[[Sand Creek Massacre National Historic Site|Sand Creek Massacre]] | group4 = National Recreation Area | list4 = *[[Curecanti National Recreation Area|Curecanti]] }} | group2 = National Forests | list2 = *[[Arapaho National Forest|Arapaho]] *[[Grand Mesa National Forest|Grand Mesa]] *[[Gunnison National Forest|Gunnison]] *[[Pike National Forest|Pike]] *[[Rio Grande National Forest|Rio Grande]] *[[Roosevelt National Forest|Roosevelt]] *[[Medicine Bow - Routt National Forest|Medicine Bow - Routt]] *[[San Isabel National Forest|San Isabel]] *[[San Juan National Forest|San Juan]] *[[Uncompahgre National Forest|Uncompahgre]] *[[White River National Forest|White River]] }}
See also
- {{Navbox}} – Basic navbox
- {{Navbox with columns}} – Allows columns instead of groups/lists
- {{Navbox with collapsible groups}} – Another variation.
Wikipedia:Line-break handling – The how-to guide about how to handle word wraps (line breaks) on Wikipedia, such as the wrapping of the link lists used in navboxes.Deprecated; use thehlist
class.{{Nowrap begin}} – The recommended format for adding bullets, pipes, or dashes between list items.Deprecated; use thehlist
class.- {{Nobold}} – To display text at normal font-weight within a context where the default font-weight is bold, e.g. header cells in tables.
Collapsible | Header color | Image | Groups | Style (body) parameter/s |
Examples | |
---|---|---|---|---|---|---|
{{Navbox}} | collapsible | navbox | Left/right of body | Yes | Yes | |
{{Navbox with collapsible groups}} | collapsible | navbox | Left/right of body and/or in each list | Yes | Yes |
|
{{Navbox with columns}} | collapsible | navbox | Left/right of columns | No | Yes |
Type | CSS classes | JavaScript | Collapses when | Custom initial state |
Nesting |
---|---|---|---|---|---|
Collapsible tables | collapsible | Defined in Common.js | 2 or more autocollapse on page | Yes | Yes |