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

<noinclude>{{萌娘百科}}</noinclude>
<includeonly>{{复杂模板}}</includeonly>
<!-- 在本行下编辑模板说明 -->
{{Template:High-risk|56000+}}

使用此模板可以相对方便和快速地归纳同类型条目去创作一个导航模版（这里指的是[[:分类:大家族模板]]）。

可变参数十分多，可以配合{{tl|Navbox subgroup}}、{{tl|Navbox with columns}}、{{tl|Navbox with collapsible groups}}使用。

==常用参数==
; <kbd>name</kbd>
: 模板的名称（“Template:”后面的部分，注意不是模板的标题），像：“萌属性”。
; <kbd>title</kbd>
: 标题栏的文字，像：“[[萌]] • [[萌属性|属性&萌属性]]”，不一定与<code>name</code>相同。
; <kbd>state</kbd>
: <code>[mw-uncollapsed, mw-collapsed]</code>
: 方框的折叠状态。
; <kbd>titlestyle</kbd>、<kbd>groupstyle</kbd>、<kbd>evenstyle</kbd>
: 分别用于标题栏、group、偶数list（这部分默认是淡绿色）的CSS样式，像：<code>background:gray</code>
; <kbd>above</kbd>
: 在group/list区段之上显示的内容。
; <kbd>group<sub>n</sub></kbd>
: 左侧的文字，在list<sub>n</sub>之前（如果group<sub>n</sub>被省略，list<sub>n</sub>从方框的左侧开始）。
; <kbd>list<sub>n</sub></kbd>
: 列出维基链接的文字，通常以圆点符号分隔，像：<nowiki>[[A]] • [[B]] • …</nowiki>
; <kbd>below</kbd>
: 在group/list区段之下显示的可选文字。

{{Hide|包含常见参数的源代码，可复制后用于快速创建大家族模板|
不使用的参数请删掉，勿保留。
<pre>
{{Navbox
|name  = {{subst:PAGENAME}}
|title = 
|state = 
|titlestyle= background:
|groupstyle= background:
|evenstyle = background:

|above = 

|group1= 
|list1 = [[]] • <!--
      -->[[]]

|group2= 
|list2 = [[]] • <!--
      -->[[]]

|group3= 
|list3 = [[]] • <!--
      -->[[]]

|group4= 
|list4 = [[]] • <!--
      -->[[]]

|group5= 
|list5 = [[]] • <!--
      -->[[]]

|group6= 
|list6 = [[]] • <!--
      -->[[]]

|below = 
}}
</pre>}}
----
Navbox其他大部分参数都不常用，所以将常用参数封装成两个简化模版：{{tl|大家族}}（{{tl|大家族模板}}）和{{tl|大家族内容行}}（{{tl|Links}}）。

