قالب:Navbox subgroup/شرح

هذه هي صفحة توثيق القالب {{Navbox subgroup}}. ليس الغرض من تلك الصفحة أن تـُشاهـَد مباشرة. لو استعملـَت متغيرات, فبعض الروابط قد تظهر مكسورة. لا تستبدل تلك المتغيرات بأسماء مباشرة (hardcoded) لصفحات أو عناوين URLs.

This template is designed to be used with {{Navbox}} or other navigational templates 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 {{Navbox}}. A subgroup may contain up to 20 list items.

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 effecting the width of groups.

Everything else is exactly the same as {{Navbox}}.

Only the most common parameters are listed below.

Cells

list_n

(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_n may be preceded by a corresponding group_n parameter, if provided (see below). The background color of the list items (and the entire table) defaults to transparent, therefore it displays the same background color used in the parent navigation box.

group_n

(i.e. group1, group2, ..., group20) If specified, text appears in a header cell displayed to the left of list_n. If omitted, list_n 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 group_n 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 to even or odd sets all rows to have that striping color. Setting to off 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 {{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 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;

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.

Examples

Example 1

The following is an example of Navbox subgroup used within a Navbox template.

{{Navbox
| name   = Protected Areas of Colorado
| title  = Protected Areas of Colorado
| 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]]
}}

Example 2

This example implements horizontal group headings by assigning the headings to list1 and list3 and the links to list2 and list4), then using list1style and list3style to set the background color of the headings.

{{Navbox
| name  = Roman Emperors
| title = Roman Emperors
| group1 = Crisis 235 AD - 284 AD
| list1  = [[Maximinus Thrax]]{{·}} [[Gordian I]]{{·}} [[گورديان الثاني|Gordian II]]{{·}} [[پاپينوس|Pupienus]] and [[Balbinus]]{{·}} [[Gordian III]]{{·}} [[Philip the Arab]]{{·}} [[Decius]]{{·}} [[Trebonianus Gallus]]{{·}} [[Aemilianus]]{{·}} [[Valerian (emperor)|Valerian]]{{·}} [[Gallienus]]{{·}} [[Claudius II]]{{·}} [[Quintillus]]{{·}} [[Aurelian]]{{·}} [[Marcus Claudius Tacitus]]{{·}} [[Florianus]]{{·}} [[Probus]]{{·}} [[Carus]]{{·}} [[Numerian]]{{·}} [[Carinus]]
| group2 = Dominate
| list2  = 
  {{Navbox subgroup
   |list1style = background:#ddf;
   |list1 = '''284 AD - 395 AD'''
   |list2 = [[Diocletian]]{{·}} [[Maximian]]{{·}} [[Constantius Chlorus|Constantius I]]{{·}} [[Galerius]]{{·}} [[Flavius Valerius Severus|Severus II]]{{·}} [[Maxentius]]{{·}} [[Maximinus]]{{·}} [[Licinius]]{{·}} [[Constantine I]]{{·}} [[Constantine II (emperor)|Constantine II]]{{·}} [[Constans|Constans I]]{{·}} [[Constantius II]]{{·}} [[Julian the Apostate]]{{·}} [[Jovian]]{{·}} [[Valentinian I]]{{·}} [[Valens]]{{·}} [[كراتيان|Gratian]]{{·}} [[Valentinian II]]{{·}} [[Eugenius]]{{·}} [[Theodosius I]]
   |list3style = background:#ddf;
   |list3 = '''Western Empire (393 AD - 476 AD)'''
   |list4 = [[Honorius (emperor)|Honorius]]{{·}} [[Constantius III]]{{·}} [[Joannes]]{{·}} [[Valentinian III]]{{·}} [[Petronius Maximus]]{{·}} [[Avitus]]{{·}} [[Majorian]]{{·}} [[Libius Severus]]{{·}} [[Anthemius]]{{·}} [[Olybrius]]{{·}} [[Glycerius]]{{·}} [[Julius Nepos]]{{·}} [[Romulus Augustus]]
  }}
}}

انظر أيضاً

• {{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.
• {{Nowrap begin}} – The recommended format for adding bullets, pipes, or dashes between list items. The page describes how to go about using them with proper wrapping.
• {{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 template comparison

	collapsible	Header color†	Image	Groups	Style (body) parameter/s	Example
{{Navigation}}	NavFrame	NavHead	لا	لا	نعم	{{OPEC}}
{{Navigation with image}}	NavFrame	NavHead	Left/right of body	لا	نعم	{{HolmesNovels}}
{{Navigation with columns}}	NavFrame	NavHead	لا	لا	نعم
{{Dynamic navigation box}}	collapsible	navbox	لا	لا	نعم	{{CSUHeads}}
{{Dynamic navigation box with image}}	NavFrame	NavHead	Upper left	لا	لا	{{SlovakPMs}}
{{Navbox generic}}	collapsible	navbox	Right-hand side	نعم	نعم	{{Dilbert}}
{{NavigationBox}}	لا	navbox	Right of title+body	لا	لا	{{EPA}}
{{Commons:NavigationBox}}	لا	#ccccff	Right of title+body	لا	لا
{{Commons:Dynamic navigation box}}	NavFrame	#ccccff	لا	لا	لا
{{Commons:Dynamic navigation box with image}}	NavFrame	#ccccff	Upper left	لا	لا
† The background color for the header or title is inherited from the class listed below. The templates have titlebkg parameters that override the default.

Collapsible attributes

Type	CSS classes	Collapses when	Custom initial state	Nesting	Header color	Font size
NavFrame div	NavFrame, NavHead, NavContent	3+ of the same	لا	نعم	#ccccff	95%
Collapsible table	collapsible, navbox	2+ of the same	نعم	نعم	#ccccff	90%
For the technically minded, see Common.css and Common.js.