查看“模板:Navbox subgroup/doc”的源代码

{{tl|Navbox}}的輔助模版，支援子項目生成，現支援40個子項目生成。

可以同一行多次引用。

常用參數封裝到{{tl|大家族模板子项}}中。

使用方法見於https://zh.wikipedia.org/wiki/Template:Navbox_subgroup
<!--<includeonly>{{Esoteric}}</includeonly><noinclude>{{template doc page viewed directly}}</noinclude>
<!-- 在本行下编辑模板说明 -->
{{Navbox suite}}
本模板被设计与{{tl|Navbox}}或其他[[Wikipedia:导航模板|导航模板]]共同使用，它们允许创建带分组抬头或标题的链接列表。这个模板允许创建子分组，整个子分组能被赋值作为{{tl|Navbox}}内的一个列表项。一个子分组可以容纳最多22个列表项。
<!-- This template is designed to be used with {{tl|Navbox}} or other [[Wikipedia:Navigational templates|navigational 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 22 list items.
 -->
== 用法 ==
<pre>
{{Navbox subgroup
| groupstyle = 
| liststyle  = 

| group1 = 
| list1  = 
| group2 = 
| list2  = 
...
| group22 = 
| list22  = 
}}
</pre>

== 参数说明 ==
本模板的参数与{{tl|Navbox}}的类似。
=== 单元格 ===
:; ''list<sub>n</sub>''
::（即''list1''、''list2''、……''list22''）本模板的主体，通常是一些链接的一个列表。格式是内联（inline）。最少而言一个''list''参数是必需的。每个追加的''list''都会显示在表格的单独一行。每个''list<sub>n</sub>''可以以一个相应的''group<sub>n</sub>''参数为先导，如果提供了的话（见下方）。列表项（以及整个表格）的背景颜色缺省为<code>transparent</code>，因而它显示与父导航框所用的相同的背景色。

:; ''group<sub>n</sub>''
::（即''group1''、''group2''、……''group22''）如果指定了的话，一个抬头单元格会显示在''list<sub>n</sub>''左侧，其中显现指定的文字。如果忽略了的话，''list<sub>n</sub>''会占用表格的全部宽度。背景颜色缺省为<code><span style="background:#ddf; color:black;">#ddf</span></code>，但是能够通过''groupstyle''参数进行更改（见下方）。
<!-- 
:; ''list<sub>n</sub>''
::  (i.e. ''list1'', ''list2'', ... ''list22'') 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'', ..., ''group22'') 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).
 -->
=== 样式 ===
:; ''bodystyle''
::指定[[CSS]]样式，应用于模板主体。例如：
::: <code>background:#''nnnnnn'';</code>
::: <code>text-align:[''right/center/left/justified''];</code>

:; ''groupstyle''
::CSS样式，应用于''group<sub>n</sub>''单元格。这个选项优先于任何应用到整个表格的样式。例如：
::: <code>background:#''nnnnnn'';</code>
::: <code>text-align:[''left/center/right''];</code>
::: <code>vertical-align:[''top/middle/bottom''];</code>
::: <code>white-space:nowrap;</code>

:; ''liststyle''
::CSS样式，应用于所有列表项。如果指定了''oddstyle''和''evenstyle''参数的话（见下方），则会覆盖本参数。

:; ''oddstyle''
:; ''evenstyle''
::CSS样式，分别应用于奇数编号列表项（''list1''、''list3''等等）或偶数编号列表项（''list2''、''list4''等等）。典型地被用来设定背景颜色（<code>background:#nnnnnn;</code>），以达到在奇数和偶数编号列表之间实现一个交互的背景颜色。
<!-- 
:; ''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. 
 -->
== 设置分组的宽度 ==
若有多个{{tl|Navbox subgroup}}模板被用在父级{{tl|Navbox}}的内部，如果这些分组的宽度比较协调的话，通常看起来会更美观，为了做到这一点，使用者必须设定<code>groupstyle</code>参数来控制想要的宽度，以及设定<code>liststyle</code>参数来获得width:auto（由于HTML/CSS的原因）。例如，放置以下代码到每个{{tl|Navbox subgroup}}中来调整宽度：
:<code>groupstyle = width:10em;</code>
:<code>liststyle = width:auto;</code>
<!-- 
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>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>

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.
-->

== 举例 ==
=== 例1 ===
下面是一个在''Navbox''模板内部使用''Navbox subgroup''的示例。
<!-- 
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
| group1 = National Park Service
| list1  =
  {{Navbox subgroup
  | group1 = National Parks
  | list1  = [[Black Canyon of the Gunnison National Park|Black Canyon of the Gunnison]]{{w}}[[Great Sand Dunes National Park and Preserve|Great Sand Dunes]]{{w}}[[Mesa Verde National Park|Mesa Verde]]{{w}}[[Rocky Mountain National Park|Rocky Mountain]]
  | group2 = National Monuments
  | list2  = [[Colorado National Monument|Colorado]]{{w}}[[Florissant Fossil Beds National Monument|Florissant Fossil Beds]]{{w}}[[Hovenweep National Monument|Hovenweep]]{{w}}[[Yucca House National Monument|Yucca House]]
  | group3 = National Historic Sites
  | list3  = [[Bent's Old Fort National Historic Site|Bent's Old Fort]]{{w}}[[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]]{{w}}[[Grand Mesa National Forest|Grand Mesa]]{{w}}[[Gunnison National Forest|Gunnison]]{{w}}[[Pike National Forest|Pike]]{{w}}[[Rio Grande National Forest|Rio Grande]]{{w}}[[Roosevelt National Forest|Roosevelt]]{{w}}[[Medicine Bow - Routt National Forest|Medicine Bow - Routt]]{{w}}[[San Isabel National Forest|San Isabel]]{{w}}[[San Juan National Forest|San Juan]]{{w}}[[Uncompahgre National Forest|Uncompahgre]]{{w}}[[White River National Forest|White River]]
}}

