View source for 模板:Navbox/doc

{{NoteTA
|G1 = IT
|1 = zh-cn:用户; zh-tw:使用者; zh-hk:用戶;
}}
{{FromOtherWiki|zhwiki}}
{{Documentation subpage}}
{{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/doc
|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> - 列出维基链接的文字，通常以圆点符号模板分隔开来，像：<!-- text listing wikilinks, often separated by middot templates, such as:  -->[<nowiki/>[A]]<code>{<nowiki/>{·}}</code> [<nowiki/>[B]]
:<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/doc#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:Common.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/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''参数生成的表格（添加了灰色的列表背景色仅仅是为了演示）：
<!-- 
Table generated by {{tl|Navbox}} '''with''' ''image'', ''above'' and ''below'' parameters (gray list background color added for illustration only):
-->
{{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''生成的表格（添加了灰色的列表背景色仅仅是为了演示）：
<!-- 
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/doc
|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  = Navbox/doc
|title = [[多媒体超级走廊]]（马来西亚）{{brClear}}''不带图片''

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

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

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

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

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

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

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

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

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

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

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


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

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

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


=== 带有图片、分组、上方注释、下方注释 ===
<pre style="overflow:scroll;">
{{Navbox
|listclass=hlist
|name  = Navbox/doc
|title = [[多媒体超级走廊]]（马来西亚）
|image = [[File:Lua-logo.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/doc
|state = uncollapsed
|title = [[多媒体超级走廊]]（马来西亚）
|image = [[File:Lua-logo.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/doc#子分组示例
| image =
| 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/doc
| title = [[法蘭西殖民帝國]]
| 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: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的边框（除了在IE6中，因其不支持必需的CSS）。如果你设置了<code>style/bodystyle</code>的顶端外边距（top margin）或底顶端外边距（bottom margin），那么此特性就不运作了。
*外层导航框表格的缺省的左外边距（margin-left）和右外边距（margin-right）被设置为“auto;”。如果你想使用导航框作为一个浮动对象（float），你需要手动设置左外边距和右外边距的值，因为自动外边距（auto margins)会阻止浮动（float）选项。例如，添加下列代码来使用导航框作为一个浮动对象：
::<code>style = width:22em;float:right;margin-left:1em;margin-right:0em;</code>

== 參見 ==
* {{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|•}} – 分隔列表項目的圓點。

{{Navigational templates}}

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