このテンプレートを使えば、リンク先リストをつくるだけでナビゲーション用テンプレートをかなり素早く作ることができるようになります。多くのナビゲーションテンプレートでそのまま使えるスタイルがデフォルトで提供されています。デフォルトスタイルを変更することは可能ですが、推奨されていません。このテンプレートを使うことが、ナビゲーション用テンプレートを標準化したり使いやすくしたりするために強く推奨されています。
使用法
グループ数が少ない場合など、使わないパラメータは消去してください。
{{Navbox
|name = {{subst:PAGENAME}}
|listclass = hlist
|state =
|title =
|image =
|above =
|group1 =
|list1 =
|group2 =
|list2 =
...
|group20 =
|list20 =
|below =
}}
パラメータ
必須
- name
- テンプレートの名前は、テンプレートが使われている全てのページで「表・話・編・歴」（"表示・会話・編集・履歴"）リンクが正しく機能するために必須です。値には
{{subst:PAGENAME}}を用いると便利です。
- title
- 表の最上部中央に表示されるテキストです。通常はテンプレートの主題、つまり表本体の簡潔な説明です。これは一行でなければなりませんが、二行目が必要な場合は、センタリングが正しく行われる様、
{{-}}を使ってください。
- listn（body may be used in place of list1）
- （list1、list2、など）テンプレート本体、通常はリンク先のリストです。書式はインラインですが、
<div> </div>でリスト全体を囲めば複数行での入力もできます。最低でもlistパラメータは一つ必要です。以降のlistは、それぞれ表の別の行に表示されます。groupnパラメータが指定されていると、個々のlistnの前にそのグループが表示されます （下記参照）。
任意
セル
- groupn
- （group1、group2、など）指定されたテキストがlistnの左、ヘッダセルに表示されます。指定がなければ、listnは表の全幅を使います。
- image
- タイトルバーの下、本体（group/list）の右に指定された画像を表示します。list1の指定は適切な表示に必須です。画像の指定には、
-
[[ファイル:Example.jpg|100px]]
- といった、画像表示に用いられる標準的ウィキコードを用います。
- imageleft
- タイトルバーの下、本体 (group/list) の左に指定された画像を表示します。list1の指定は適切な表示に必須です。画像の指定には、
-
[[ファイル:Example.jpg|100px]]
- といった、画像表示に用いられる標準的ウィキコードを用います。
- above
- タイトルバーと最初のgroup/listとの間、すなわちテンプレート本体（group、listまたはimage）のabove（上）に表示される全幅セルです。画像のないテンプレートの場合、aboveはgroup1パラメータなしのlist1と同様に表示されます。
- below
- テンプレート本体（group、listまたはimage）のbelow（下）に表示される全幅セルです。画像のないテンプレートの場合、belowはgroupnパラメータなしの最後のlistnと同様に表示されます。
スタイル（推奨しない）
ウィキペディア全体でテンプレートとページの一貫性を保つため、デフォルト以外のスタイルの使用は推奨できません。しかし、必要がある場合に備えスタイルを変更するオプションが用意されています。
デフォルトスタイル
Navboxを使う際によく変更されるスタイルを示します。他の、より込み入ったスタイルは一覧を単純にするため示していません。
-
bodystyle = background-color:#fdfdfd; width:100%; vertical-align:middle
-
titlestyle = background-color:#ccccff; padding-left:1em; padding-right:1em; text-align:center
-
abovestyle = background-color:#ddddff; padding-left:1em; padding-right:1em; text-align:center
-
belowstyle = background-color:#ddddff; padding-left:1em; padding-right:1em; text-align:center
-
groupstyle = background-color:#ddddff; padding-left:1em; padding-right:1em; text-align:right
-
liststyle = background:transparent; text-align:left/center
-
oddstyle = background:transparent
-
evenstyle = background-color:#f7f7f7
liststyleとoddstyleは透明なので、偶数行はbodystyleと同色、デフォルトでは白です。グループがなく、text-align:centerが指定されていないリストはtext-align:leftです。bodystyleだけに垂直アライメントがあるので、他の要素はvertical-align:middleを継承します。
その他
- state [
autocollapse, collapsed, plain, off, uncollapsed]
- デフォルトは
autocollapseです。autocollapseを設定すると、同一ページに折り畳み可能な表（[隠す] リンクありの表、すなわち後述のplain指定でもoff指定でもない表） が複数ある場合には折り畳んで初期表示されますが、それ以外の場合は展開した状態で初期表示されます。技術的詳細はMediaWiki:Common.jsを御覧ください。
- 設定時に
autocollapsedと入力しないように注意してください。autocollapsedとすると「autocollapse, collapsed, plain, off以外の値」になってしまいます。
-
collapsedを設定すると、Navboxは折り畳んだ状態で初期表示されます。
-
plainを設定すると、Navboxは右端に[隠す]リンクなしで展開された状態で表示され、タイトルはセンタリングされます。
-
offを設定すると、Navboxは右端に[隠す]リンクなしで展開された状態で表示されますが、タイトルはセンタリングされません。これは上級者向けのオプションで、多くの場合plainの使用で十分です。
-
autocollapse, collapsed, plain, off以外の値（例：uncollapsed）を設定すると、Navboxは[隠す]リンクありで展開された状態で初期表示されます。
- 例：{{建築}}のデフォルト状態はautocollapseです。 建築家にはNavboxが1つしかないので、展開表示されます。一方、 都市計画ではautocollapseなNavboxが複数使われているので、閉じた状態で表示されます。
- 初期状態をテンプレート作者の期待するNavboxの初期状態を記事で上書きできる様にする場合は、テンプレートに"state"という名前のパラメータを作成し、次の様にパススルーにします。
- | state = {{{state<includeonly>|希望する初期状態</includeonly>}}}
- <includeonly>| により、テンプレート自身を表示する際には展開される様にできます。
- navbar
- デフォルトは
Tnavbarです。plainを設定すると、タイトルバー左の 表・話・編・歴 リンクは表示されません。
- border
- 指定可能な値には
childとnoneがあります。既定値は空白です。childと指定するとテンプレート全体の罫線が非表示になります。任意のNavboxテンプレートを{{Navbox subgroup}}のように別のNavboxテンプレート（親Navbox）の中におけるリストの一つをしてネストしたい場合にchildと指定し、親Navboxのlistの部分にテンプレートを置きます。{{Navbox|child|...}}のように引数1に設定しても良い。
- titlegroup
- groupnセルと同じデフォルトスタイルのグループセルをタイトルの領域に挿入します。これは発展的なメタテンプレートのような例外的な状況でのみ使われるべきで、これを使う際には{{Navbox}}内部のコードに関するいくつかの知識が必要ですが、もし使いたい場合は、全てにおいて正確に機能するために手動でCSSスタイルを設定するべきです。このパラメータの利用を考える場合は、あなた自身で変更するか、ノートページで始めに話し合ってください。
テーブルのレイアウト
{{Navbox}}を使い、image, above and belowパラメータを指定せずに作成された表（境界は説明のために追加）
|
{{{title}}} |
|---|
| | {{{group1}}} |
{{{list1}}} | | | {{{group2}}} |
{{{list2}}} | |
{{{list3}}} without {{{group3}}} | | | {{{group4}}} |
{{{list4}}} |
|
{{Navbox}}を使い、image, above and belowパラメータを指定して作成された表（境界は説明のために追加）
|
{{{title}}} |
|---|
| |
{{{above}}} | | | {{{group1}}} |
{{{list1}}} |
{{{image}}} | | | {{{group2}}} |
{{{list2}}} | |
{{{list3}}} without {{{group3}}} | | | {{{group4}}} |
{{{list4}}} | | |
{{{below}}} |
|
{{Navbox}}を使い、image, imageleft, lists, and without groups, above, belowパラメータを指定して作成された表
|
{{{title}}} |
|---|
| |
{{{imageleft}}} |
{{{list1}}} |
{{{image}}} | |
{{{list2}}} | |
{{{list3}}} | |
{{{list4}}} |
|
使用例
画像なし
{{Navbox
| name = Navbox/doc
| title = [[Multimedia Super Corridor|MSC Malaysia]]
| group1 = Centre
| list1 = [[Cyberjaya]]
| group2 = Area
| list2 = [[Klang Valley]]
| group3 = Major landmarks
| list3 = {{Nowrap begin}}[[Petronas Twin Towers]]{{・wrap}}[[Kuala Lumpur Tower]]{{・wrap}}[[Kuala Lumpur Sentral]]{{・wrap}}[[Technology Park Malaysia]]{{・wrap}}[[Putrajaya]]{{・wrap}}[[Cyberjaya]]{{・wrap}}[[Kuala Lumpur International Airport]]{{Nowrap end}}
| group4 = Infrastructure
| list4 = [[Express Rail Link]]{{・}}[[KL-KLIA Dedicated Expressway]]
| group5 = Prime applications
| list5 = [[EGovernment]]{{・}}[[MyKad]]
}}
|
MSC Malaysia |
|---|
| | Centre | | | | Area | | | | Major landmarks | | | | Infrastructure | | | | Prime applications | |
|
画像あり、グループなし
{{Navbox
| name = Navbox/doc
| title = [[Multimedia Super Corridor|MSC Malaysia]]
| image = [[File:Flag of Malaysia.svg|80px|link=|alt=]]
| list1 = [[Petronas Twin Towers]]{{・}}[[Kuala Lumpur Tower]]{{・}}[[Kuala Lumpur Sentral]]{{・}}[[Technology Park Malaysia]]{{・}}[[Putrajaya]]{{・}}[[Cyberjaya]]{{・}}[[Kuala Lumpur International Airport]]
}}
二画像、グループなし、複数リスト
{{Navbox
| name = Navbox/doc
| title = [[Multimedia Super Corridor|MSC Malaysia]]
| image = [[File:Flag of Malaysia.svg|80px|link=|alt=]]
| imageleft = [[File:Flag of Malaysia.svg|80px]]
| list1 = [[Petronas Twin Towers]]{{・}}[[Kuala Lumpur Tower]]{{・}}[[Kuala Lumpur Sentral]]
| list2 = [[Express Rail Link]]{{・}}[[KL-KLIA Dedicated Expressway]]
| list3 = [[EGovernment]]{{・}}[[MyKad]]
| list4 = [[Klang Valley]]
}}
画像、グループ、above, belowあり
{{Navbox
| name = Navbox/doc
| title = [[Multimedia Super Corridor|MSC Malaysia]]
| above = Above text goes here
| image = [[File:Flag of Malaysia.svg|80px|link=|alt=]]
| group1 = Centre
| list1 = [[Cyberjaya]]
| group2 = Area
| list2 = [[Klang Valley]]
| group3 = Major landmarks
| list3 = [[Petronas Twin Towers]]{{・}}[[Kuala Lumpur Tower]]{{・}}[[Kuala Lumpur Sentral]]{{・}}[[Technology Park Malaysia]]{{・}}[[Putrajaya]]{{・}}[[Cyberjaya]]
| group4 = Infrastructure
| list4 = [[Express Rail Link]]{{・}}[[KL-KLIA Dedicated Expressway]]
| group5 = Prime applications
| list5 = [[EGovernment]]{{・}}[[MyKad]]
| below = Website:http://www.msc.com.my/
}}
関連項目
