テンプレート:Navbox/doc

提供: Yourpedia
2009年10月30日 (金) 23:44時点におけるFromm (トーク | 投稿記録)による版

(差分) ←前の版 | 最新版 (差分) | 次の版→ (差分)
移動: 案内検索
Tech Doc このページは、テンプレートの解説ページです。このページを直接参照すると、リンク先のページ名やURLを変数で指定しているリンク赤リンクになる場合がありますが、リンク先を指定し直さなくてよい場合もあります。リンクの設定の不具合に関する質問等は親ページの会話ページに投稿して下さい。
お願い2008年8月23日 (土) 05:03 (UTC) の編集で、英語版と同様のテンプレートに更新されましたが、それに対応する解説文の更新がまだ完了していません。解説文の更新作業に協力して下さる方を求めています。

このテンプレートを使って、リンク先のリストからナビゲーション用のテンプレートを比較的容易に作れます。殆どのナビゲーションテンプレートで使えるデフォルトスタイルが予め定義されています。デフォルトスタイルの変更の推奨はしませんが、必要であれば可能です。

使用法[編集]

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

{{Navbox
|name    = {{subst:PAGENAME}}
|state   = 
|title   = 
|image   = 
|above   = 

|group1  = 
|list1   = 

|group2  = 
|list2   = 

 ...

|group20 = 
|list20  = 

|below   = 
}}

パラメータ[編集]

必須[編集]

name
テンプレートの名前は、テンプレートが使われている全てのページで「表・話・編・歴」("表示・会話・編集・履歴")リンクが正しく機能するために必須です。値には{{subst:PAGENAME}}を用いると便利です。
title
表の最上部中央に表示されるテキストです。通常はテンプレートの主題、つまり表本体の簡潔な説明です。これは一行でなければなりませんが、二行目が必要な場合は、センタリングが正しく行われる様、{{-}}を使ってください。
listn (body may be used in place of list1)
list1list2、など)テンプレート本体、通常はリンク先のリストです。書式はインラインですが、<div> </div>でリスト全体を囲めば複数行での入力もできます。最低でもlistパラメータは一つ必要です。以降のlistは、それぞれ表の別の行に表示されます。 groupnパラメータが指定されていると、個々の listn の前にそのグループが表示されます (下記参照)。

任意[編集]

セル[編集]

groupn
group1group2、など)指定されたテキストがlistnの左、ヘッダセルに表示されます。指定がなければ、listnは表の全幅を使います。
image
タイトルバーの下、本体 (group/list) の右に指定された画像を表示します。list1の指定は適切な表示に必須です。画像の指定には、
[[Image:Example.jpg|100px]]<code>
といった、画像表示に用いられる標準的ウィキコードを用います。
imageleft
タイトルバーの下、本体 (group/list) の左に指定された画像を表示します。list1の指定は適切な表示に必須です。画像の指定には、
<code>[[Image:Example.jpg|100px]]<code>
といった、画像表示に用いられる標準的ウィキコードを用います。
above
タイトルバーと最初の group/list との間、すなわちテンプレート本体(group、list または image)の above (上)に表示される全幅セルです。画像のないテンプレートの場合、abovegroup1パラメータなしのlist1と同様に表示されます。
below
テンプレート本体(group、list または image)の below (下)に表示される全幅セルです。画像のないテンプレートの場合、belowgroupnパラメータなしの最後のlistnと同様に表示されます。below パラメータの使用例は{{イギリス国鉄の蒸気機関車}}を参照。

スタイル(推奨しない)[編集]

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

デフォルトスタイル[編集]

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

<code>titlestyle = background:#ccccff;
bodystyle = background:white; width:100%; vertical-align:middle;
abovestyle = background:#ddddff; text-align:center;
belowstyle = background:#ddddff; text-align:center;
groupstyle = background:#ddddff; text-align:right;
liststyle = background:transparent; text-align:left/center;
oddstyle = background:transparent;
evenstyle = background:#f7f7f7;

liststyleoddstyle は透明なので、偶数行は bodystyle と同色、デフォルトでは白です。グループがなく、text-align:center;が指定されていないリストは text-align:left; です。bodystyle だけに垂直アライメントがあるので、他の要素はvertical-align:middle;を継承します。

その他[編集]

state [autocollapse, uncollapsed, collapsed, plain, off]
  • デフォルトは autocollapse です。autocollapse を設定すると、同一ページに折り畳み可能な表 ([隠す] リンクありの表、すなわち plain, off 以外を指定) が複数ある場合には折り畳んで初期表示されますが、それ以外の場合は展開した状態で初期表示されます。技術的詳細はMediaWiki:Common.jsを御覧ください。
  • collapsed を設定すると、Navbox は折り畳んだ状態で初期表示されます。
  • plain を設定すると、Navbox は右端に [隠す] リンクなしで展開された状態で表示され、タイトルはセンタリングされます。
  • off を設定すると、Navbox は右端に [隠す] リンクなしで展開された状態で表示されますが、タイトルはセンタリングされません。これは上級者向けのオプションで、多くの場合 plain の使用で十分です。
  • autocollapse, collapsed, plain, off 以外の値(例: uncollapsed)を設定すると、Navbox は [隠す] リンクありで展開された状態で初期表示されます。
