模板:Navbox

模板文檔[查看] [編輯] [查看歷史] [清除緩存]

本模板可快速建立一個導航模板，配備了默認樣式，能應付大多數導航模板。本模板也支持 {{Navbox subgroup}}、{{Navbox with collapsible groups}} 和 {{Navbox with columns}}。

用法

請移除置空不用的參數。

{{Navbox
| name       = {{subst:PAGENAME}}
| title      =
| listclass  = hlist
| state      = {{{state<includeonly>|autocollapse</includeonly>}}}

| above      =
| image      =

| group1     =
| list1      =

| group2     =
| list2      =

| group3     =
| list3      =

<!-- ... 最多 35 组 -->

| below      =
}}<noinclude>
{{navbox documentation}}
</noinclude>

參數列表

基本的和最常見的參數如下所示：

• name – 模板的名稱（"Template:" 後面的部分）
• title – 標題欄的文字
• listclass – list 單元格的 CSS 類，常設為 hlist（水平列表）或 plainlist（無符號列表）
• state – 方框的摺疊狀態（autocollapse / collapsed / expanded / plain / off）
• titlestyle – 標題欄的 CSS 樣式
• groupstyle – 分組單元格的 CSS 樣式
• above – 在 group/list 區段之上顯示的文字
• image – 可選的右側圖片
• imageleft – 可選的左側圖片（可與 group 同時使用）
• groupn – 左側的文字，在 list-n 之前
• listn – 列出維基鏈接的文字（最多支持 35 組）
• below – 在 group/list 區段之下顯示的文字

參數描述

設置參數

name

模板的名稱，用於"查·論·編"鏈接正確工作。可以輸入 {{subst:PAGENAME}} 作為快捷值。

state [autocollapse, collapsed, expanded, plain, off]

默認為 autocollapse。如果頁面上同時有兩個或更多可摺疊表格，則自動摺疊。

collapsed – 始終摺疊；expanded – 始終展開；plain – 展開且隱藏摺疊按鈕；off – 展開、無摺疊按鈕、無標題補白。

navbar

設置為 plain 隱藏"查·論·編"鏈接但保持標題居中；off 隱藏鏈接但不加補白。

border [child, subgroup, none]

設置為 child 或 subgroup 可將此導航框用作無邊框的子導航框嵌入到另一個導航框中。

單元格參數

title

顯示在表格頂端一行的標題文字，通常是該模板的主題。

above

標題欄與第一個 group/list 之間的全寬度單元格。

groupn

（group1～group35）顯示在 list_n 左側的抬頭單元格。如果省略，list_n 占用表格全部寬度。

listn

（list1～list35）模板的主體，每個導航框至少需要一個 list 參數。條目建議用 * 星號分行列出。

image

標題下方、主體右側的圖片。需同時指定 list1。

imageleft

標題下方、主體左側的圖片。需同時指定 list1。

below

主體下方的全寬度單元格。

titlegroup

【本站特有】在標題行左側顯示一個分組標籤。需配合 titlegroupstyle 和 titlegroupclass 使用。

樣式參數

bodystyle

應用到模板主體的 CSS 樣式。

basestyle

同時應用到 title、above、below 和 group 單元格（不應用到 list）。

titlestyle

應用到 title 的 CSS 樣式。

groupstyle

應用到所有 groupN 單元格的樣式。

groupnstyle

應用到特定 group 的樣式。

groupwidth

group 單元格的統一寬度。

liststyle

應用到所有 list 的樣式。oddstyle/evenstyle 優先於此參數。

listnstyle

應用到特定 list 的樣式。

listpadding

每個 list 單元格的內邊距。默認左右 0.25em。

list1padding

第一個 list 的專用內邊距，優先級高於 listpadding。

oddstyle / evenstyle

奇／偶數行的樣式。默認奇數透明、偶數淺灰。

style

應用到外容器表格的整體 CSS（與 bodystyle 類似）。

innerstyle

應用到內部表格的 CSS，僅在需要同時控制內外兩層表格樣式時使用。

evenodd [swap, even, odd, off]

控制奇偶行條紋：swap 反轉、even/odd 統一顏色、off 禁用。

