|
|
| Line 1: |
Line 1: |
| − | {{Documentation subpage}}
| + | #REDIRECT [[wikipedia:Template:Navbox_subgroup/doc]] |
| − | {{Intricate template}}
| |
| − | <!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
| |
| − | {{Navbox suite}}
| |
| − | This template is designed to be used with {{tl|Navbox}} or other [[Wikipedia:Navigation templates|navigation template]]s that allow creating lists of links with groups headers or titles. This template allows the creation of subgroups that can be assigned to a list item within {{tl|Navbox}}. A subgroup may contain up to 20 list items.
| |
| − | | |
| − | == Blank template ==
| |
| − | <pre>
| |
| − | {{Navbox subgroup
| |
| − | | groupstyle =
| |
| − | | liststyle =
| |
| − | | |
| − | | group1 =
| |
| − | | list1 =
| |
| − | | group2 =
| |
| − | | list2 =
| |
| − | ...
| |
| − | | group20 =
| |
| − | | list20 =
| |
| − | }}
| |
| − | </pre>
| |
| − | | |
| − | == Parameters ==
| |
| − | This template employs all parameters of {{tl|Navbox}}. Please see the documentation there for more complete descriptions. In fact, the only differences between this template and {{tl|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 <code>grouppadding</code> 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 {{tl|Navbox}}.
| |
| − | | |
| − | Only the most common parameters are listed below.
| |
| − | | |
| − | === Cells ===
| |
| − | :; ''list<sub>n</sub>''
| |
| − | :: (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 ''list<sub>n</sub>'' may be preceded by a corresponding ''group<sub>n</sub>'' parameter, if provided (see below). The background color of the list items (and the entire table) defaults to <code>transparent</code>, therefore it displays the same background color used in the parent navigation box.
| |
| − | | |
| − | :; ''group<sub>n</sub>''
| |
| − | :: (i.e. ''group1'', ''group2'', ..., ''group20'') If specified, text appears in a header cell displayed to the left of ''list<sub>n</sub>''. If omitted, ''list<sub>n</sub>'' uses the full width of the table. The background color defaults to <code><span style="background:#e6e6ff; color:black;">#e6e6ff</span></code>, but can be changed via the ''groupstyle'' parameter (see below).
| |
| − | | |
| − | === Styles ===
| |
| − | :; ''bodystyle''
| |
| − | :: Specifies [[Cascading Style Sheets|CSS]] styles to apply to the template body. Examples:
| |
| − | ::: <code>background:#''nnnnnn'';</code>
| |
| − | ::: <code>text-align:[''right/center/left/justified''];</code>
| |
| − | | |
| − | :; ''groupstyle''
| |
| − | :: CSS styles to apply to the ''group<sub>n</sub>'' cells. This option overrides any styles that are applied to the entire table. Examples:
| |
| − | ::: <code>background:#''nnnnnn'';</code>
| |
| − | ::: <code>text-align:[''left/center/right''];</code>
| |
| − | ::: <code>vertical-align:[''top/middle/bottom''];</code> | |
| − | ::: <code>white-space:nowrap;</code>
| |
| − | | |
| − | :; ''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:
| |
| − | ::: <code>grouppadding = 0em 1em;</code> (1em on left/right, 0em on top/bottom)
| |
| − | ::: <code>grouppadding = 0em 0.5em 0em 1em;</code> (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 (<code>background:#''nnnnnn'';</code>) in order to achieve an alternating background color between odd and even-numbered lists.
| |
| − | | |
| − | :; ''evenodd'' <span style="font-weight:normal;"><code>[swap, even, odd, off]</code></span>
| |
| − | :: If set to <code>swap</code>, 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 to <code>even</code> or <code>odd</code> sets all rows to have that striping color. Setting to <code>off</code> disables automatic row striping. NOTE: Due to system limitations, do '''not''' use a semi-colon to close this command.
| |
| − | | |
| − | ==Setting the width of groups==
| |
| − | If multiple {{tl|Navbox subgroup}} templates are used inside of a parent {{tl|Navbox}}, it generally looks better if the width of the groups matches up. In order to do this, one must set the <code>groupwidth</code> parameter:
| |
| − | | |
| − | :<code>groupwidth = 10em</code>
| |
| − | | |
| − | An alternative way is to set the <code>groupstyle</code> parameters to contain the desired width, and the <code>liststyle</code> parameters to have width:auto (due to HTML/CSS reasons). For example, place the following code in each {{tl|Navbox subgroup}} to adjust the widths:
| |
| − | :<code>groupstyle = width:10em;</code>
| |
| − | :<code>liststyle = width:auto;</code>
| |
| − | *NOTE: For the <code>groupstyle</code> widths to work, you '''must''' set the <code>liststyle</code> width to "auto".
| |
| − | If you also use the <code>image</code> or <code>imageleft</code> parameters, then you will most likely also need to set their width manually using the <code>imagestyle</code> and <code>imageleftstyle</code> parameters.
| |
| − | | |
| − | ==Example==
| |
| − | The following is an example of ''Navbox subgroup'' used within a ''Navbox'' template.
| |
| − | | |
| − | {{Navbox
| |
| − | | state = uncollapsed
| |
| − | | name = Navbox subgroup/doc
| |
| − | | 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]]
| |
| − | }}
| |
| − | | |
| − | <pre style="overflow:scroll;">
| |
| − | {{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]]
| |
| − | }}
| |
| − | </pre>
| |
| − | | |
| − | == See also ==
| |
| − | * {{tl|Navbox}} – Basic navbox
| |
| − | * {{tl|Navbox with columns}} – Allows columns instead of groups/lists
| |
| − | * {{tl|Navbox with collapsible groups}} – Another variation.
| |
| − | * {{strikethrough|[[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 the <code>hlist</code> class.
| |
| − | * {{strikethrough|{{tl|Nowrap begin}} – The recommended format for adding bullets, pipes, or dashes between list items.}} Deprecated; use the <code>hlist</code> class.
| |
| − | * {{tl|Nobold}} – To display text at normal font-weight within a context where the default font-weight is bold, e.g. header cells in tables.
| |
| − | | |
| − | {{Navigation templates}}
| |
| − | | |
| − | <includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
| |
| − | <!--Categories-->
| |
| − | [[Category:Navigational boxes| ]]
| |
| − | [[Category:Wikipedia metatemplates|{{PAGENAME}}]]
| |
| − | }}</includeonly>
| |
