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

{{Uses_Lua|模块:Navbox}}
<!-- 在本行下編輯模板說明 -->
本模板可相对快速地建立一个[[Wikipedia:导航模板|导航模板]]，它配备了默认样式，这些样式能对付大多数导航模板。不建议改变默认样式，尽管这是可以的。为了导航模板的标准化，也为了方便使用，强烈建议使用这个模板，或者它的「Navbox系列」姊妹模板中的某一个。

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

<syntaxhighlight lang="wikitext">
{{Navbox
| name       = Navbox/doc{{subst:void|请勿更改此行的任何内容，保存页面时它将自动更改／請勿變更此列的任何內容，儲存頁面時它將自動變更}}
| title      =
| listclass  = hlist
| state      = {{{state|}}}

| above      =
| image      =

| group1     =
| list1      =

| group2     =
| list2      =

| group3     =
| list3      =

<!-- ... -->

| below      =
}}<noinclude>
{{navbox documentation}}
<!-- 在此处添加导航模板的分类／在此處添加導航模板的分類 -->
</noinclude>
</syntaxhighlight>

==参数列表==
{{{{PAGENAMETDOC}}
| name   = Navbox
| state  = expanded
| title  = {{{title}}}
| above  = {{{above}}}
| image  = {{{image}}}
| group1 = {{{group1}}}
| list1  = {{{list1}}}
| group2 = {{{group2}}}
| list2  = {{{list2}}}
| group3 = {{{group3}}}
| list3  = {{{list3}}}
| group4 = {{{group4}}}
| list4  = {{{list4}}}
| below  = {{{below}}}<br />其他导航格式見[[#表格的布局|表格的布局]]
}}
Navbox使用小写的参数名称，如上面框中所示。如果省略其他参数，必需的''name''和''title''会创建一个单行方框。

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

基本的和最常见的参数如下所示：
* <code>name</code>–模板的名称（“Template:”后面的部分，注意不是模板的标题）。
* <code>title</code>–标题栏的文字，像<nowiki>[[化学分支]]</nowiki>。
* <code>listclass</code>–用於list单元格的[[层叠样式表|CSS样式]]，常设定為hlist以使用[[Wikipedia:格式手冊/親和力#水平列表|水平列表]]。如果''above''、''below''也需使用水平列表则应改用bodyclass参数。
* <code>state</code>–方框的折叠状态。
* <code>titlestyle</code>–一个用于标题栏的CSS样式，像：<code>background:gray;</code>
* <code>groupstyle</code>–一个用于分组单元格的CSS样式，像：<code>background:#eee;</code>
* <code>above</code>–在group/list区段之上显示的文字，可能是一栏综合的维基链接。
* <code>image</code>–一个可选的右侧图片，以完整image标签的形式编码：<nowiki>[[File:XX.jpg|90px]]</nowiki>。
* <code>imageleft</code>–一个可选的左侧图片，编码方式与“image”参数相同。
* <code>group<sub>n</sub></code>–左侧的文字，在list-n之前（如果group-n被省略，list-n从方框的左侧开始）。
* <code>list<sub>n</sub></code>–列出维基链接的文字，通常是一个[[Wikipedia:格式手冊/親和力#水平列表|无序列表]]。
* <code>below</code>–在group/list区段之下显示的文字。

下方[[#参数描述|参数描述]]章节解释了进一步的细节及限制。其他导航格式則可見[[#表格的布局|表格的布局]]。

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

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

=== 设置参数 ===
:; ''name''<sup>†</sup>
::模板的名称。为了使所有衍生模板的“-{zh-hans:查;zh-hant:閱;}-·论·编”链接正确工作，就必須设置这个参数。你可以输入<code><nowiki>{{subst:PAGENAME}}</nowiki></code>作为这个参数的值，这也是个快捷的方法。仅当<code>title</code>被指定，且<code>border</code>参数未被设置且未使用<code>navbar</code>参数禁用导航栏时，name参数才是必需的。
:; ''state''<sup>†</sup> <span style="font-weight:normal;">[<code>autocollapse、expanded、collapsed、plain、off</code>]</span>
:*默认为<code>autocollapse</code>。如果一个页面上同时有两个或更多可折叠表格，那么该页面上的带<code>autocollapse</code>的导航框在页面载入时会折叠起来。要了解技术上的实现，请参见[[MediaWiki:Common.js]]中的<code>mwCollapsibleSetup</code>函数。
:*如果设置为<code>collapsed</code>，该导航框会在页面载入时折叠起来。
:*如果设置为<code>plain</code>，该导航框在展开时不带右侧的“隐藏”链接，并且标题会保持居中（通过使用补白来偏移<small>-{zh-hans:查;zh-hant:閱;}-·论·编</small>链接）。
:*如果设置为<code>off</code>，该导航框在展开时不带右侧的“隐藏”链接，但是没有补白、标题未必居中。这只是为了高级用法；“plain”选项应能满足大多数需要将“显示”/“隐藏”按钮隐藏起来的应用。
:*如果设置为除<code>autocollapse</code>、<code>collapsed</code>、<code>plain</code>或<code>off</code>之外的其他值（像“expanded”），该导航框会在页面载入时展开，並带有“隐藏”按钮。
:若要在独处（未被包含）时显示框体及“隐藏”按钮，而在条目中自动隐藏内容，可以将“expanded”置于<nowiki><noinclude></nowiki>标签之内：
:* <code>state = <nowiki><noinclude>expanded</noinclude></nowiki></code>
:如果想让编辑者在条目中覆写折叠狀態，可以这样做：
:在你创建的模板里，像这样加入也命名为“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。
:*模板{{tl|Collapsible option}}解释了如何使用<code>state</code>参数，可以将其添加到模板定义后的<code><nowiki><noinclude>...</noinclude></nowiki></code>部分，也可以添加到{{tl|Documentation subpage}}上的说明中。
:; ''navbar''<sup>†</sup>
::如果设置为<code>plain</code>，在标题栏左侧的<small>-{zh-hans:查;zh-hant:閱;}-·论·编</small>链接不会显示，而且自动应用补白以保持标题居中；设置为<code>off</code>可以移除<small>-{zh-hans:查;zh-hant:閱;}-·论·编</small>链接，但是不会应用补白（这只是为了高级用法；“plain”选项应能满足大多数不想要导航栏的应用。）强烈建议使用者不要隐藏导航栏，为的是使用户编辑该模板更加容易，并且在各页面中保持标准风格。
:; ''border''<sup>†</sup>
::''关于将导航框用在另一个导航框内部，欲了解示例及更完整的描述，请参见[[#子导航框|下面的章节]]。''如果设置为<code>child</code>或<code>subgroup</code>，那么该导航框能够被用作一个无边框的子导航框。其边框被隐藏并且在表格的边上没有补白，因此它能很好地放进它的父导航框的list区域。如果设置为<code>none</code>，那么其边框被隐藏并且补白被移除，导航框可用作另一个容器的子项（不要在另一个导航框内使用<code>none</code>选项；同样地，只在另一个导航框内使用<code>child</code>／<code>subgroup</code>选项）。如果设置为其他任意值（默认值），则显示带有1px边框的常规导航框。将边框指定为子导航框样式的另一种方法是这样的（即使用第一个未命名参数而不是''border''参数）：
:::<pre>{{Navbox|child|...}}</pre>

=== 单元格 ===
:; ''title''<sup>†</sup>
::显示在表格顶端一行居中位置的文字，它通常是该模板的主题，也就是主体内容的简要描述。这应该是单独的一行，如果需要第二行，请使用<code><nowiki>{{Clear}}</nowiki></code>来保证正确的居中。本参数从技术上来说不是必需，但是使用{{Tl|Navbox}}而不带标题相当没有意义。
:; ''above''<sup>†</sup>
::一个全宽度单元格，显示在标题栏与第一个group/list之间，也就是位于该模板的主体（group、list和image）之上。在不带图片的模板中，''above''与不带''group1''参数的''list1''参数以同样方式运作。
:; ''group<sub>n</sub>''<sup>†</sup>
::（即''group1''、''group2''等等）如果被指定，文字会显示在''list<sub>n</sub>''左侧的抬头单元格中；如果被省略，''list<sub>n</sub>''占用表格的全部宽度。
:; ''list<sub>n</sub>''<sup>†</sup>
::（即''list1''、''list2''等等）模板的主体，每个导航框至少需要一个''list''参数，通常为一栏链接，格式为内链；如果整个列表被装入<code><nowiki><div> </div></nowiki></code>内则可分行显示。每个附加的''list''被显示在一个单独的表格行中，每个''list<sub>n</sub>''前面可能有一个相对应的''group<sub>n</sub>''参数。
:: 在[[Wikipedia:格式手冊/親和力#水平列表|水平列表]]中，每个[[Wikipedia:格式手册/链接|內部链接]]都应新起一行，並以[[星號]]<code>*</code>開頭，使用兩個或更多星號會增加更多階層。
:; ''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>
:; ''below''<sup>†</sup>
::一个全宽度单元格，显示在该模板主体（group、list和image）的下方。在不带图片的模板中，''below''与该模板最后面的不带''group<sub>n</sub>''参数的''list<sub>n</sub>''参数以同样方式运作。作为一个使用了''below''参数的示例，请参见{{Tl|非洲}}。

=== 样式参数 ===
一般不建议更改样式，以保持维基百科中模板和网页的一致性，然而还是可以修改。
:; ''bodystyle''<sup>†</sup>
::指定应用到模板主体的CSS样式。此选项应谨慎使用，因为它可以导致视觉上的不一致。举例：
::: <code>bodystyle = background:#''nnnnnn'';</code>
::: <code>bodystyle = width:''N'' [em/%/px or width:auto];</code>
::: <code>bodystyle = float:[''left/right/none''];</code>
::: <code>bodystyle = clear:[''right/left/both/none''];</code>

:; ''basestyle''<sup>†</sup>
::CSS样式，会同时应用到''title''、''above''、''below''和''group''单元格，不会应用到''list''单元格。使编辑者容易改变导航框的基本颜色，而无需在不同部分重复指定。举例：
::: <code>basestyle = background:lightskyblue;</code>

:; ''titlestyle''<sup>†</sup>
::应用到''title''的CSS样式，最常用于指定title背景颜色：
::: <code><nowiki>titlestyle = background:</nowiki>''#nnnnnn'';</code>
::: <code><nowiki>titlestyle = background:</nowiki>''name'';</code>
::: <code><nowiki>titlestyle = background:</nowiki>''none'';</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>
:; ''group<sub>n</sub>style''<sup>†</sup>
::除了''groupstyle''参数指定的任何样式外，还将CSS样式应用于特定组。此参数仅在绝对必要时才使用，以保持标准化和简单性。举例：
::: <code>group3style = background: red; color: white;</code>
:; ''groupwidth''
::一个数字和单位，用于指定组单元格的统一宽度，以防列表单元格中的内容太少导致组单元格太宽。无默认值，但是可以通过''group(n)style''参数覆盖。举例：
::: <code>groupwidth = 9em</code>
:; ''liststyle''<sup>†</sup>
::应用到所有list的CSS样式。若指定了下面的''oddstyle''和''evenstyle''参数，则它们优先于本参数。
:; ''list<sub>n</sub>style''<sup>†</sup>
::除了''liststyle''参数指定的任何样式外，还将CSS样式应用于特定列表。此参数仅在绝对必要时才使用，以保持标准化和简单性。举例：
::: <code>list5style = background: #ddddff;</code>
:; ''listpadding''<sup>†</sup>
::指定每个''list''单元格内边距的数字和单位。列表单元格的默认内边距为左侧和右侧0.25em，顶部和底部0。由于复杂的技术原因，简单地设置“liststyle = padding: 0.5em;”（或任何其他内边距设置）将不起作用。举例：
::: <code>listpadding = 0.5em 0;</code>（设置顶部和底部的内边距为0.5em，左侧和右侧的内边距为0）
::: <code>listpadding = 0</code>（删除所有内边距）
:; ''oddstyle''
:; ''evenstyle''
::应用到奇数／偶数编号的样式，会推翻由''liststyle''定义的样式。默认表现是分别添加条纹状的颜色（白色和灰色）到奇数／偶数行，以提高可读性。除了在非常特别的情况下，这些设置不应更改。
:; ''evenodd'' <span style="font-weight:normal;"><code>[swap, even, odd, off]</code></span>
::如果设置为<code>swap</code>，则奇偶行的自动条纹将反转。通常情况下，偶数行的条纹背景为浅灰色；使用该参数时，奇数行将获得灰色条纹，而不是偶数行。设置为<code>even</code>或<code>odd</code>可将所有行设置为该条纹颜色。设置为<code>off</code>可禁用自动条纹。
:; ''abovestyle''<sup>†</sup>
:; ''belowstyle''<sup>†</sup>
::CSS样式，应用到顶端单元格（通过''above''参数指定）和底端单元格（通过''below''参数指定）。常用来设置背景颜色或文本对齐方式：
::: <code>abovestyle = background:#''nnnnnn'';</code>
::: <code>abovestyle = text-align:[''left/center/right''];</code>
::: <code>belowstyle = background:#''nnnnnn'';</code>
::: <code>belowstyle = text-align:[''left/center/right''];</code>
:; ''imagestyle''<sup>†</sup>
:; ''imageleftstyle''<sup>†</sup>
::应用于image／imageleft所在单元格的CSS样式。这些样式只应在特殊情况下使用，通常用于修复设置了组宽度且图像单元格的宽度过大时出现的宽度问题。举例：
::: <code>imagestyle = width:5em;</code>
===== 默认样式 =====
这里列出编辑者最常更改的样式设置。其他更加复杂的样式设置被排除以保持简洁。大多数样式设置在[[Module:Navbox/styles.css]]。
<syntaxhighlight lang="css">
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;
</syntaxhighlight>

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

=== 高级参数 ===
:; ''bodyclass''
:; ''aboveclass''
:; ''groupclass''
:; ''listclass''
:; ''belowclass''
::这可以将CSS类附加到组或列表单元格。''listclass''最常见的用途是赋予它一个可使列表水平呈现的<code>hlist</code>类。上述所有参数都接受<code>hlist</code>类，但如果多个参数使用了<code>hlist</code>类，请改用{{para|bodyclass|hlist}}。
::{{tl|Navbox}}自动添加可被覆盖的<code>nowraplinks</code>类，例如{{para|listclass|wraplinks}}。
:; ''innerstyle''
::一个非常高级的参数，仅用于使用导航框的高级元模板。在内部，导航框使用外部表格绘制边框，然后使用内部表格绘制其他所有内容（title/above/groups/lists/below/image等）。bodystyle参数设置外部表格的样式，内部表格将继承该样式。但在高级情况下（元模板），可能需要直接设置内部表格的样式。该参数提供对该内部表格的访问，以便可以应用样式。使用风险自负。
<!-- 中文模板目前不支持以下参数。2024-10-05
:; ''nowrapitems''
::设置{{para|nowrapitems|yes}}以将nowrap应用于列表项中的每一行，以及任何<code>above</code>和<code>below</code>项。
-->
:; ''orphan''
::在子导航框中设置{{para|orphan|yes}}以修复奇数／偶数行条纹并删除[[:Category:孤立的子导航框|分类:孤立的子导航框]]。

==== 微格式 ====
:; ''bodyclass''
::该参数插入到整个导航框的“class”属性中。
:; ''titleclass''
::该参数插入到导航框标题的“class”属性中。

该模板支持添加微格式信息。这是通过向各种数据单元添加“class”属性来实现的，这些属性指示其中包含哪种信息。例如，要将导航框标记为包含有关人物的[[hCard]]信息，请添加以下参数：
<pre>
| bodyclass = vcard
</pre>
以及
<pre>
| titleclass = fn
</pre>
或（举例）：
<pre>
| title = <span class="fn">[[郭敬明]]</span>作品
</pre>
……等等。

关于在维基百科使用微格式的详细信息，请参见[[WikiProject:微格式|微格式维基专题]]。关于微格式的更多基础信息，请参见[[微格式]]。

== 表格的布局 ==
由{{Tl|Navbox}}「不带」''image''、''above''和''below''参数生成的表格（为演示而添加灰色的列表背景）：
{{Navbox
|name = Navbox
|state = expanded
|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
|state = expanded
|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
|state = expanded
|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 = [[多媒体超级走廊]]（马来西亚）{{Clear}}「不带图片」

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

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

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

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

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

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

|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 = expanded
|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 = expanded
|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 = expanded
|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]
}}

== 子导航框 ==
{{Main|Template:NavboxV2}}
{{Selfref|有关更多示例，请见[[Template:Navbox/testcases|模板的测试样例]]。}}
可以在一个导航框中放置多个导航框。这些可以内联指定，也可以使用嵌套的导航框模板指定，尽管后一种方法可能会导致[[Wikipedia:模板限制#模板展开后长度|模板展开后长度]]非常大。

要内联指定子导航框，请使用{{tl|NavboxV2}}，为第一个组增加了一个子组如下：
<pre style="overflow: auto;">
{{NavboxV2
| name = {{subst:PAGENAME}}
| title = Title

| group1 = [optional]
| list1-border  = child
| list1-type    = vertical
  | list1-title = [optional]

  | list1-group1       = [optional]
  | list1-list1-border = child
  | list1-list1-type   = vertical
    | list1-list1-title = [optional]
    
    | list1-list1-group1 = [optional]
    | list1-list1-list1  = 
    ...子導航框參數...
  ...
...
}}
</pre>

要使用嵌套模板指定子导航框，可以将参数1或border参数指定为“child”，为第一个组增加了一个子组如下：

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

| group1 = [optional]
| list1  = {{Navbox|child
   ...子導航框參數...
 }}

...
}}
</pre>

条纹颜色带会自动交替。如果想去除所有的条纹颜色带，可以在每个Navbox中设置<code>list<sub>n</sub>-liststyle = background:transparent;</code>。

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

| group1 = 分组1
| list1  = 列表1
| group2 = 分组2
| list2-border = child
| list2-type   = vertical
  | list2-group1 = 分组2.1
  | list2-list1  = 列表1
  | list2-group2 = 分组2.2
  | list2-list2  = 列表2
  | list2-group3 = 分组2.3
  | list2-list3  = 列表3

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

| group4 = 分组4
| list4-border = subgroup
| list4-type   = vertical
  | list4-group1 = 分组4.1
  | list4-list1  = 列表1
  | list4-group2 = 分组4.2
  | list4-list2  = 列表2
  | list4-group3 = 分组4.3
  | list4-list3-border = subgroup
  | list4-list3-type   = vertical
    | list4-list3-group1 = 分组4.3.1
    | list4-list3-list1  = 列表1
    | list4-list3-group2 = 分组4.3.2
    | list4-list3-list2  = 列表2
}}

=== 一个导航模板下包含其他导航模板 ===
{{Main|Template:Navbox with collapsible groups}}

下面的示例中，常规Navbox被用作容器，其list1-border、list2-border和list3-border参数均包含<code>child</code>关键字。由于使用了“child”或“subgroup”关键字，“-{zh-hans:查;zh-hant:閱;}-·论·编”标题链接会自动隐藏（与常规Navbox不同，子Navbox不要求填写“name”参数），因此无需对每个导航链接使用<code>navbar = plain</code>。代码<syntaxhighlight lang="wikitext" inline>listN-state = {{#ifeq:{{{selected|}}|ABBREVIATION|expanded|{{{stateN|collapsed}}}}}</syntaxhighlight>用于复制{{tl|Navbox with collapsible groups}}的<syntaxhighlight lang="wikitext" inline>abbrN = ABBREVIATION</syntaxhighlight>功能。

{{NavboxV2
| name = Navbox
| title = [[File:Blason France moderne.svg|x17px|link=|alt=]] [[File:Flag of France.svg|x17px|link=|alt=]] [[法蘭西殖民帝國]]
| state = expanded
| list1-border = child
 | list1-type      = vertical
 | list1-state     = {{#ifeq:{{{selected|}}|Africa|expanded|{{{state1|collapsed}}}}}
 | list1-title     = [[非洲]]及[[印度洋]]的[[法蘭西殖民帝國|前法国殖民地]]
 | list1-listclass = hlist

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

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

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

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

| list2-border = child
 | list2-type      = vertical
 | list2-state     = {{#ifeq:{{{selected|}}|Americas|expanded|{{{state2|collapsed}}}}}
 | list2-title     = [[美洲]]的[[法蘭西殖民帝國|前法国殖民地]]
 | list2-listclass = hlist

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

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

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

| list3-border = child
 | list3-type       = vertical
 | list3-state      = {{#ifeq:{{{selected|}}|Asia|expanded|{{{state3|collapsed}}}}}
 | list3-title      = [[亚洲]]和[[大洋洲]]的[[法蘭西殖民帝國|前法国殖民地]]
 | list3-listclass  = hlist

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

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

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

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

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

== 与其他导航框模板的关系 ==
此导航框模板被特别设计使得能与另外两个姊妹模板协同工作：{{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>）。

由於嵌入子導航框可能使導航框、引用頁面超出[[Wikipedia:模板限制|模板引用大小限制]]，故可使用{{Tl|NavboxV2}}取代上面三種模板。

== 技术细节 ==
* “{{navbar|1=:{{FULLPAGENAME}}|mini=on}}”链接由{{tl|Navbar}}生成。如果您对它们有疑问，请在[[Template talk:Navbar]]发起提问。
* 在分组（groups）与列表（lists）之间的2px宽的边框被绘出，是使用列表单元格的左边框（border-left）属性。因此，如果你想改变模板的背景颜色（例如<code>bodystyle = background:purple;</code>），那么你就需要使这个左边框颜色（border-left-color）与该背景色相适配（即<code>liststyle = border-left-color:purple;</code>）。如果你想有一个边框围绕在每一个列表单元格，那么在分组与列表之间的这个2px的边框会消失；你要拿出自己的解决方案。
* 相邻的导航框在它们之间有一个1px的边框（除了在IE6中，因其不支持必需的CSS）。如果你设置了<code>style/bodystyle</code>的顶端外边距（top margin）或底顶端外边距（bottom margin），那么此特性就不运作了。
* 外层导航框表格的默认的左外边距（margin-left）和右外边距（margin-right）被设置为“auto;”。如果你想使用导航框作为一个浮动对象（float），你需要手动设置左外边距和右外边距的值，因为自动外边距（auto margins)会阻止浮动（float）选项。例如，添加下列代码来使用导航框作为一个浮动对象：
** <code>bodystyle = width: 22em; float: right; margin-left: 1em; margin-right: 0;</code>
* 此模板调用{{ml|Navbox|navbox}}。当在页面上使用导航框模板时，它会使[[Wikipedia:模板限制|模板引用大小]]翻倍。当嵌套模板使用子导航框时，可能会导致大小增加四倍或更多。要减少引用大小，除了使用{{tl|NavboxV2}}内联指定[[#子导航框|子导航框]]而不是嵌套模板外，您还可以直接调用模块，例如：

<syntaxhighlight lang="wikitext">
{{#invoke:Navbox|navbox
| name = Navbox/doc
| title = Title

| group1 = [optional]
| list1  = {{#invoke:Navbox|navbox|child
   ...子導航框參數...
 }}

...
}}
</syntaxhighlight>

== 模板数据 ==
{{TemplateDataHeader}}
<templatedata>
{
	"params": {
		"image": {},
		"Title": {},
		"above": {},
		"group1": {},
		"list1": {},
		"group2": {},
		"list2": {},
		"list3": {},
		"group3": {},
		"group4": {},
		"list4": {},
		"below": {},
		"imageleft": {},
		"name": {
			"label": "模板的名称"
		},
		"title": {
			"label": "标题栏的文字"
		},
		"listclass": {
			"description": "用于list单元格的CSS样式，常设定为hlist以使用水平列表。如果above、below也需使用水平列表则应改用bodyclass参数。"
		},
		"titlestyle": {
			"description": "一个用于标题栏的CSS样式",
			"example": "background:gray"
		}
	}
}
</templatedata>

== 參見 ==
* {{Tlx|Navbox decade list}}－允许在列表项中插入十年一行的等距链接。
* {{Tlx|Navboxes}}－将多个导航框收纳到一起。
* {{Tlx|Nobold}}－當預設文字樣式設定為粗體時，可用來顯示無粗體文字的模板。
* {{Tlx|Sidebar}}－垂直对齐的导航模板。
* {{Tlx|Navbox documentation}}－使用{{tl|Documentation}}显示标准文档。
* [[:Template:Navbox/testcases]]－有关模板代码的更多示例。
* [[Wikipedia:模板文档]]－编写随附文档的指南。
* {{Tlx|Nowrap begin}}、{{Tlx|·}}及{{Tlx|•}}－'''已弃用'''，非过时的替代项是使用<code>hlist</code>类来格式化列表。参见{{tl|Flatlist}}以了解<code>hlist</code>工作原理的技术说明。

=== 追踪分类 ===
* {{clc|孤立的子导航框}}
* {{clc|没有使用水平列表的导航框}}
* {{clc|使用背景颜色的导航框}}
* {{clc|name參數和實際不同的導航框}}

{{Navigational templates}}

== 重定向 ==
* {{模板鏈接|无图表格模板}}

<includeonly>{{Sandbox other||
<!-- 本行下加入模板的分類，跨維基連結加入Wikidata（參見[[Wikipedia:Wikidata]]） -->
[[Category:導航模板]]
[[Category:摺疊模板]]
[[Category:格式模板]]
}}</includeonly>