Template:Navbox/doc

このテンプレートを使えば、リンク先リストをつくるだけでナビゲーション用テンプレートをかなり素早く作ることができるようになります. 多くのナビゲーションテンプレートでそのまま使えるスタイルがデフォルトで提供されています. デフォルトスタイルを変更することは可能ですが、推奨されていません. このテンプレートあるいは右の“Navbox一式”の姉妹テンプレートのいずれかを使うことが、ナビゲーション用テンプレートを標準化したり使いやすくしたりするために強く推奨されています. また、 を指定することにより、リストを * （アスタリスク）を使っての箇条書きで列挙することができます.

使用法
グループ数が少ない場合など、使わないパラメータは消去してください.

必須

 * name
 * テンプレートの名前は、テンプレートが使われている全てのページで「表・話・編・歴」（"表示・会話・編集・履歴"）リンクが正しく機能するために必須です. 値には を用いると便利です.


 * title
 * 表の最上部中央に表示されるテキストです. 通常はテンプレートの主題、つまり表本体の簡潔な説明です. これは一行でなければなりませんが、二行目が必要な場合は、センタリングが正しく行われる様、 を使ってください.


 * listn (body may be used in place of list1)
 * （list1、list2、など）テンプレート本体、通常はリンク先のリストです. 書式はインラインですが、 でリスト全体を囲めば複数行での入力もできます. 最低でもlistパラメータは一つ必要です. 以降のlistは、それぞれ表の別の行に表示されます. groupnパラメータが指定されていると、個々の listn の前にそのグループが表示されます （下記参照）.

セル

 * groupn
 * （group1、group2、など）指定されたテキストがlistnの左、ヘッダセルに表示されます. 指定がなければ、listnは表の全幅を使います.


 * image
 * タイトルバーの下、本体 (group/list) の右に指定された画像を表示します. list1の指定は適切な表示に必須です. 画像の指定には、
 * といった、画像表示に用いられる標準的ウィキコードを用います.
 * といった、画像表示に用いられる標準的ウィキコードを用います.


 * imageleft
 * タイトルバーの下、本体 (group/list) の左に指定された画像を表示します. list1の指定は適切な表示に必須です. 画像の指定には、
 * といった、画像表示に用いられる標準的ウィキコードを用います.
 * といった、画像表示に用いられる標準的ウィキコードを用います.


 * above
 * タイトルバーと最初の group/list との間、すなわちテンプレート本体（group、list または image）の above （上）に表示される全幅セルです. 画像のないテンプレートの場合、aboveはgroup1パラメータなしのlist1と同様に表示されます. above パラメータの使用例としては、Navbox Musical artistによる ビートルズ、サザンオールスターズ 、 Navbox with columns による アメリカ合衆国大統領 、Navboxによる 日本国憲法 などがあります（2013年9月現在）.


 * below
 * テンプレート本体（group、list または image）の below （下）に表示される全幅セルです. 画像のないテンプレートの場合、belowはgroupnパラメータなしの最後のlistnと同様に表示されます. below パラメータの使用例としては、Navbox Musical artist による ベートーヴェンの交響曲 、Navbox による イギリス国鉄の蒸気機関車 、 日本国歴代内閣総理大臣 などがあります（2013年9月現在）.

スタイル（推奨しない）
ウィキペディア全体でテンプレートとページの一貫性を保つため、デフォルト以外のスタイルの使用は推奨できません. しかし、必要がある場合に備えスタイルを変更するオプションが用意されています.

デフォルトスタイル
Navbox を使う際によく変更されるスタイルを示します. 他の、よりこみいったスタイルは一覧を単純にするため示していません.



liststyle と oddstyle は透明なので、偶数行は bodystyle と同色、デフォルトでは白です. グループがなく、 が指定されていないリストは  です. bodystyle だけに垂直アライメントがあるので、他の要素は を継承します.

