User:Chronowar/sandbox3

本页面作为本地化模板:Navbox/doc的页面，仅供参考。

以下是正文内容。

正文

本模板允许通过提供一个或多个链接列表相对快速地建立一个索引模板。

使用

请移除置空不用的参数。

{{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 = }}

参数描述

Navbox使用小写的参数名称。

如果省略其他参数，必需的name和title会创建一个单行方框。

其它的所有变量都是可选的。

下面是用于Navbox的参数的一个完整清单。在大多数情况下，只要有参数name、title和几个group和list就可以了。

变量名	说明
name	该索引模板的名称（“模板:”后面的部分，注意不是模板的标题）。你可以输入{{subst:PAGENAME}}作为这个参数的值，这也是个快捷的方法。
title	标题栏中的文字，作为主体内容的一个简要描述。例如[[Arcaea]]。 本参数从技术上来说不是必需的，但是使用Navbox而不带标题是相当没有意义的。
state	几个状态：autocollapse、uncollapsed、collapsed、plain、off 缺省为autocollapse。如果在使用了其他可折叠表格的同一个页面上有两个或更多表格，那么navbox一开始就会折叠起来。 collapsed:该导航框总会在开始时以折迭起来的状态展现。 plain:该导航框会不带右侧的“隐藏”链接，并且标题会保持居中。 off:该导航框总会在被展开时不带右侧的“隐藏”链接，但是没有补白以保持标题居中。 除上述4个值之外的其他值（例如“uncollapsed”），该导航框总会在开始时以展开的状态出现，但是带有“隐藏”按钮。
titlestyle	应用于标题栏的一个CSS样式字符串，例如background:gray
groupstyle	应用于分组单元格的一个CSS样式字符串，例如background:#eee;
image	一个可选的右侧图片，以完整的文件形式编码，例如[[文件:Packs arcaea.jpg|75px]]。
imageleft	一个可选的左侧图片，格式与“image”参数相同。
above	在group/list区段之上显示的文字。
groupn	左侧的文字，在list-n之前作为描述文本（如果group-n被省略，list-n从方框的左侧开始）。
listn	列出条目名称，通常以圆点符号模板（模板:·）分隔开来，例如[[Antagonism]]{{·}} [[Dantalion]]
below	在group/list区段之下显示的可选文字，与above性质相同。

其他的一些替代导航格式：表格布局。

高级参数/复杂描述

title^†

显示在表格顶端一行居中位置的文字。

group_n^†

（即group1、group2等等）如果被指定，文字会显示在位于list_n左侧的抬头单元格中。如果被省略，list_n占用表格的全部宽度。

list_n^†

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

image^†

一张图片，会显示在标题（title）之下、主体（group/list）之右侧的一个单元格中。为使图片能正确地显示，必须指定list1参数。image参数接受标淮的维基代码来显示图片，即：

image = [[File:Example.jpg|100px]]

imageleft^†

一张图片，会显示在标题（title）之下、主体（list）之左侧的一个单元格中。为使图片能正确显示，必须指定list1参数，而且不能指定分组（group）。imageleft参数接受标淮的维基代码来显示图片，即：

imageleft = [[File:Example.jpg|100px]]

above^†

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

below^†

一个全宽度单元格，显示在该模板主体（group、list和image）的下方。在一个不带图片的模板中，below与该模板最后面的不带group_n参数的list_n参数以同样的方式运作。作为一个使用了below参数的示例，请参见{{非洲}}。

样式参数

一般不建议更改样式，以保持模板和网页的一致性。然而，修改样式的选项还是有的。

style^†

指定应用到模板主体的CSS样式。bodystyle参数也有下面举例的同样效果，并能被用来代替这个style参数。此选项应谨慎使用，因为它可以导致视觉上的不一致。举例：

style = background:#nnnnnn;

style = width:N [em/%/px or width:auto];

style = float:[left/right/none];

style = clear:[right/left/both/none];

titlestyle^†

应用到title的CSS样式，最常见的有导航栏的背景颜色：

titlestyle = background:#nnnnnn;

titlestyle = background:name;

groupstyle^†

应用到groupN单元格的CSS样式。该选项覆写应用于整个表格的任何样式。举例：

groupstyle = background:#nnnnnn;

groupstyle = text-align:[left/center/right];

groupstyle = vertical-align:[top/middle/bottom];

liststyle^†

应用到所有list的CSS样式。若指定了下面的oddstyle和evenstyle参数，则它们的优先级高于本参数。

oddstyle

evenstyle

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

abovestyle^†

belowstyle^†

CSS样式，应用到顶端单元格（通过above参数指定）和底端单元格（通过below参数指定）。典型地被用来设置背景颜色或文本对齐方式：

abovestyle = background:#nnnnnn;

abovestyle = text-align:[left/center/right];

缺省样式

这里列出的样式设置是使用导航框的编辑者最经常更改的那些设置。其他更加复杂的样式设置被排除在这个列表之外，以保持它简单。大多数样式是在MediaWiki:Common.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;

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

表格布局

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

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

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

技术细节

• 此模板为其大部分外观使用CSS类，因此它完全可以更换皮肤。
• 欲了解更多技术细节请参见其讨论页、MediaWiki:common.css中的CSS类以及MediaWiki:common.js中用来隐藏框体的可折迭表格。

运作详情

• 列表单元格宽度初始被设置为100%。因此，如果你想手动设置分组单元格的宽度，你就需要同时指定liststyle使之有width:auto。如果你想设置分组宽度并使用图片，这取决于你已弄明白在groupstyle、liststyle、imagestyle和imageleftstyle参数中的CSS，以使所有部件都工作正常。以下两行是设置分组宽度的示例：

groupstyle = width:10em;

liststyle = width:auto;

• 相邻的导航框在它们之间仅有一个1px的边框（除了在IE6中，因其不支持必需的CSS）。如果你设置了style/bodystyle的顶端外边距（top margin）或底顶端外边距（bottom margin），那么此特性就不运作了。
• 外层导航框表格的缺省的左外边距（margin-left）和右外边距（margin-right）被设置为“auto;”。如果你想使用导航框作为一个浮动对象（float），你需要手动设置左外边距和右外边距的值，因为自动外边距（auto margins)会阻止浮动（float）选项。例如，添加下列代码来使用导航框作为一个浮动对象：

style = width:22em;float:right;margin-left:1em;margin-right:0em;