初期状態をテンプレート作者の期待する Navbox の初期状態を記事で上書きできる様にする場合は、テンプレートに "state" という名前のパラメータを作成し、次の様にパススルーにします。
| state = {{{state<includeonly>|希望する初期状態</includeonly>}}}
例: {{イギリスの電車}} のデフォルト状態は autocollapse です。 クラス395電車には Navbox が一つしかないので、展開表示されます。一方、 ユーロスター クラス 373/TGV TMST には autocollapse な Navbox が二つあるので、閉じた状態で表示されます。
<includeonly>| により、テンプレート自身を表示する際には展開される様にできます。
navbar
デフォルトは Tnavbar です。plain を設定すると、タイトルバー左の  表示  リンクは表示されません。

テーブルのレイアウト[編集]

{{Navbox}}を使い、image, above and below パラメータを指定せずに作成された表(境界は説明のために追加):

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

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

使用例[編集]

画像なし[編集]

{{Navbox
|name   = Navbox/doc
|title  = [[:en:Multimedia Super Corridor|MSC (Multimedia Super Corridor) Malaysia]]{{-}}''without image''
|group1 = Centre
|list1  = [[:en:Cyberjaya]]
|group2 = Area
|list2  = [[:en:Klang Valley]]
|group3 = Major landmarks
|list3  = <div>
[[:en:Petronas Twin Towers]] - 
[[:en:Kuala Lumpur Tower]] - 
[[:en:Kuala Lumpur Sentral]] - 
[[:en:Technology Park Malaysia]] - 
[[:en:Putrajaya]] - 
[[:en:Cyberjaya]] - 
[[:en:Kuala Lumpur International Airport]]
</div>
|group4 = Infrastructure
|list4  = [[:en:Express Rail Link]] - [[:en:KL-KLIA Dedicated Expressway]]
|group5 = Prime applications
|list5  = [[:en:EGovernment]] - [[:en:MyKad]]  
}}

画像あり、グループなし[編集]

{{Navbox
|name  = Navbox/doc
|title = [[:en:Multimedia Super Corridor|MSC (Multimedia Super Corridor) Malaysia]]
|image = [[Image:Flag of Malaysia.svg|80px]]
|list1  = <div>
[[:en:Petronas Twin Towers]] - 
[[:en:Kuala Lumpur Tower]] - 
[[:en:Kuala Lumpur Sentral]] - 
[[:en:Technology Park Malaysia]] - 
[[:en:Putrajaya]] - 
[[:en:Cyberjaya]] - 
[[:en:Kuala Lumpur International Airport]]
</div>
}}

二画像、グループなし、複数リスト[編集]

{{Navbox
|name  = Navbox/doc
|title = [[:en:Multimedia Super Corridor|MSC (Multimedia Super Corridor) Malaysia]]
|image = [[Image:Flag of Malaysia.svg|80px]]
|imageleft = [[Image:Flag of Malaysia.svg|80px]]
|list1  = [[:en:Petronas Twin Towers]] - [[:en:Kuala Lumpur Tower]] - [[:en:Kuala Lumpur Sentral]]
|list2  = [[:en:Express Rail Link]] - [[:en:KL-KLIA Dedicated Expressway]]
|list3  = [[:en:EGovernment]] - [[:en:MyKad]]
|list4  = [[:en:Klang Valley]]
}}

画像、グループ、above, below あり[編集]

{{Navbox
|name  = Navbox/doc
|title = [[:en:Multimedia Super Corridor|MSC (Multimedia Super Corridor) Malaysia]]
|image = [[Image:Flag of Malaysia.svg|80px]]
|above = Above text goes here
|group1 = Centre
|list1  = [[:en:Cyberjaya]]
|group2 = Area
|list2  = [[:en:Klang Valley]]
|group3 = Major landmarks
|list3  = <div>
[[:en:Petronas Twin Towers]] - 
[[:en:Kuala Lumpur Tower]] - 
[[:en:Kuala Lumpur Sentral]] - 
[[:en:Technology Park Malaysia]] - 
[[:en:Putrajaya]] - 
[[:en:Cyberjaya]] - 
[[:en:Kuala Lumpur International Airport]]
</div>
|group4 = Infrastructure
|list4  = [[:en:Express Rail Link]] - [[:en:KL-KLIA Dedicated Expressway]]
|group5 = Prime applications
|list5  = [[:en:EGovernment]] - [[:en:MyKad]]
|below  = Website: [http://www.msc.com.my/ www.msc.com.my]
}}

関連項目[編集]

ナビゲーションテンプレート対照
 表示  折畳モード タイトル色 画像 グループ スタイル
パラメータ
例テンプレート
{{Navbox subgroup}} collapsible navbox No Yes Yes {{日本百名山}}
{{Navbox}} collapsible navbox Left/Right of body Yes Yes {{イギリスの電車}}
{{Navbox with columns}} collapsible navbox Left/right of columns No Yes {{都道府県知事}}
{{NavboxYears}}
{{NavboxYears2}}
collapsible navbox No No No {{全豪オープンテニス}}
{{Navbox with collapsible groups}} collapsible navbox Left/right of body and/or in each list Yes Yes {{日本近代地震}}
折畳属性
種類 CSSクラス Javascript 畳まれるとき Custom
initial state
ネスト タイトル色 フォントサイズ
Collapsible table collapsible, navbox Common.jsにて定義 2個以上 Yes No #ccccff 90%