abovestyle / belowstyle

above / below 單元格的樣式。

imagestyle / imageleftstyle

圖片單元格的樣式。

titlegroupstyle / titlegroupclass

【本站特有】titlegroup 單元格的樣式和 CSS 類。

nowrapitems

【enwiki 特性】設為 yes 時，列表項中由 */:/#/; 開頭的行將自動套用 <span class="nowrap">。

其他參數

bodyclass / listclass / groupclass / aboveclass / belowclass / titleclass / imageclass / navboxclass

對應單元格的 CSS 類。

listnclass

每個 list 獨立的 CSS 類（如 list1class、list2class 等）。

groupnstyle

每個 group 獨立的 CSS 樣式（如 group1style、group2style 等）。

listnstyle

每個 list 獨立的 CSS 樣式（如 list1style、list2style 等）。

templatestyles / child templatestyles

自定義 TemplateStyles 頁面，用於覆蓋或補充默認樣式。

nocat

設為 true 可禁用追蹤分類。

tracking

設為 no 可禁用水平列表追蹤分類。

子導航框

可以在一個導航框中嵌入多個子導航框。將 list 參數的值設為 child 或 subgroup，然後以 子编号_参数名 的形式指定子導航框的參數：

{{Navbox
| name = {{subst:PAGENAME}}
| title = 标题

| group1 = 分组1
| list1  = list1 内容

| group2 = 分组2
| list2  = child
  | 2_group1 = 子分组2.1
  | 2_list1  = 子列表2.1
  | 2_group2 = 子分组2.2
  | 2_list2  = 子列表2.2
}}

也可以使用嵌套模板方式：

{{Navbox
| name = {{subst:PAGENAME}}
| title = 标题
| list1 = {{Navbox|child
   ...子导航框参数...
}}
}}

子導航框也支持 type = with columns 和 type = with collapsible groups 來使用其他布局。

示例

不帶圖片

