模板:Navbox

此模板使用Lua語言：

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 同時使用）
group_n – 左側的文字，在 list-n 之前
list_n – 列出維基鏈接的文字（最多支持 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 之間的全寬度單元格。
group_n: （group1～group35）顯示在 list_n 左側的抬頭單元格。如果省略，list_n 占用表格全部寬度。
list_n: （list1～list35）模板的主體，每個導航框至少需要一個 list 參數。條目建議用 * 星號分行列出。
image: 標題下方、主體右側的圖片。需同時指定 list1。
imageleft: 標題下方、主體左側的圖片。需同時指定 list1。
below: 主體下方的全寬度單元格。

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

樣式參數

bodystyle: 應用到模板主體的 CSS 樣式。
basestyle: 同時應用到 title、above、below 和 group 單元格（不應用到 list）。
titlestyle: 應用到 title 的 CSS 樣式。
groupstyle: 應用到所有 groupN 單元格的樣式。
group_nstyle: 應用到特定 group 的樣式。
groupwidth: group 單元格的統一寬度。
liststyle: 應用到所有 list 的樣式。oddstyle/evenstyle 優先於此參數。
list_nstyle: 應用到特定 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 類。
list_nclass: 每個 list 獨立的 CSS 類（如 list1class、list2class 等）。
group_nstyle: 每個 group 獨立的 CSS 樣式（如 group1style、group2style 等）。
list_nstyle: 每個 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 禁用水平列表追蹤	不明	非必填

追蹤分類

參見

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

上述文檔嵌入自Template:Navbox/doc。
編者可以在本模板的沙盒和測試樣例頁面進行實驗。
請將分類添加至/doc子頁面。本模板的子頁面。