その他

 * state [ ]
 * デフォルトは  です.   を設定すると、同一ページに折り畳み可能な表 （[隠す] リンクありの表、すなわち後述の  指定でも  指定でもない表） が複数ある場合には折り畳んで初期表示されますが、それ以外の場合は展開した状態で初期表示されます. 技術的詳細はMediaWiki:Common.jsを御覧ください.
 * 設定時に  と入力しないように注意してください.   とすると「,  ,  ,   以外の値」になってしまいます.
 * 空の値を入力した場合も になります.
 * を設定すると、Navbox は折り畳んだ状態で初期表示されます.
 * を設定すると、Navbox は右端に [隠す] リンクなしで展開された状態で表示され、タイトルはセンタリングされます.
 * を設定すると、Navbox は右端に [隠す] リンクなしで展開された状態で表示されますが、タイトルはセンタリングされません. これは上級者向けのオプションで、多くの場合  の使用で十分です.
 * ,,  ,   以外の値（例:  ）を設定すると、Navbox は [隠す] リンクありで展開された状態で初期表示されます.


 * 例: 建築 のデフォルト状態は autocollapse です. 建築家には Navbox が1つしかないので、展開表示されます. 一方、 都市計画 では autocollapse な Navbox が複数使われているので、閉じた状態で表示されます.
 * 初期状態をテンプレート作者の期待する Navbox の初期状態を記事で上書きできる様にする場合は、テンプレートに "state" という名前のパラメータを作成し、次の様にパススルーにします.


 * | により、テンプレート自身を表示する際には展開される様にできます.


 * navbar
 * デフォルトは  です.   を設定すると、タイトルバー左の  リンクは表示されません.


 * border
 * 指定可能な値には と があります. 既定値は空白です. と指定するとテンプレート全体の罫線が非表示になります. 任意のNavboxテンプレートをNavbox subgroupのように別のNavboxテンプレート(親Navbox)の中におけるリストの一つをしてネストしたい場合に と指定し、親Navboxの の部分にテンプレートを置きます. のように引数1に設定しても良い.


 * titlegroup
 * groupnセルと同じデフォルトスタイルのグループセルをタイトルの領域に挿入します. これは発展的なメタテンプレートのような例外的な状況でのみ使われるべきで、これを使う際には Navbox 内部のコードに関するいくつかの知識が必要ですが、もし使いたい場合は、全てにおいて正確に機能するために手動でCSSスタイルを設定するべきです. このパラメータの利用を考える場合は、あなた自身で変更するか、ノートページで始めに話し合ってください.


 * listclass
 * デフォルトは指定なしです. これを指定するとlistをFlatlistのように横リストとして表示することができますが、リストは「*」を用いた箇条書きで記述する必要があります. これはCommon.cssで指定されている hlist クラスを利用しています. 指定できる引数は次の通りです.
 * - 一般的な横リストを作成するときに使用します. 項目の区切りに「·」（中点（ラテン））を使います.
 * - 項目の区切りに「|」（バーティカルバー、パイプ記号）を使います.
 * - 項目の区切りに「-」（ハイフンマイナス）を使います.
 * このクラスが指定されていると、2階層以降のリスト階層ごとに「（ ）」（括弧）でくくられ、階層ごとに指定された項目の区切りで表示されます.

テーブルのレイアウト
Navboxを使い、image, above and below パラメータを指定せずに作成された表（境界は説明のために追加）:

Navboxを使い、image, above and below パラメータを指定して作成された表（境界は説明のために追加）:

Navboxを使い、image, imageleft, lists, and without groups, above, below パラメータを指定して作成された表:

画像なし


画像あり、グループなし


二画像、グループなし、複数リスト


画像、グループ、above, below あり


関連項目

 * ナビゲーションテンプレート
 * Category:ナビゲーションテンプレート
 * Category:メタテンプレート
 * WP:HLIST
 * Help:ダイナミック・ナビゲーション・ボックス