<pre style="overflow:scroll;">
{{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]]{{w}}[[Great Sand Dunes National Park and Preserve|Great Sand Dunes]]{{w}}[[Mesa Verde National Park|Mesa Verde]]{{w}}[[Rocky Mountain National Park|Rocky Mountain]]
   |group2 = National Monuments
   |list2  = [[Colorado National Monument|Colorado]]{{w}}[[Florissant Fossil Beds National Monument|Florissant Fossil Beds]]{{w}}[[Hovenweep National Monument|Hovenweep]]{{w}}[[Yucca House National Monument|Yucca House]]
   |group3 = National Historic Sites
   |list3  = [[Bent's Old Fort National Historic Site|Bent's Old Fort]]{{w}}[[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]]{{w}}[[Grand Mesa National Forest|Grand Mesa]]{{w}}[[Gunnison National Forest|Gunnison]]{{w}}[[Pike National Forest|Pike]]{{w}}[[Rio Grande National Forest|Rio Grande]]{{w}}[[Roosevelt National Forest|Roosevelt]]{{w}}[[Medicine Bow - Routt National Forest|Medicine Bow - Routt]]{{w}}[[San Isabel National Forest|San Isabel]]{{w}}[[San Juan National Forest|San Juan]]{{w}}[[Uncompahgre National Forest|Uncompahgre]]{{w}}[[White River National Forest|White River]]
}}
</pre>

=== 例2 ===
这个示例实现了水平分组标题，方法是将标题分配到<code>list1</code>和<code>list3</code>，将链接分配到<code>list2</code>和<code>list4</code>，然后使用<code>list1style</code>和<code>list3style</code>来设定标题的背景颜色。
<!-- 
This example implements horizontal group headings by assigning the headings to <code>list1</code> and <code>list3</code> and the links to <code>list2</code> and <code>list4</code>), then using <code>list1style</code> and <code>list3style</code> to set the background color of the headings.
-->
{{Navbox
| state = expanded
| name  = Roman Emperors
| title = Roman Emperors
| group1 = Crisis 235 AD - 284 AD
| list1  = [[Maximinus Thrax]]{{w}}[[Gordian I]]{{w}}[[Gordian II]]{{w}}[[Pupienus]] and [[Balbinus]]{{w}}[[Gordian III]]{{w}}[[Philip the Arab]]{{w}}[[Decius]]{{w}}[[Trebonianus Gallus]]{{w}}[[Aemilianus]]{{w}}[[Valerian (emperor)|Valerian]]{{w}}[[Gallienus]]{{w}}[[Claudius II]]{{w}}[[Quintillus]]{{w}}[[Aurelian]]{{w}}[[Marcus Claudius Tacitus]]{{w}}[[Florianus]]{{w}}[[Probus]]{{w}}[[Carus]]{{w}}[[Numerian]]{{w}}[[Carinus]]
| group2 = Dominate
| list2  = 
  {{Navbox subgroup
   |list1style = background:#ddf;
   |list1 = '''284 AD - 395 AD'''
   |list2 = [[Diocletian]]{{w}}[[Maximian]]{{w}}[[Constantius Chlorus|Constantius I]]{{w}}[[Galerius]]{{w}}[[Flavius Valerius Severus|Severus II]]{{w}}[[Maxentius]]{{w}}[[Maximinus]]{{w}}[[Licinius]]{{w}}[[Constantine I]]{{w}}[[Constantine II (emperor)|Constantine II]]{{w}}[[Constans|Constans I]]{{w}}[[Constantius II]]{{w}}[[Julian the Apostate]]{{w}}[[Jovian]]{{w}}[[Valentinian I]]{{w}}[[Valens]]{{w}}[[Gratian]]{{w}}[[Valentinian II]]{{w}}[[Eugenius]]{{w}}[[Theodosius I]]
   |list3style = background:#ddf;
   |list3 = '''Western Empire (393 AD - 476 AD)'''
   |list4 = [[Honorius (emperor)|Honorius]]{{w}}[[Constantius III]]{{w}}[[Joannes]]{{w}}[[Valentinian III]]{{w}}[[Petronius Maximus]]{{w}}[[Avitus]]{{w}}[[Majorian]]{{w}}[[Libius Severus]]{{w}}[[Anthemius]]{{w}}[[Olybrius]]{{w}}[[Glycerius]]{{w}}[[Julius Nepos]]{{w}}[[Romulus Augustus]]
  }}
}}

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

== 參見 ==

* {{tl|Navbox}} &ndash; 基本的导航模板。
* {{tl|Navbox with columns}} &ndash; 允许分列（columns）代替分组/列表（groups/lists）。
* {{tl|Navbox with collapsible groups}} &ndash; 另一个变体。
* {{tl|Nobold}} &ndash; 用于在缺省字体宽度是粗体的上下文环境中，例如表格中的标题单元格中，用普通字体宽度来显示文字。

<includeonly>
<!-- 本行下加入模板的分类 -->
[[Category:導航模板|{{PAGENAME}}]]
[[Category:格式模板|{{PAGENAME}}]]

</includeonly>
<includeonly>
<!-- 本行下加入模板的分类 -->
[[Category:格式模板]][[Category:导航模板]]
</includeonly>
<noinclude>[[Category:模板说明文件]]</noinclude>