跳至內容

模板:Navbox/doc

勤求古訓，博采眾方

本模板可快速建立一個導航模板，配備了默認樣式，能應付大多數導航模板。本模板也支持 {{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）顯示在 listn 左側的抬頭單元格。如果省略，listn 占用表格全部寬度。
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
不明非必填
分組1group1

顯示在list1左側的標籤

不明建議
列表1list1

導航框的主體內容，至少需要一個list參數

不明必填
分組2group2

沒有描述

不明非必填
列表2list2

沒有描述

不明非必填
分組3group3

沒有描述

不明非必填
列表3list3

沒有描述

不明非必填
分組4group4

沒有描述

不明非必填
列表4list4

沒有描述

不明非必填
分組5group5

沒有描述

不明非必填
列表5list5

沒有描述

不明非必填
上方內容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 禁用水平列表追蹤

不明非必填

追蹤分類

參見


取自「https://test.zybkcn.com/w/index.php?title=Template:Navbox/doc&oldid=817」