一些常用参数的效果参见[[#表格的布局]]、[[#示例]]；进一步的细节，以及复杂的约束，在下方[[#参数描述]]章节作了解释。

==参数描述==
下面是用于{{tl|Navbox}}的参数的一个完整清单。在大多数情况下，只要有参数<code>name</code>、<code>title</code>和<code>list1</code>就可以了，尽管[[#子导航框|子导航框]]甚至不需要设置那些参数。

{{tl|Navbox}}与它的姊妹模板{{tl|Navbox with columns}}、{{tl|Navbox with collapsible groups}}共用很多常用的参数，以提高一致性与易用性。带一个“<kbd style="font-weight:bold"><sup>†</sup></kbd>”标记的参数适用于所有这三个主模板。

=== 设置参数 ===
; <kbd>name<sup>†</sup></kbd>
: 模板的名称。为了在所有使用了所生成模板的页面上，“查 • 论 • 编”链接都能正确地工作，就需要设置这个参数。你可以输入<code><nowiki>{{subst:PAGENAME}}</nowiki></code>作为这个参数的值，这也是个快捷的方法。此参数是必需的。<!-- 仅当<code>title</code>被指定，且<code>border</code>参数未被设置时，此name参数才是必需的。 -->

; <kbd>state<sup>†</sup></kbd>
: <code>[mw-uncollapsed, mw-collapsed, plain, off]</code>
<!--:*缺省为<code>autocollapse</code>。如果在使用了其它可折叠表格的同一个页面上有两个或更多表格，那么该页面上的带<code>autocollapse</code>的导航框一开始就会折叠起来。否则，该导航框会被展开。要了解技术上的实现，请参见[[MediaWiki:Common.js]]。-->
:* 如果设置为<code>mw-collapsed</code>，该导航框总会在开始时以折叠起来的状态展现。
:* 如果设置为<code>plain</code>，该导航框总会在被展开时不带右侧的“隐藏”链接，并且标题会保持居中（通过使用补白来偏移“查 • 论 • 编”链接）。
:* 如果设置为<code>off</code>，该导航框总会在被展开时不带右侧的“隐藏”链接，但是没有补白会被用来保持标题居中。这只是为了高级用法；“plain”选项应能满足大多数需要将“显示”/“隐藏”按钮隐藏起来的应用。
:* 如果设置为除<code>mw-collapsed</code>、<code>plain</code>或<code>off</code>之外的其它值（像“mw-uncollapsed”），该导航框总会在开始时以展开的状态出现，但是带有“隐藏”按钮。
<!--:若要在独处（未被包含）时显示框体，而在一个条目中时自动隐藏内容，可以将 “uncollapsed ”置于<noinclude>标签之内：
:* <code>state = </code><nowiki><noinclude>uncollapsed</noinclude></nowiki>
:* 如此设置会强制框体在单独出现时（甚至是后面有其它导航框时）展开，显示“隐藏”按钮，而当被堆叠在一个条目中时自动折叠框体。-->
: 很多时候，对于一个导航框，编辑者会想要一个缺省的初始状态，并且在条目中它可以被覆写。要做到这一点，这里有个窍门：
: 在你的模板里，创建一个参数也命名为“state”作为一个传递，像这样：
:* <code><nowiki>|state = {{{state<includeonly>|你想要的初始状态</includeonly>}}}</nowiki></code>
:* <code><nowiki><includeonly>|</nowiki></code>会使得当查看模板页面本身时，模板会被展开。
<!--:* 示例：<nowiki>{{</nowiki>[[Template:土星的卫星|土星的卫星]]<nowiki>}}</nowiki>带autocollapse作为其缺省的初始状态。条目[[土卫三十五]]嵌入包含了它，并且只有一个导航框架。因此该页面的“土星的卫星”导航框显示了出来。条目[[土卫一]]有两个导航框。因此该页面的“土星的卫星”导航框折叠了起来。另外，也可以在条目中使用带state参数的引用形式（如<nowiki>{{土星的卫星|state=collapsed}}</nowiki>）来覆写其折叠状态。
::*示例：<nowiki>{{</nowiki>[[Template:阿拉伯语言|阿拉伯语言]]<nowiki>}}</nowiki>带expanded作为其缺省的初始状态。所有嵌入包含它的条目缺省情况下会显示其内容，除非有一个假定的条目在嵌入包含它时指定了state = collapsed。-->

; <kbd>navbar<sup>†</sup><kbd>
: 缺省为<code>Navbar</code>。如果设置为<code>plain</code>，在标题栏左侧的<small>查 • 论 • 编</small>链接不会显示出来，而且补白会被自动应用以保持标题居中。设置为<code>off</code>可以移除<small>查 • 论 • 编</small>链接，但是不会应用补白（这只是为了高级用法；“plain”选项应能满足大多数不想要导航栏的应用。）强烈建议使用者不要隐藏导航栏，为的是使用户编辑该模板更加容易，并且可以贯穿各个页面都有一个标准的风格。

; <kbd>border<sup>†</sup></kbd>
: <code>[subgroup, child, none]</code>
: 如果设置为以上三个值，导航框都将没有边框，不过使用上还是有些许差别的。详见[[#子导航框]]。

; <kbd>class</kbd>
: 为Navbox主体table元素设置class

=== 单元格 ===
; <kbd>title<sup>†</sup><kbd>
: 显示在表格顶端一行居中位置的文字。它通常是该模板的主题，也就是主体内容的一个简要描述。这应该是单独的一行，但是如果需要第二行，请使用<code><nowiki>{{brClear}}</nowiki></code>来保证正确的居中。本参数从技术上来说不是必需的，但是使用{{tl|Navbox}}而不带标题是相当没有意义的。

; <kbd>group<sub>n</sub><sup>†</sup><kbd>
: （即''group1''、''group2''等等）如果被指定，文字会显示在位于''list<sub>n</sub>''左侧的抬头单元格中。如果被省略，''list<sub>n</sub>''占用表格的全部宽度。

; <kbd>list<sub>n</sub><sup>†</sup><kbd>
: （即''list1''、''list2''等等）该模板的主体，通常为一栏链接。格式为内联；然而，如果整个列表被装入<code><nowiki><div> </div></nowiki></code>之内，文字能够被输入到不同的行中。最少需要一个''list''参数；每个附加的''list''被显示在一个单独的表格行中。每个''list<sub>n</sub>''可能在其前面有一个相对应的''group<sub>n</sub>''参数，如果提供了的话（参见下方）。

; <kbd>image<sup>†</sup><kbd>
: 一张图片，会显示在标题（title）之下、主体（group/list）之右侧的一个单元格中。为使图片能正确地显示，必须指定''list1''参数。''image''参数接受标准的维基代码来显示图片，即：
:: <code><nowiki>image = [[File:Example.jpg|100px]]</nowiki></code>（参见[[Help:图像]]）

; <kbd>imageleft<sup>†</sup><kbd>
: 一张图片，会显示在标题（title）之下、主体（list）之左侧的一个单元格中。为使图片能正确地显示，必须指定''list1''参数，而且不能指定分组（group）。''imageleft''参数接受标准的维基代码来显示图片，即：
:: <code><nowiki>imageleft = [[File:Example.jpg|100px]]</nowiki></code>

; <kbd>above<sup>†</sup><kbd>
: 一个全宽度单元格，显示在标题栏与第一个group/list之间，也就是位于该模板的主体（group、list和image）之上。在一个不带图片的模板中，''above''与不带''group1''参数的''list1''参数以同样的方式运作。

; <kbd>below<sup>†</sup><kbd>
: 一个全宽度单元格，显示在该模板主体（group、list和image）的下方。在一个不带图片的模板中，''below''与该模板最后面的不带''group<sub>n</sub>''参数的''list<sub>n</sub>''参数以同样的方式运作。作为一个使用了''below''参数的示例，请参见{{tl|非洲}}。

=== 样式参数 ===
; <kbd>style<sup>†</sup><kbd>
: 指定应用到模板主体的CSS样式。''bodystyle''参数也有下面举例的同样效果，并能被用来代替这个''style''参数。此选项应谨慎使用，因为它可以导致视觉上的不一致。举例：
:* <code>style = background:#''nnnnnn'';</code>
:* <code>style = width:''N'' [em/%/px or width:auto];</code>
:* <code>style = float:[''left/right/none''];</code>
:* <code>style = clear:[''right/left/both/none''];</code>

; <kbd>titlestyle<sup>†</sup><kbd>
: 应用到''title''的CSS样式，最常见的有导航栏的背景颜色：
:* <code>titlestyle = background:''#nnnnnn'';</code>
:* <code>titlestyle = background:''name'';</code>

; <kbd>groupstyle<sup>†</sup><kbd>
: 应用到所有''group''单元格的CSS样式。该选项覆写应用于整个表格的任何样式。举例：
:* <code>groupstyle = background:#''nnnnnn'';</code>
:* <code>groupstyle = text-align:[''left/center/right''];</code>
:* <code>groupstyle = vertical-align:[''top/middle/bottom''];</code>

; <kbd>group<sub>n</sub>style<sup>†</sup></kbd>
: 应用到特定''groupN''的CSS样式。拥有最高的显示优先级，可以分别指定不同的group显示不同效果。

; <kbd>liststyle<sup>†</sup></kbd>
: 应用到所有''list''的CSS样式。若指定了下面的list<sub>n</sub>style、''oddstyle''或''evenstyle''参数，则它们的优先级高于本参数。

; <kbd>list<sub>n</sub>style<sup>†</sup></kbd>
: 应用到特定''listN''的CSS样式。拥有最高的显示优先级，可以分别指定不同的list显示不同效果。

; <kbd>oddstyle</kbd>、<kbd>evenstyle</kbd>
: 应用到奇数/偶数编号的列表。会推翻由<code>liststyle</code>定义的样式。缺省的表现是分别添加条纹状的颜色（白色和灰色）到奇数/偶数行，以提高可读性。除了在非常特别的情况下，这些设置不应更改。

; <kbd>evenodd</kbd>
: <code>[swap, even, odd]</code>
: 设置为<code>swap</code>可使每个list奇偶翻转；可用于解决插入子导航框后奇偶样式错位的问题。
: 设置为<code>even</code>或<code>odd</code>可使所有list的样式全为偶数行或奇数行的样式。

; <kbd>abovestyle<sup>†</sup></kbd>、<kbd>belowstyle<sup>†</sup></kbd>
: 应用到顶端单元格（通过''above''参数指定）和底端单元格（通过''below''参数指定）。典型地被用来设置背景颜色或文本对齐方式：
:* <code>abovestyle = background:#''nnnnnn'';</code>
:* <code>abovestyle = text-align:''left/center/right'';</code>
<!-- 中文模板目前不支持以下参数。2008-10-29
; <kbd>imagestyle<sup>†</sup></kbd>
; <kbd>imageleftstyle<sup>†</sup></kbd>
-->
===== 缺省样式 =====
这里列出的样式设置是使用导航框的编辑者最经常更改的那些设置。其它更加复杂的样式设置被排除在这个列表之外，以保持它简单。大多数样式是在[[MediaWiki:Common.css]]中设置。
<dl><dd><pre>
bodystyle  = background:#fdfdfd; width:100%; vertical-align:middle;
titlestyle = background:#ccccff; padding-left:1em; padding-right:1em; text-align:center;
abovestyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;
belowstyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;
groupstyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:right;
liststyle  = background:transparent; text-align:left/center;
oddstyle   = background:transparent;
evenstyle  = background:#f7f7f7;
</pre></dd></dl>

由于''liststyle''和''oddstyle''是透明的，奇数列表有''bodystyle''的颜色，其缺省值是#fdfdfd（白色带有少许灰色）。一个list有<code>text-align:left;</code>设定，如果它有一个group的话；否则，它有<code>text-align:center;</code>设定。由于只有''bodystyle''有一个垂直对齐（vertical-align）属性，所 有其它样式继承其<code>vertical-align:middle;</code>设定。

== 表格的布局 ==
由{{tl|Navbox}}'''不带'''''image''、''above''和''below''参数生成的表格（添加了灰色的列表背景色仅仅是为了演示）：

{{Navbox
|name  = Navbox/doc
|state = uncollapsed
|liststyle = background:silver
|title = {{{title}}}
|group1= {{{group1}}}
|list1 = {{{list1}}}
|group2= {{{group2}}}
|list2 = {{{list2}}}
|list3 = {{{list3}}} ''不带 {{{group3}}}''
|group4= {{{group4}}}
|list4 = {{{list4}}}
}}



由{{tl|Navbox}}'''带有'''''image''、''above''和''below''参数生成的表格（添加了灰色的列表背景色仅仅是为了演示）：

{{Navbox
|name  = Navbox/doc
|state = uncollapsed
|liststyle = background:silver
|image = {{{image}}}
|title = {{{title}}}
|above = {{{above}}}
|group1= {{{group1}}}
|list1 = {{{list1}}}
|group2= {{{group2}}}
|list2 = {{{list2}}}
|list3 = {{{list3}}} ''不带 {{{group3}}}''
|group4= {{{group4}}}
|list4 = {{{list4}}}
|below = {{{below}}}
}}



由{{tl|Navbox}}'''带有'''''image''、''imageleft''、''lists''，且'''不带'''''groups''、''above''、''below''生成的表格（添加了灰色的列表背景色仅仅是为了演示）：

{{Navbox
|name = Navbox/doc
|state = uncollapsed
|liststyle = background:silver;
|image = {{{image}}}
|imageleft = {{{imageleft}}}
|title = {{{title}}}
|list1 = {{{list1}}}
|list2 = {{{list2}}}
|list3 = {{{list3}}}
|list4 = {{{list4}}}
}}

== 示例 ==
=== 不带图片 ===
<pre style="overflow:auto">
-{}-{{Navbox
|name  = Navbox/doc
|title = [[大洗女子学园]]学生社团成员

|group1= 排球部
|list1 = [[矶边典子]] • <!--
      -->[[河西忍]] • <!--
      -->[[佐佐木明日]] • <!--
      -->[[近藤妙子]]

|group2= 汽车部
|list2 = [[中岛丽罗]] • <!--
      -->[[铃木(少女与战车)|铃木]] • <!--
      -->[[星野(少女与战车)|星野]] • <!--
      -->[[土屋(少女与战车)|土屋]]

|group3= 广播部
|list3 = [[王大河]]
}}
</pre>

{{Navbox
|name  = Navbox/doc
|title = [[大洗女子学园]]学生社团成员

|group1= 排球部
|list1 = [[矶边典子]] • <!--
      -->[[河西忍]] • <!--
      -->[[佐佐木明日]] • <!--
      -->[[近藤妙子]]

|group2= 汽车部
|list2 = [[中岛丽罗]] • <!--
      -->[[铃木(少女与战车)|铃木]] • <!--
      -->[[星野(少女与战车)|星野]] • <!--
      -->[[土屋(少女与战车)|土屋]]

|group3= 广播部
|list3 = [[王大河]]
}}

=== 带图片，不带分组 ===
<pre style="overflow:auto">
-{}-{{Navbox
|name  = Navbox/doc
|title = [[大洗女子学园]]学生社团成员
|image = [[File:GUP_Ooarai.svg|80px]]
|list1 = [[矶边典子]] • <!--
      -->[[河西忍]] • <!--
      -->[[佐佐木明日]] • <!--
      -->[[近藤妙子]] • <!--
      -->[[中岛丽罗]] • <!--
      -->[[铃木(少女与战车)|铃木]] • <!--
      -->[[星野(少女与战车)|星野]] • <!--
      -->[[土屋(少女与战车)|土屋]] • <!--
      -->[[王大河]]
}}
</pre>

{{Navbox
|name  = Navbox/doc
|title = [[大洗女子学园]]学生社团成员
|image = [[File:GUP_Ooarai.svg|80px]]
|list1 = [[矶边典子]] • <!--
      -->[[河西忍]] • <!--
      -->[[佐佐木明日]] • <!--
      -->[[近藤妙子]] • <!--
      -->[[中岛丽罗]] • <!--
      -->[[铃木(少女与战车)|铃木]] • <!--
      -->[[星野(少女与战车)|星野]] • <!--
      -->[[土屋(少女与战车)|土屋]] • <!--
      -->[[王大河]]
}}

=== 带两张图片，不带分组，多重列表 ===
<pre style="overflow:auto">
-{}-{{Navbox
|name  = Navbox/doc
|title = [[大洗女子学园]]学生社团成员
|image = [[File:GUP_Ooarai.svg|80px]]
|imageleft = [[File:GUP Logo Alpha0.svg|80px]]

|list1 = [[矶边典子]] • <!--
      -->[[河西忍]] • <!--
      -->[[佐佐木明日]] • <!--
      -->[[近藤妙子]]

|list2 = [[中岛丽罗]] • <!--
      -->[[铃木(少女与战车)|铃木]] • <!--
      -->[[星野(少女与战车)|星野]] • <!--
      -->[[土屋(少女与战车)|土屋]]

|list3 = [[王大河]]
}}
</pre>

{{Navbox
|name  = Navbox/doc
|title = [[大洗女子学园]]学生社团成员
|image = [[File:GUP_Ooarai.svg|80px]]
|imageleft = [[File:GUP Logo Alpha0.svg|80px]]

|list1 = [[矶边典子]] • <!--
      -->[[河西忍]] • <!--
      -->[[佐佐木明日]] • <!--
      -->[[近藤妙子]]

|list2 = [[中岛丽罗]] • <!--
      -->[[铃木(少女与战车)|铃木]] • <!--
      -->[[星野(少女与战车)|星野]] • <!--
      -->[[土屋(少女与战车)|土屋]]

|list3 = [[王大河]]
}}

=== 带有图片、分组、上方注释、下方注释 ===
<pre style="overflow:auto">
-{}-{{Navbox
|name  = Navbox/doc
|title = [[大洗女子学园]]学生社团成员
|image = [[File:GUP_Ooarai.svg|80px]]

|above = （仅列出参加了社团的成员）

|group1= 排球部
|list1 = [[矶边典子]] • <!--
      -->[[河西忍]] • <!--
      -->[[佐佐木明日]] • <!--
      -->[[近藤妙子]]

|group2= 汽车部
|list2 = [[中岛丽罗]] • <!--
      -->[[铃木(少女与战车)|铃木]] • <!--
      -->[[星野(少女与战车)|星野]] • <!--
      -->[[土屋(少女与战车)|土屋]]

|group3= 广播部
|list3 = [[王大河]]

|below = 《[[少女与战车]]》官网：https://girls-und-panzer.jp/
}}
</pre>

{{Navbox
|name  = Navbox/doc
|title = [[大洗女子学园]]学生社团成员
|image = [[File:GUP_Ooarai.svg|80px]]

|above = （仅列出参加了社团的成员）

|group1= 排球部
|list1 = [[矶边典子]] • <!--
      -->[[河西忍]] • <!--
      -->[[佐佐木明日]] • <!--
      -->[[近藤妙子]]

|group2= 汽车部
|list2 = [[中岛丽罗]] • <!--
      -->[[铃木(少女与战车)|铃木]] • <!--
      -->[[星野(少女与战车)|星野]] • <!--
      -->[[土屋(少女与战车)|土屋]]

|group3= 广播部
|list3 = [[王大河]]

|below = 《[[少女与战车]]》官网：https://girls-und-panzer.jp/
}}

== 子导航框 ==
{{Main|Template:Navbox subgroup}}

要在父级导航框中放置子导航框，{{tl|Navbox subgroup}}是推荐的用法。但通过在{{tl|Navbox}}加入<code>|border = subgroup/child</code>或将第一个参数（无名）设为<code>subgroup/child</code>也可以达到同样的效果。子导航框不需要<code>name</code>参数。
<div style="display:flex;flex-flow:row wrap;column-gap:1em">
<pre>
{{Navbox subgroup
|group1= 
|list1 = 

|group2= 
|list2 = 
……
}}
</pre>
<pre>
{{Navbox|border=subgroup
|group1= 
|list1 = 

|group2= 
|list2 = 
……
}}
</pre>
<pre>
{{Navbox|subgroup
|group1= 
|list1 = 

|group2= 
|list2 = 
……
}}
</pre>
</div>
它看起来是这样：
<div><!--左边这个<div>不要删，因为subgroup展开后前面会有一个</div>-->{{Navbox subgroup
|group1= {{{group1}}}
|list1 = {{{list1}}}

|group2= {{{group2}}}
|list2 = {{{list2}}}

|list3 = ……
}}

接着把它放进某个list中即可（可增加缩进来表明层级关系）。例如：
<pre style="overflow:auto">
-{}-{{Navbox
|name  = Navbox/doc
|title = 子导航框示例

|group1= 分组1
|list1 = 列表1

|group2= 分组2
|list2 = {{Navbox subgroup
  |evenodd = swap

  |group1= 分组2.1
  |list1 = 列表1

  |group2= 分组2.2
  |list2 = 列表2

  |group3= 分组2.3
  |list3 = 列表3
  }}

|group3= 分组3
|list3 = 列表3
}}
</pre>
{{Navbox
|name  = Navbox/doc
|title = 子导航框示例

|group1= 分组1
|list1 = 列表1

|group2= 分组2
|list2 = {{Navbox subgroup
  |evenodd = swap

  |group1= 分组2.1
  |list1 = 列表1

  |group2= 分组2.2
  |list2 = 列表2

  |group3= 分组2.3
  |list3 = 列表3
  }}

|group3= 分组3
|list3 = 列表3
}}

可以注意到上面使用了一个<code>evenodd</code>参数，这是用来调整某些子分组中条纹状颜色带的分布，以确保颜色带交叉排列。如果想去除所有的条纹颜色带，可以在每个Navbox中设置<code>liststyle = background:transparent</code>。

从设计者的思路来看，<code>border = subgroup</code>和<code>border = child</code>是适用于不同情况的。设为subgroup时group更窄，适用于子导航框的group与父导航框的group并排排列，如上面的例子中，分组2.X与分组2在一行；而child的group保持默认宽度，适合子导航框的group充当第一级group，如下面的[[#多重展开/折叠]]。{{胡话|不过混用也没几个人会发现。}}

<code>border = none</code>的外观与subgroup、child相似，但是它适用于“不在导航框中使用”的情况，比如把<code><nowiki>{{Navbox|none …}}</nowiki></code>嵌入到某个其他模板（并非此模板及其姊妹模板）中。相反，不要把subgroup、child嵌入到Navbox及姊妹模板之外的模板，会造成潜在的错误。

== 多重展开/折叠 ==
{{Main|Template:Navbox with collapsible groups}}
当大家族模板内容过多时，可考虑使用多重展开/折叠。可使用{{tl|Navbox with collapsible groups}}，更为方便、直观。只使用Navbox也可以实现：
<pre>
{{Navbox
|name  = Navbox/doc
|title = ……

|list1 = {{Navbox|child
  |navbar = plain
  |title  = ……
  ……
  }}

|list2 = {{Navbox|child
  |navbar = plain
  |title  = ……
  ……
  }}

|list3 = {{Navbox|child
  |navbar = plain
  |title  = ……
  ……
  }}
}}
</pre>
{{Navbox
|name  = Navbox/doc
|title = [[兽娘动物园]]

|list1 = {{Navbox|child
  |navbar = plain
  |title  = 登场角色
  |group1 = 兽娘
  |list1  = [[兽娘动物园:薮猫|薮猫]] • [[兽娘动物园:耳廓狐|耳廓狐]] • [[兽娘动物园:浣熊|浣熊]] • [[兽娘动物园:沙漠猫|沙漠猫]]
  |group2 = 其他
  |list2  = [[小包]]
  }}

|list2 = {{Navbox|child
  |navbar = plain
  |title  = 相关设定
  |group1 = 作品主要地点
  |list1  = [[加帕里公园]]
  |group2 = 专有名词
  |list2  = [[兽娘动物园:朋友|朋友]] • [[天蓝怪]]
  }}

|list3 = {{Navbox|child
  |navbar = plain
  |title  = 作品相关
  |group1 = 知名二次创作
  |list1  = [[美洲豹人系列]]{{黑幕|KKSK}}
  |group2 = 关联事物
  |list2  = [[葡萄君]]
  }}
}}

== 与其它导航框模板的关系 ==
此导航框模板被特别设计使得能与另外两个姊妹模板协同工作：{{tl|Navbox with columns}}和{{tl|Navbox with collapsible groups}}。所有这三个模板共享常用的参数，以提高一致性与易用性（此类参数在上面的完整参数列表中用<sup>'''†'''</sup>作了标记）。最重要的是，所有这三个模板能互相被用作另一个的子模板（通过使用<code>border = child</code>参数，或将第一个参数（无名）指定为<code>child</code>。例如，使用<code><nowiki>{{Navbox|child …}}</nowiki></code>、<code><nowiki>{{Navbox with columns|child …}}</nowiki></code>或<code><nowiki>{{Navbox with collapsible groups|child …}}</nowiki></code>）。

== 技术细节 ==
* 此模板为其大部分外观使用CSS类，因此它完全可以更换皮肤。
<!-- * 在内部此元模板使用了HTML标记代替 -->
<!-- 
*Internally this meta template uses HTML markup instead of wiki markup for the table code. That is the usual way we make meta templates since wiki markup has several drawbacks. For instance it makes it harder to use [[m:Help:ParserFunctions|parser functions]] and special characters in parameters. 
-->
* 欲了解更多技术细节请参见其[[Template_talk:Navbox|讨论页]]、[[MediaWiki:common.css]]中的CSS类以及[[MediaWiki:common.js]]中用来隐藏框体的可折叠表格。

=== 运作详情 ===
<!-- 译后试了一下，中文模板无需像英文模板那样额外设置liststyle =。2008-11-04
* 在分组（groups）与列表（lists）之间的2px宽的边框被绘出，是使用列表单元格的左边框（border-left）属性。因此，如果你想改变模板的背景颜色（例如<code>bodystyle = background:purple;</code>），那么你就需要使这个左边框颜色（border-left-color）与该背景色相适配（即<code>liststyle = border-left-color:purple;</code>）。如果你想有一个边框围绕在每一个列表单元格，那么在分组与列表之间的这个2px的边框会消失；你要拿出自己的解决方案。

*The 2px wide border between groups and lists is drawn using the border-left property of the list cell.  Thus, if you wish to change the background color of the template (for example <code>bodystyle = background:purple;</code>), then you'll need to make the border-left-color match the background color (i.e. <code>liststyle = border-left-color:purple;</code>).  If you wish to have a border around each list cell, then the 2px border between the list cells and group cells will disappear; you'll have to come up with your own solution.
-->
* 列表单元格宽度初始被设置为100%。因此，如果你想手动设置分组单元格的宽度，你就需要同时指定liststyle使之有width:auto。如果你想设置分组宽度并使用图片，这取决于你已弄明白在groupstyle、liststyle、imagestyle和imageleftstyle参数中的CSS，以使所有部件都工作正常。以下两行是设置分组宽度的示例：
*:<code>groupstyle = width:10em;</code>
*:<code>liststyle = width:auto;</code>
*相邻的导航框在它们之间仅有一个1px的边框。如果你设置了<code>style / bodystyle</code>的顶端外边距（margin-top）或底端外边距（margin-bottom），那么此特性就不运作了。
*外层导航框表格的缺省的左外边距（margin-left）和右外边距（margin-right）被设置为“auto;”。如果你想使用导航框作为一个浮动对象（float），你需要手动设置左外边距和右外边距的值，因为自动外边距（auto margins)会阻止浮动（float）选项。例如，添加下列代码来使用导航框作为一个浮动对象：
*:<code>style = width:22em;float:right;margin-left:1em;margin-right:0</code>

== 参见 ==
* {{tl|Navbox subgroup}} – 允许在导航框内分组。
* {{tl|Navbox with columns}} – 允许以栏取代组别/列表。
* {{tl|Navbox with collapsible groups}} – 另一种变体。
* {{tl|Nobold}} – 当预设文字样式设定为粗体时，可用来显示无粗体文字的模板。
* {{tl|W}} ( • ) – 分隔列表项目的圆点。
* {{tl|nav-s}} – 在标题中显示前任、继任导航模板。

{{Template:格式模板}}
<includeonly>
<!-- 本行下加入模板的分类 -->
[[Category:导航模板]]
[[Category:格式模板]]
</includeonly>
{{NoteTA
|G1 = IT
|1 = zh-cn:用户; zh-tw:使用者; zh-hk:用戶;
}}
{{Documentation subpage}}
{{High-use|573637}}
{{lua|模块:Navbox}}
<!-- 在本行下編輯模板說明 -->
{{mbox|text=
相对于英文维基百科版本的本地变动（供之后更新的管理员参考）：
* 行数增加至35（[//zh.wikipedia.org/wiki/模块:Navbox?diff=26204346&oldid=26204299]）
* 由于中文字符较宽，navbar和collapseButton均扩展到8em以避免文字换行（[//zh.wikipedia.org/wiki/模块:Navbox?diff=next&oldid=26204346]及Common.css中的更改）
* 文字大小被缩放至80%，生成的占位符必须设置同样的文字大小以保证8em的宽度一致（[//zh.wikipedia.org/wiki/模块:Navbox?diff=next&oldid=26204390]）
* collapseButton总有0.5em的margin-left，navbar也有，但不使用navbar时的占位符应该设置同样的margin-right来平衡（[//zh.wikipedia.org/wiki/模块:Navbox?diff=next&oldid=26204405]）
* 翻译分类名（[//zh.wikipedia.org/wiki/模块:Navbox?diff=26260829&oldid=26204614]）
}}
{{Navbox suite}}
本模板允许通过提供一个或多个链接列表相对快速地建立一个[[Wikipedia:导航模板|导航模板]]。它配备了缺省样式，这些样式应能对付大多数导航模板。不建议改变缺省样式，尽管这是可以的。为了导航模板的标准化，也为了便于使用，强烈建议使用这个模板，或者它的「Navbox系列」姊妹模板中的某一个。

==用法==
请移除置空不用的参数。

<pre>
{{Navbox
| state      = autocollapse <!--autocollapse、uncollapsed、collapsed、plain、off-->
| name       = {{subst:PAGENAME}}
| title      = 
| image      = 
| above      = 
| abovestyle = 
| listclass  = hlist
| group1     = 
| list1      = 
| group2     = 
| list2      = 
| group3     = 
| list3      = 
| group4     = 
| list4      = 
| group5     = 
| list5      = 
| group6     = 
| list6      = 
| group7     = 
| list7      = 
| group8     = 
| list8      = 
| group9     = 
| list9      = 
| group10    = 
| list10     = 
| group11    = 
| list11     = 
| group12    = 
| list12     = 
| group13    = 
| list13     = 
| group14    = 
| list14     = 
| group15    = 
| list15     = 
| group16    = 
| list16     = 
| group17    = 
| list17     = 
| group18    = 
| list18     = 
| group19    = 
| list19     = 
| group20    = 
| list20     = 
| belowstyle = 
| below      = 
}}
</pre>

==参数列表==
{{Navbox
|name = Navbox
|state = uncollapsed
|image = {{{image}}}
|title = {{{title}}}
|above = {{{above}}}
|group1 = {{{group1}}}
|list1 = {{{list1}}}
|group2 = {{{group2}}}
|list2 = {{{list2}}}
|list3 = {{{list3}}}''不带{{{group3}}}''
|group4 = {{{group4}}}
|list4 = {{{list4}}}
|below = {{{below}}}<br/>参见下方的其他替代导航格式：[[#表格的布局|''表格的布局'']]<!-- See alternate navbox formats under:[[#Layout of table|''Layout of table'']]  -->
}}
Navbox使用小写的参数名称，如上面框中所示。如果省略其他参数，必需的''name''和''title''会创建一个单行方框。

请注意“group1”（等等）是可选的，命名为“above/below”的部分也是可选的。

基本的和最常见的参数如下所示（参见下方查看完整的列表）：
<!-- 
The navbox uses lowercase parameter names, as shown in the box (''at right'').  The mandatory ''name'' and ''title'' will create a one-line box if other parameters are omitted.
<br/>

Notice "group1" (etc.) is optional, as are sections named "above/below".
{{brClear}}
The basic and most common parameters are as follows (see below for the full list):
-->
;<code>name</code>: 模板的名称（“Template:”后面的部分，注意不是模板的标题）。<!--  the name of the template. -->
;<code>title</code>: 标题栏的文字，像<nowiki>[[化学分支]]</nowiki>。<!--  text in the title bar, such as: <nowiki>[[Widget stuff]]</nowiki>. -->
;<code>state - autocollapse、uncollapsed、collapsed</code>：方框的折叠状态，其中“autocollapse”会自动隐藏被堆叠的多个导航框。<!-- : the status of box expansion, where "autocollapse" hides stacked navboxes automatically. -->
;<code>titlestyle</code>: 一个用于标题栏的CSS样式，像：<!-- a CSS style for the title-bar, such as:  --><code>background:gray;</code>
;<code>groupstyle</code>: 一个用于分组单元格的CSS样式，像：<!-- a CSS style for the group-cells, such as:  --><code>background:#eee;</code>
;<code>image</code>: 一个可选的右侧图片（以完整的image标签的形式编码：<nowiki>[[File:XX.jpg|90px]]</nowiki>）。<!-- an optional right-side image (coded as the whole image tag:  ). -->
;<code>imageleft</code>: 一个可选的左侧图片（编码方式与“image”参数相同）。<!-- an optional left-side image (code the same was as the "image" parameter). -->
;<code>above</code>: 在group/list区段之上显示的文字（可能是一栏综合的维基链接）。<!-- text to appear above the group/lst section (could be a list of overall wikilinks). -->
;<code>group<sub>n</sub></code>: 左侧的文字，在list-n之前（如果group-n被省略，list-n从方框的左侧开始）。<!-- the left-side text before list-n (if group-n omitted, list-n starts at left of box). -->
;<code>list<sub>n</sub></code>: 列出维基链接的文字，通常是一个[[H:LIST|无序列表]]。
;<code>below</code>: 在group/list区段之下显示的可选文字。<!-- optional text to appear below the group/list section. -->

进一步的细节，以及复杂的约束，在下方[[#参数描述|参数描述]]章节作了解释。参见其他的一些替代导航格式：[[#表格的布局|''表格的布局'']]。<!-- Further details, and complex restrictions, are explained below under section ''[[#Parameter descriptions|Parameter descriptions]]''. See some alternate navbox formats under: [[#Layout of table|''Layout of table'']]. -->

== 参数描述 ==
下面是用于{{t1|Navbox}}的参数的一个完整清单。在大多数情况下，只要有参数<code>name</code>、<code>title</code>和<code>list1</code>就可以了，尽管[[#子导航框|子导航框]]甚至不需要设置那些参数。

{{t1|Navbox}}与它的姊妹模板{{t1|Navbox with columns}}、{{t1|Navbox with collapsible groups}}共-{}-用很多常用的参数名称，以提高一致性与易用性。带一个<sup><span style="font-weight:bold;">†</span></sup>标记的参数适用于所有这三个主模板。
<!-- 
The following is a complete list of parameters for using {{t1|Navbox}}.  In most cases, the only required parameters are <code>name</code>, <code>title</code>, and <code>list1</code>, though [[Template:Navbox#Child_navboxes|child navboxes]] do not even require those to be set.

{{t1|Navbox}} shares numerous common parameter names as its sister templates {{t1|Navbox with columns}} and {{t1|Navbox with collapsible groups}} for consistency and ease of use.  Parameters marked with a cross<sup><span style="font-weight:bold;">†</span></sup> are common to all three master templates.
-->
=== 设置参数 ===
:; ''name''<sup>†</sup>
::模板的名称。为了在所有使用了所生成模板的页面上，“檢 · 论 · 编”链接都能正确地工作，就需要设置这个参数。你可以输入<code><nowiki>{{subst:PAGENAME}}</nowiki></code>作为这个参数的值，这也是个快捷的方法。此参数是必需的。<!-- 仅当<code>title</code>被指定，且<code>border</code>参数未被设置时，此name参数才是必需的。 -->
:; ''state''<sup>†</sup> <span style="font-weight:normal;">[<code>autocollapse、uncollapsed、collapsed、plain、off</code>]</span>
:*缺省为<code>autocollapse</code>。如果在使用了其他可折叠表格的同一个页面上有两个或更多表格，那么该页面上的带<code>autocollapse</code>的导航框一开始就会折叠起来。否则，该导航框会被展开。要了解技术上的实现，请参见[[MediaWiki:Gadget-collapsibleTables.js]]。
:*如果设置为<code>collapsed</code>，该导航框总会在开始时以折叠起来的状态展现。
:*如果设置为<code>plain</code>，该导航框总会在被展开时不带右侧的“隐藏”链接，并且标题会保持居中（通过使用补白来偏移<small>查 • 论 • 编 • 历</small>链接）。
:*如果设置为<code>off</code>，该导航框总会在被展开时不带右侧的“隐藏”链接，但是没有补白会被用来保持标题居中。这只是为了高级用法；“plain”选项应能满足大多数需要将“显示”/“隐藏”按钮隐藏起来的应用。
:*如果设置为除<code>autocollapse</code>、<code>collapsed</code>、<code>plain</code>或<code>off</code>之外的其他值（像“uncollapsed”），该导航框总会在开始时以展开的状态出现，但是带有“隐藏”按钮。
:若要在独处（未被包含）时显示框体，而在一个条目中时自动隐藏内容，可以将“uncollapsed”置于<nowiki><noinclude></nowiki>标签之内：
:* <code>state = </code><nowiki><noinclude>uncollapsed</noinclude></nowiki>
:*如此设置会强制框体在单独出现时（甚至是后面有其他导航框时）展开，显示“隐藏”按钮，而当被堆叠在一个条目中时自动折叠框体。
:很多时候，对于一个导航框，编辑者会想要一个缺省的初始状态，并且在条目中它可以被覆写。要做到这一点，这里有个窍门：
:在你的居间模板里，创建一个参数也命名为“state”作为一个传递，像这样：
:*<tt><nowiki>| state = {{{state<includeonly>|你想要的初始状态</includeonly>}}}</nowiki></tt>
:* <nowiki><includeonly>|</nowiki>会使得当查看模板页面本身时，模板会被展开。
::*示例：<nowiki>{{</nowiki>[[Template:土星的卫星|土星的卫星]]<nowiki>}}</nowiki>带autocollapse作为其缺省的初始状态。条目[[土卫三十五]]嵌入包含了它，并且只有一个导航框架。因此该页面的“土星的卫星”导航框显示了出来。条目[[土卫一]]有两个导航框。因此该页面的“土星的卫星”导航框折叠了起来。另外，也可以在条目中使用带state参数的引用形式（如<nowiki>{{土星的卫星|state=collapsed}}</nowiki>）来覆写其折叠状态。
::*示例：<nowiki>{{</nowiki>[[Template:阿拉伯语言|阿拉伯语言]]<nowiki>}}</nowiki>带expanded作为其缺省的初始状态。所有嵌入包含它的条目缺省情况下会显示其内容，除非有一个假定的条目在嵌入包含它时指定了state = collapsed。
:; ''navbar''<sup>†</sup>
::缺省为<code>Navbar</code>。如果设置为<code>plain</code>，在标题栏左侧的<small>查 • 论 • 编</small>链接不会显示出来，而且补白会被自动应用以保持标题居中。设置为<code>off</code>可以移除<small>查 • 论 • 编</small>链接，但是不会应用补白（这只是为了高级用法；“plain”选项应能满足大多数不想要导航栏的应用。）强烈建议使用者不要隐藏导航栏，为的是使用户编辑该模板更加容易，并且可以贯穿各个页面都有一个标准的风格。
<!--
中文模板目前不支持此参数。2008-10-23
:; ''border''<sup>†</sup>
::''关于将导航框用在另一个导航框内部，欲了解示例及更完整的描述，请参见下面的章节。''如果设置为<code>child</code>或<code>subgroup</code>，那么该导航框能够被用作一个无边框的子导航框。其边框被隐藏并且在表格的边上没有补白，因此它能很好地放进它的父导航框的list区域。如果设置为<code>none</code>，那么

:: ''See section below on using navboxes within one another for examples and a more complete description.''  If set to <code>child</code> or <code>subgroup</code>, then the navbox can be used as a borderless child that fits snuggly in another navbox.  The border is hidden and there is no padding on the sides of the table, so it fits into the ''list'' area of its parent navbox.  If set to <code>none</code>, then the border is hidden and padding is removed, and the navbox may be used as a child of another container (do not use the <code>none</code> option inside of another navbox; similarly, only use the <code>child</code>/<code>subgroup</code> option inside of another navbox).  If set to anything else (default), then a regular navbox is displayed with a 1px border.  An alternate way to specify the border to be a subgroup style is like this (i.e. use the first unnamed parameter instead of the named ''border'' parameter):
:::<code><nowiki>{{Navbox|child</nowiki></code>
::::<code>...
:::<code><nowiki>}}</nowiki></code>
-->

=== 单元格 ===
:; ''title''<sup>†</sup>
::显示在表格顶端一行居中位置的文字。它通常是该模板的主题，也就是主体内容的一个简要描述。这应该是单独的一行，但是如果需要第二行，请使用<code><nowiki>{{brClear}}</nowiki></code>来保证正确的居中。本参数从技术上来说不是必需的，但是使用{{t1|Navbox}}而不带标题是相当没有意义的。
:; ''group<sub>n</sub>''<sup>†</sup>
::（即''group1''、''group2''等等）如果被指定，文字会显示在位于''list<sub>n</sub>''左侧的抬头单元格中。如果被省略，''list<sub>n</sub>''占用表格的全部宽度。
:; ''list<sub>n</sub>''<sup>†</sup>
::（即''list1''、''list2''等等）该模板的主体，通常为一栏链接。格式为内联；然而，如果整个列表被装入<code><nowiki><div> </div></nowiki></code>之内，文字能够被输入到不同的行中。最少需要一个''list''参数；每个附加的''list''被显示在一个单独的表格行中。每个''list<sub>n</sub>''可能在其前面有一个相对应的''group<sub>n</sub>''参数，如果提供了的话（参见下方）。
:; ''image''<sup>†</sup>
::一张图片，会显示在标题（title）之下、主体（group/list）之右侧的一个单元格中。为使图片能正确地显示，必须指定''list1''参数。''image''参数接受标准的维基代码来显示图片，即：
::: <code><nowiki>image = [[File:Example.jpg|100px]]</nowiki></code>
:; ''imageleft''<sup>†</sup>
::一张图片，会显示在标题（title）之下、主体（list）之左侧的一个单元格中。为使图片能正确显示，必须指定''list1''参数，而且不能指定分组（group）。''imageleft''参数接受标准的维基代码来显示图片，即：
::: <code><nowiki>imageleft = [[File:Example.jpg|100px]]</nowiki></code>
:; ''above''<sup>†</sup>
::一个全宽度单元格，显示在标题栏与第一个group/list之间，也就是位于该模板的主体（group、list和image）之上。在一个不带图片的模板中，''above''与不带''group1''参数的''list1''参数以同样的方式运作。
:; ''below''<sup>†</sup>
::一个全宽度单元格，显示在该模板主体（group、list和image）的下方。在一个不带图片的模板中，''below''与该模板最后面的不带''group<sub>n</sub>''参数的''list<sub>n</sub>''参数以同样的方式运作。作为一个使用了''below''参数的示例，请参见{{tl|非洲}}。

=== 样式参数 ===
一般不建议更改样式，以保持维基百科中模板和网页的一致性。然而，修改样式的选项还是有的。
:; ''style''<sup>†</sup>
::指定应用到模板主体的CSS样式。''bodystyle''参数也有下面举例的同样效果，并能被用来代替这个''style''参数。此选项应谨慎使用，因为它可以导致视觉上的不一致。举例：
::: <code>style = background:#''nnnnnn'';</code>
::: <code>style = width:''N'' [em/%/px or width:auto];</code>
::: <code>style = float:[''left/right/none''];</code>
::: <code>style = clear:[''right/left/both/none''];</code>
<!-- 注释：中文模板目前尚不支持basestyle参数。2008-10-27
:; ''basestyle''<sup>†</sup>
::CSS样式，会同时应用到''title''、''above''、''below''和''group''单元格。该样式不会应用到''list''单元格。这就比较方便了，使得编辑者很容易改变导航框的基本颜色而无需重复去为该导航框的不同部分指定样式。举例：
--><!-- 
:: CSS styles to apply to the ''title'', ''above'', ''below'', and ''group'' cells all at once.  The style are not applied to ''list'' cells.  This is convenient for easily changing the basic color of the navbox without having to repeat the style specifications for the different parts of the navbox.  Examples:

::: <code>basestyle = background:lightskyblue;</code>
-->
:; ''titlestyle''<sup>†</sup>
::应用到''title''的CSS样式，最常见的有导航栏的背景颜色：
::: <code><nowiki>titlestyle = background:</nowiki>''#nnnnnn'';</code>
::: <code><nowiki>titlestyle = background:</nowiki>''name'';</code>

:; ''groupstyle''<sup>†</sup>
::应用到''groupN''单元格的CSS样式。该选项覆写应用于整个表格的任何样式。举例：
::: <code>groupstyle = background:#''nnnnnn'';</code>
::: <code>groupstyle = text-align:[''left/center/right''];</code>
::: <code>groupstyle = vertical-align:[''top/middle/bottom''];</code>
<!-- 中文模板目前不支持以下参数。2008-10-27
:; ''group<sub>n</sub>style''<sup>†</sup>
-->
:; ''liststyle''<sup>†</sup>
::应用到所有list的CSS样式。若指定了下面的''oddstyle''和''evenstyle''参数，则它们的优先级高于本参数。
<!-- 中文模板目前不支持以下参数。2008-10-27
:; ''list<sub>n</sub>style''<sup>†</sup>

:; ''listpadding''<sup>†</sup>
-->
:; ''oddstyle''
:; ''evenstyle''
::应用到奇数/偶数编号的列表。会推翻由''liststyle''定义的样式。缺省的表现是分别添加条纹状的颜色（白色和灰色）到奇数/偶数行，以提高可读性。除了在非常特别的情况下，这些设置不应更改。
<!-- 
::Applies to odd/even list numbers.  Overrules styles defined by ''liststyle''.  The default behavior is to add striped colors (white and gray) to odd/even rows, respectively, in order to improve readability.  These should not be changed except in extraordinary circumstances.
-->
<!-- 中文模板目前不支持以下参数。2008-10-29
:; ''evenodd'' <span style="font-weight:normal;"><code>[swap, even, odd, off]</code></span>
-->
:; ''abovestyle''<sup>†</sup>
:; ''belowstyle''<sup>†</sup>
::CSS样式，应用到顶端单元格（通过''above''参数指定）和底端单元格（通过''below''参数指定）。典型地被用来设置背景颜色或文本对齐方式：
::: <code>abovestyle = background:#''nnnnnn'';</code>
::: <code>abovestyle = text-align:[''left/center/right''];</code>
<!-- 中文模板目前不支持以下参数。2008-10-29
:; ''imagestyle''<sup>†</sup>
:; ''imageleftstyle''<sup>†</sup>
-->
===== 缺省样式 =====
这里列出的样式设置是使用导航框的编辑者最经常更改的那些设置。其他更加复杂的样式设置被排除在这个列表之外，以保持它简单。大多数样式是在[[MediaWiki:Common.css]]中设置。
:<code>bodystyle  = background:#fdfdfd; width:100%; vertical-align:middle;</code>
:<code>titlestyle = background:#ccccff; padding-left:1em; padding-right:1em; text-align:center;</code>
:<code>abovestyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;</code>
:<code>belowstyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:center;</code>
:<code>groupstyle = background:#ddddff; padding-left:1em; padding-right:1em; text-align:right;</code>
:<code>liststyle  = background:transparent; text-align:left/center;</code>
:<code>oddstyle   = background:transparent;</code>
:<code>evenstyle  = background:#f7f7f7;</code>

由于''liststyle''和''oddstyle''是透明的，奇数列表有''bodystyle''的颜色，其缺省值是#fdfdfd（白色带有少许灰色）。一个list有<code>text-align:left;</code>设定，如果它有一个group的话；否则，它有<code>text-align:center;</code>设定。由于只有''bodystyle''有一个垂直对齐（vertical-align）属性，所 有其他样式继承其<code>vertical-align:middle;</code>设定。

<!-- 中文模板目前不支持以下参数。2008-10-31
=== 高级参数 ===
:; ''titlegroup''
:; ''titlegroupstyle''
:; ''innerstyle''
-->
== 表格的布局 ==
由{{tl|Navbox}}'''不带'''''image''、''above''和''below''参数生成的表格（添加了灰色的列表背景色仅仅是为了演示）：
<!-- 
Table generated by {{tl|Navbox}} '''without''' ''image'', ''above'' and ''below'' parameters (gray list background color added for illustration only):
-->
{{Navbox
|name = Navbox
|state = uncollapsed
|liststyle = background:silver;
|title = {{{title}}}
|group1 = {{{group1}}}
|list1 = {{{list1}}}
|group2 = {{{group2}}}
|list2 = {{{list2}}}
|list3 = {{{list3}}} ''不带 {{{group3}}}''
|group4 = {{{group4}}}
|list4 = {{{list4}}}
}}


由{{tl|Navbox}}'''带有'''''image''、''above''和''below''参数生成的表格（添加了灰色的列表背景色仅仅是为了演示）：
<!-- 
Table generated by {{tl|Navbox}} '''with''' ''image'', ''above'' and ''below'' parameters (gray list background color added for illustration only):
-->
{{Navbox
|name = Navbox
|state = uncollapsed
|liststyle = background:silver;
|image = {{{image}}}
|title = {{{title}}}
|above = {{{above}}}
|group1 = {{{group1}}}
|list1 = {{{list1}}}
|group2 = {{{group2}}}
|list2 = {{{list2}}}
|list3 = {{{list3}}} ''不带 {{{group3}}}''
|group4 = {{{group4}}}
|list4 = {{{list4}}}
|below = {{{below}}}
}}


由{{tl|Navbox}}'''带有'''''image''、''imageleft''、''lists''，且'''不带'''''groups''、''above''、''below''生成的表格（添加了灰色的列表背景色仅仅是为了演示）：
<!-- 
Table generated by {{tl|Navbox}} '''with''' ''image'', ''imageleft'', ''lists'', and '''without''' ''groups'', ''above'', ''below'' (gray list background color added for illustration only):
-->
{{Navbox
|name = Navbox
|state = uncollapsed
|liststyle = background:silver;
|image = {{{image}}}
|imageleft = {{{imageleft}}}
|title = {{{title}}}
|list1 = {{{list1}}}
|list2 = {{{list2}}}
|list3 = {{{list3}}}
|list4 = {{{list4}}}
}}

== 示例 ==
=== 不带图片 ===
<pre style="overflow:scroll;">
{{Navbox
|listclass=hlist
|name  = {{subst:PAGENAME}}
|title = [[多媒体超级走廊]]（马来西亚）{{brClear}}''不带图片''

|group1 = 中心
| list1 = [[赛柏再也]]

|group2 = 区域
| list2 = [[巴生谷]]

|group3 = 主要地标
| list3 = 
* [[双子塔]]
* [[吉隆坡电讯高塔]]
* [[吉隆坡中央车站]]
* [[马来西亚科技园]]
* [[布城]]
* [[赛柏再也]]
* [[吉隆坡国际机场]]

|group4 = 基础设施
| list4 = 
* [[快速铁路]]
* [[吉隆坡-布城高速公路]]
* [[全机场管理系统]]

|group5 = 首要应用
| list5 = 
* [[电子政务]]
* [[大马卡]]  
}}
</pre>

{{Navbox
|listclass=hlist
|name  = Navbox
|state  = uncollapsed
|title = [[多媒体超级走廊]]（马来西亚）{{brClear}}''不带图片''

|group1 = 中心
| list1 = 
* [[赛柏再也]]

|group2 = 区域
| list2 = 
* [[巴生谷]]

|group3 = 主要地标
| list3 = 
* [[双子塔]]
* [[吉隆坡电讯高塔]]
* [[吉隆坡中央车站]]
* [[马来西亚科技园]]
* [[布城]]
* [[赛柏再也]]
* [[吉隆坡国际机场]]

|group4 = 基础设施
| list4 = 
* [[快速铁路]]
* [[吉隆坡-布城高速公路]]
* [[全机场管理系统]]

|group5 = 首要应用
| list5 = 
* [[电子政务]]
* [[大马卡]] 
}}


=== 带图片，不带分组 ===
<pre style="overflow:scroll;">
{{Navbox
|listclass=hlist
|name  = {{subst:PAGENAME}}
|title = [[多媒体超级走廊]]（马来西亚）
|image = [[File:Flag of Malaysia.svg|80px]]
|list1 = 
* [[双子塔]]
* [[吉隆坡电讯高塔]]
* [[吉隆坡中央车站]]
* [[马来西亚科技园]]
* [[布城]]
* [[赛柏再也]]
* [[吉隆坡国际机场]]
}}
</pre>
{{Navbox
|listclass=hlist
|name  = Navbox
|state = uncollapsed
|title = [[多媒体超级走廊]]（马来西亚）
|image = [[File:Flag of Malaysia.svg|80px]]
|list1 = 
* [[双子塔]]
* [[吉隆坡电讯高塔]]
* [[吉隆坡中央车站]]
* [[马来西亚科技园]]
* [[布城]]
* [[赛柏再也]]
* [[吉隆坡国际机场]]
}}


=== 带两张图片，不带分组，多重列表 ===
<pre style="overflow:scroll;">
{{Navbox
|listclass=hlist
|name  = {{subst:PAGENAME}}
|title = [[多媒体超级走廊]]（马来西亚）
|image = [[File:Flag of Malaysia.svg|80px]]
|imageleft = [[File:Flag of Malaysia.svg|80px]]
|list1 = 
* [[双子塔]]
* [[吉隆坡电讯高塔]]
* [[吉隆坡中央车站]]
|list2 = 
* [[快速铁路]]
* [[吉隆坡-布城高速公路]]
* [[全机场管理系统]]
|list3 = 
* [[电子政务]]
* [[大马卡]] 
|list4 = 
* [[巴生谷]]
}}
</pre>

{{Navbox
|listclass=hlist
|name  = Navbox
|state = uncollapsed
|title = [[多媒体超级走廊]]（马来西亚）
|image = [[File:Flag of Malaysia.svg|80px]]
|imageleft = [[File:Flag of Malaysia.svg|80px]]
|list1 = 
* [[双子塔]]
* [[吉隆坡电讯高塔]]
* [[吉隆坡中央车站]]
|list2 = 
* [[快速铁路]]
* [[吉隆坡-布城高速公路]]
* [[全机场管理系统]]
|list3 = 
* [[电子政务]]
* [[大马卡]] 
|list4 = 
* [[巴生谷]]
}}


=== 带有图片、分组、上方注释、下方注释 ===
<pre style="overflow:scroll;">
{{Navbox
|listclass=hlist
|name  = {{subst:PAGENAME}}
|title = [[多媒体超级走廊]]（马来西亚）
|image = [[File:Flag of Malaysia.svg|80px]]

|above = 上方文字放在这里

|group1 = 中心
|list1  = 
* [[赛柏再也]]

|group2 = Area
|list2  = 
* [[巴生谷]]

|group3 = 主要地标
|list3  = 
* [[双子塔]]
* [[吉隆坡电讯高塔]]
* [[吉隆坡中央车站]]
* [[马来西亚科技园]]
* [[布城]]
* [[赛柏再也]]
* [[吉隆坡国际机场]]

|group4 = 基础设施
|list4  = 
* [[快速铁路]]
* [[吉隆坡-布城高速公路]]
* [[全机场管理系统]]

|group5 = 首要应用
|list5  = 
* [[电子政务]]
* [[大马卡]] 

|below  = 网站：[http://www.msc.com.my/ www.msc.com.my]
}}
</pre>

{{Navbox
|listclass=hlist
|name  = Navbox
|state = uncollapsed
|title = [[多媒体超级走廊]]（马来西亚）
|image = [[File:Flag of Malaysia.svg|80px]]

|above = 上方文字放在这里

|group1 = 中心
|list1  = 
* [[赛柏再也]]

|group2 = 区域
|list2  = 
* [[巴生谷]]

|group3 = 主要地标
|list3  = 
* [[双子塔]]
* [[吉隆坡电讯高塔]]
* [[吉隆坡中央车站]]
* [[马来西亚科技园]]
* [[布城]]
* [[赛柏再也]]
* [[吉隆坡国际机场]]

|group4 = 基础设施
|list4  = 
* [[快速铁路]]
* [[吉隆坡-布城高速公路]]
* [[全机场管理系统]]

|group5 = 首要应用
|list5  = 
* [[电子政务]]
* [[大马卡]] 

|below  = 网站：[http://www.msc.com.my/ www.msc.com.my]
}}
<!-- 
=== 典型示例 ===
{{tlu|Template:H:f Help}}模板中使用了本模板{{tlu|Template:Navbox}}，效果如下：
{{H:f Help}}
-->
<!-- 中文模板目前不支持border参数，以下章节相应保留未译。2008-11-2
== 子导航框 ==
-->
== 子导航框 ==
<!--
{{Selfref|For additional examples, see the [[Template:Navbox/testcases|Navbox testcases page]].}}
-->
要在一个边框中放置多个导航框，可以使用''border''参数，或通过将第一个参数指定为“child”来实现。基本用法如下（为第一个组增加了一个子组）：

<pre style="overflow: auto;">
{{Navbox
| name = {{subst:PAGENAME}}
| title = Title

| group1 = [optional]
| list1  = {{Navbox|child
   ...child navbox parameters...
 }}

...
}}
</pre>

=== 子分组示例 ===

{{main|Template:Navbox subgroup}}

下面的示例展示了子分组的用法。{{tl|Navbox subgroup}}是推荐的用法，但通过在{{tl|Navbox}}加入<code>border = child</code>或将第一个参数（无名）设为<code>child</code>也可以达到同样的效果。“evenodd”参数用来调整某些子分组中条纹状颜色带的分布，以确保颜色带的排列正确。如果想去除所有的条纹颜色带，可以在每个Navbox中设置<code>liststyle = background:transparent;</code>。

{{Navbox
| name = Navbox
| image = [[File:Flag of the United States.svg|100px|link=|alt=]]
| state = uncollapsed
| title = 子次级分组示例
| above = 上方文字
| below = 下方文字

| group1 = 分组1
| list1  = 列表1
| group2 = 分组2
| list2  =
 {{Navbox|child
  | evenodd = swap
  | group1 = 分组2.1
  | list1  = 列表1
  | group2 = 分组2.2
  | list2  = 列表2
  | group3 = 分组2.3
  | list3  = 列表3
 }}

| group3 = 分组3
| list3 = 列表3

| group4 = 分组4
| list4 =
 {{Navbox|child
  | evenodd = swap
  | group1 = 分组4.1
  | list1  = 列表1
  | group2 = 分组4.2
  | list2  = 列表2
  | group3 = 分组4.3
  | list3  = 列表3
 }}
}}

=== 一个导航模板下包含其他导航模板 ===

{{main|Template:Navbox with collapsible groups}}

下面的示例中，常规Navbox被用作容器，其list1、list2和list3参数各包含另外的Navbox（设置了<code>1 = child</code>）。“-{zh-hans:查;zh-hant:檢;}-·论·编”标题链接各通过<code>navbar = plain</code>或直接不填写“name”参数隐藏。（与常规Navbox不同，子Navbox不要求填写“name”参数。）

{{Navbox
| name = Navbox
| title = [[File:Blason France moderne.svg|x17px|link=|alt=]] [[File:Flag of France.svg|x17px|link=|alt=]] [[法蘭西殖民帝國]]
| state = uncollapsed
| list1 = {{Navbox|child
 | navbar    = plain
 | title     = [[非洲]]及[[印度洋]]的[[法蘭西殖民帝國|前法国殖民地]]
 | listclass = hlist

 | group1 = [[马格里布]]
 | list1  =
* [[法属阿尔及利亚|阿尔及利亚]]
* [[法属摩洛哥|摩洛哥]] <small>([[阿爾金]])</small>
* [[突尼西亞歷史|突尼西亞]]

 | group2 = [[法屬西非]]
 | list2  =
* [[科特迪瓦历史|科特迪瓦]]
* [[法属达荷美|达荷美]]
* [[法属苏丹|苏丹]]
* [[法属几内亚|几内亚]]
* [[毛里塔尼亚历史|毛里塔尼亚]]
* [[尼日尔历史|尼日尔]]
* [[塞内加尔历史|塞内加尔]]
* [[法属上伏塔|上伏塔]]
* [[法屬多哥蘭]]
* [[詹姆斯岛 (冈比亚)|詹姆斯岛]]

 | group3 = [[法屬赤道非洲]]
 | list3  =
* [[法属乍得|乍得]]
* [[加蓬历史|加蓬]]
* [[刚果共和国历史|法术刚刚果]]
* [[乌班吉沙里]]

 | group4 = [[葛摩]]
 | list4  =
* [[昂儒昂岛]]
* [[大科摩罗岛]]
* [[莫埃利島]]
* [[吉布提历史|法属索马里兰]]
* [[马达加斯加历史#法国殖民时期|马达加斯加]]
* [[毛里裘斯]]
* [[塞舌尔]]
}}

| list2 = {{Navbox|child
 | navbar    = plain
 | title     = [[美洲]]的[[法蘭西殖民帝國|前法国殖民地]]
 | listclass = hlist

 | list1 =
* [[新法兰西]]{{spaces|2}}<small>（[[阿卡迪亞 (加拿大)|阿卡迪亞]]，[[法属路易斯安那|路易斯安那]]，[[法属加拿大|加拿大]]，[[纽芬兰岛]]）1655–1763 </small>

 | list2 =
* [[伊尼尼]]
* [[贝尔维塞]]
* [[法属圣多明戈]]
* <small>[[海地]]</small>
* [[多巴哥岛]]
* [[维尔京群岛]]
* [[France Antarctique]]
* [[France Équinoxiale]]

 | below      = [[法国西印度公司]]
}}

| list3 = {{Navbox|child
 | navbar     = plain
 | title      = [[亚洲]]和[[大洋洲]]的[[法蘭西殖民帝國|前法国殖民地]]
 | listclass  = hlist

 | group1 = [[法属印度]]
 | list1  =
* [[金德訥格爾]]
* [[乌木海岸]]
* [[马德拉斯]]
* [[马埃]]
* [[本地治里]]
* [[开利开尔]]
* [[亚南]]

 | group2 = [[法屬印度支那]]
 | list2  =
* [[柬埔寨历史|柬埔寨]]
* [[老挝历史|老挝]]
* [[法属印度支那|越南]] <small>（[[安南保護國|安南]]，[[南圻]]，[[東京 (越南)|東京]]）</small>

 | group3 = 亚洲其他地区
 | list3  =
* [[Alawite State|Alaouites]]
* [[Republic of Hatay|Alexandretta-Hatay]]
* [[斯里兰卡|锡兰]]
* [[广州湾]]

 | group4 = [[大洋洲]]
 | list4  =
* [[新赫布里底群島共管地]]
** [[瓦努阿图]]

 | below      = [[法国东印度公司]]
}}
}}

== 与其他导航框模板的关系 ==
此导航框模板被特别设计使得能与另外两个姊妹模板协同工作：{{t1|Navbox with columns}}和{{t1|Navbox with collapsible groups}}。所有这三个模板共用常用的参数，以提高一致性与易用性（此类参数在上面的完整参数列表中用<sup>'''†'''</sup>作了标记）。最重要的是，所有这三个模板能互相被用作另一个的子模板（通过使用<code>border = child</code>参数，或将第一个参数（无名）指定为<code>child</code>。例如，使用<code><nowiki>{{Navbox|child ...}}</nowiki></code>、<code><nowiki>{{Navbox with columns|child ...}}</nowiki></code>或<code><nowiki>{{Navbox with collapsible groups|child ...}}</nowiki></code>）。

== 技术细节 ==
* 此模板为其大部分外观使用CSS类，因此它完全可以更换皮肤。
<!-- * 在内部此元模板使用了HTML标记代替 -->
<!-- 
*Internally this meta template uses HTML markup instead of wiki markup for the table code. That is the usual way we make meta templates since wiki markup has several drawbacks. For instance it makes it harder to use [[m:Help:ParserFunctions|parser functions]] and special characters in parameters. 
-->
* 欲了解更多技术细节请参见其[[Template_talk:Navbox|讨论页]]、[[MediaWiki:common.css]]中的CSS类以及[[MediaWiki:Gadget-collapsibleTables.js]]中用来隐藏框体的可折叠表格。

=== 运作详情 ===
<!-- 译后试了一下，中文模板无需像英文模板那样额外设置liststyle =。2008-11-04
* 在分组（groups）与列表（lists）之间的2px宽的边框被绘出，是使用列表单元格的左边框（border-left）属性。因此，如果你想改变模板的背景颜色（例如<code>bodystyle = background:purple;</code>），那么你就需要使这个左边框颜色（border-left-color）与该背景色相适配（即<code>liststyle = border-left-color:purple;</code>）。如果你想有一个边框围绕在每一个列表单元格，那么在分组与列表之间的这个2px的边框会消失；你要拿出自己的解决方案。

*The 2px wide border between groups and lists is drawn using the border-left property of the list cell.  Thus, if you wish to change the background color of the template (for example <code>bodystyle = background:purple;</code>), then you'll need to make the border-left-color match the background color (i.e. <code>liststyle = border-left-color:purple;</code>).  If you wish to have a border around each list cell, then the 2px border between the list cells and group cells will disappear; you'll have to come up with your own solution.
-->
{{blist
|1=列表单元格宽度初始被设置为100%。因此，如果你想手动设置分组单元格的宽度，你就需要同时指定liststyle使之有width:auto。如果你想设置分组宽度并使用图片，这取决于你已弄明白在groupstyle、liststyle、imagestyle和imageleftstyle参数中的CSS，以使所有部件都工作正常。以下两行是设置分组宽度的示例：
:<code>groupstyle = width:10em;</code>
:<code>liststyle = width:auto;</code>
|2=相邻的导航框在它们之间仅有一个1px的边框（除了在IE6中，因其不支持必需的CSS）。如果你设置了<code>style/bodystyle</code>的顶端外边距（top margin）或底顶端外边距（bottom margin），那么此特性就不运作了。
|3=外层导航框表格的缺省的左外边距（margin-left）和右外边距（margin-right）被设置为“auto;”。如果你想使用导航框作为一个浮动对象（float），你需要手动设置左外边距和右外边距的值，因为自动外边距（auto margins)会阻止浮动（float）选项。例如，添加下列代码来使用导航框作为一个浮动对象：
:<code>style = width:22em;float:right;margin-left:1em;margin-right:0em;</code>
|4=一般不需要手动使用圆点模板，因为{{code|1=listclass=hlist}}中的hlist class会自动把列表折叠为圆点形式，并且还会处理嵌套括号。使用列表形式有助残障人士访问，见[[Wikipedia:格式手册/亲和力|亲和力]]。
}}

== 參見 ==
* {{tlx|Navbox subgroup}}－允許在導航框內分組。
* {{tlx|Navbox with columns}}－允許以欄取代組別/列表。
* {{tlx|Navbox with collapsible groups}}－另一種變體。
* {{tlx|NavboxV2}}－如果遇到因为Navbox而触发的[[WP:模板限制]]问题，可以试试这个，平均能减少50%~60%的展开量——如果能整理好传入的参数的话……
* {{tlx|Nowrap begin}}－於列表項目中間插入圓點、直管線或破折號的格式模板。
* {{tlx|Nobold}}－當預設文字樣式設定為粗體時，可用來顯示無粗體文字的模板。
* {{tlx|·}}及{{tlx|•}}－分隔列表項目的圓點。一般不应使用。
* {{tlx|collapsible option}}－提示控制模板的顯示狀態。

{{Navigational templates}}