{{Navbox
|listclass=hlist
|name  = Navbox 示例
|title = 多媒体超级走廊（马来西亚）

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

|group2 = 区域
| list2 = 巴生谷

|group3 = 主要地标
| list3 = 
* 双子塔
* 吉隆坡电讯高塔
* 吉隆坡中央车站
* 布城
* 赛柏再也

|group4 = 基础设施
| list4 = 
* 快速铁路
* 吉隆坡-布城高速公路

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

帶圖片

{{Navbox
|listclass=hlist
|name  = Navbox 示例
|title = 多媒体超级走廊（马来西亚）
|image = [[File:Flag of Malaysia.svg|80px]]
|list1 = 
* 双子塔
* 吉隆坡电讯高塔
* 吉隆坡中央车站
* 布城
* 赛柏再也
* 吉隆坡国际机场
}}

技術細節

• "查·論·編"鏈接由 Module:Navbar 生成。
• 分組與列表之間 2px 寬的邊框使用列表單元格的左邊框（border-left）繪製。如果改變模板背景色，需同步調整邊框顏色。
• 相鄰導航框之間僅有 1px 邊框。設置 bodystyle 的上下外邊距會破壞此特性。
• 最多支持 35 組 group/list（group1～group35、list1～list35）。
• 直接調用 {{#invoke:Navbox|navbox}} 可替代 {{Navbox}}，減少模板展開大小。

模板數據

以下是該模板的模板數據，適用於可視化編輯器等工具。

Navbox模板數據

創建一個導航框，用於在頁面底部顯示相關頁面的鏈接。

模板參數

參數		描述	類型	狀態
模板名稱	name	模板的名稱，用於"查·論·編"鏈接正確工作 預設 {{subst:PAGENAME}}	不明	建議
標題	title	標題欄的文字，通常是導航模板的主題	不明	建議
摺疊狀態	state	控制導航框的摺疊行為 建議值 autocollapse collapsed expanded plain off 預設 autocollapse	不明	建議
列表CSS類	listclass	list單元格的CSS類，常設為 hlist 使用水平列表 範例 hlist	不明	非必填
分組1	group1	顯示在list1左側的標籤	不明	建議
列表1	list1	導航框的主體內容，至少需要一個list參數	不明	必填
分組2	group2	沒有描述	不明	非必填
列表2	list2	沒有描述	不明	非必填
分組3	group3	沒有描述	不明	非必填
列表3	list3	沒有描述	不明	非必填
分組4	group4	沒有描述	不明	非必填
列表4	list4	沒有描述	不明	非必填
分組5	group5	沒有描述	不明	非必填
列表5	list5	沒有描述	不明	非必填
上方內容	above	標題欄與第一個group/list之間的全寬度單元格	不明	非必填
下方內容	below	主體下方的全寬度單元格	不明	非必填
右側圖片	image	標題下方、主體右側的圖片	檔案	非必填
左側圖片	imageleft	標題下方、主體左側的圖片	檔案	非必填
標題分組	titlegroup	在標題行左側顯示一個分組標籤	不明	非必填
標題分組CSS類	titlegroupclass	沒有描述	不明	非必填
標題分組CSS樣式	titlegroupstyle	沒有描述	不明	非必填
不換行項目	nowrapitems	設為 yes 時列表項自動套用 nowrap 範例 yes	不明	非必填
導航欄狀態	navbar	控制"查·論·編"鏈接的顯示 範例 plain, off	不明	非必填
邊框模式	border	設為 child 或 subgroup 可嵌入到另一個導航框中 範例 child, subgroup, none	不明	非必填
主體樣式	bodystyle	沒有描述	不明	非必填
基礎樣式	basestyle	沒有描述	不明	非必填
標題樣式	titlestyle	沒有描述	不明	非必填
分組樣式	groupstyle	沒有描述	不明	非必填
列表樣式	liststyle	沒有描述	不明	非必填
分組寬度	groupwidth	沒有描述	不明	非必填
列表內邊距	listpadding	沒有描述	不明	非必填
奇數行樣式	oddstyle	沒有描述	不明	非必填
偶數行樣式	evenstyle	沒有描述	不明	非必填
奇偶行控制	evenodd	沒有描述 建議值 swap even odd off	不明	非必填
上方樣式	abovestyle	沒有描述	不明	非必填
下方樣式	belowstyle	沒有描述	不明	非必填
圖片樣式	imagestyle	沒有描述	不明	非必填
左側圖片樣式	imageleftstyle	沒有描述	不明	非必填
外容器樣式	style	應用到外容器表格的整體 CSS	不明	非必填
內部表格樣式	innerstyle	應用到內部表格的 CSS	不明	非必填
列表1內邊距	list1padding	第一個 list 的專用內邊距，優先級高於 listpadding	不明	非必填
主體CSS類	bodyclass	沒有描述	不明	非必填
分組CSS類	groupclass	沒有描述	不明	非必填
上方CSS類	aboveclass	沒有描述	不明	非必填
下方CSS類	belowclass	沒有描述	不明	非必填
標題CSS類	titleclass	沒有描述	不明	非必填
圖片CSS類	imageclass	沒有描述	不明	非必填
導航框CSS類	navboxclass	沒有描述	不明	非必填
自定義樣式頁	templatestyles	沒有描述	不明	非必填
子導航框樣式頁	child templatestyles	沒有描述	不明	非必填
禁用分類	nocat	設為 true 禁用追蹤分類	不明	非必填
追蹤控制	tracking	設為 no 禁用水平列表追蹤	不明	非必填

追蹤分類

• Category:孤立的子導航框（0）
• Category:沒有使用水平列表的導航框（0）
• Category:使用背景顏色的導航框（0）
• Category:使用邊框的導航框（0）
• Category:name參數和實際不同的導航框（0）
• Category:使用了 columns 但缺少第一列的導航框（0）

參見

• {{Navbox with collapsible groups}} – 可摺疊分組導航框
• {{Navbox with columns}} – 多列導航框
• {{Navbox subgroup}} – 子導航框
• {{Navboxes}} – 將多個導航框收納在一起
• {{Navboxes top}}

上述文檔嵌入自Template:Navbox/doc。（編輯 | 查看歷史）
編者可以在本模板的沙盒（創建 | 鏡像）和測試樣例（創建）頁面進行實驗。
請將分類添加至/doc子頁面。本模板的子頁面。