テンプレート:Navbox generic/doc

提供: Yourpedia
2007年10月13日 (土) 00:25時点におけるKoto (トーク | 投稿記録)による版

移動: 案内検索
Tech Doc このページは、テンプレートの解説ページです。このページを直接参照すると、リンク先のページ名やURLを変数で指定しているリンク赤リンクになる場合がありますが、リンク先を指定し直さなくてよい場合もあります。リンクの設定の不具合に関する質問等は親ページの会話ページに投稿して下さい。

このテンプレートは、ナビゲーション用のテンプレートの応用です。このテンプレートを使用することによって、テンプレート内にリストを形成することができます。

フォーマット

{{Navbox generic
|name       = {{subst:PAGENAME}}
|state      = 
|titlestyle = background:
|title      = 
|imageleft  =
|imageright =  
|bodystyle  =   <!--(もしくは "style =" ただしこれは、ほかのstyleパラメータを一切使用しない場合)-->
|groupstyle = 
|liststyle  = 
|oddstyle   = 
|evenstyle  = 

|abovestyle = 
|above      = 

|group1 = 
|list1  = 

|group2 = 
|list2  = 

|group3 = 
|list3  = 

 ...

|group20 = 
|list20  = 

|belowstyle = 
|below      = 
}}

パラメータ

必須

name (または templateName)
テンプレートの名称です。テンプレートに表示される「表・話・編・履」のリンク先を適切に表示するために必要になります。{{subst:PAGENAME}} と入力すると簡単です。
title 
タイトルバーの部分に表示される文字列です。多くはテンプレートの主題、内容を総括した語が入ります。1行で書く必要がありますが、もし2行目が必要な場合は テンプレート:tl:- を使用してください。
背景色の初期値は #ccf#ccccff の短縮記法)になっています。後述する titlestyle パラメータで変更可能です。
listn
(i.e. list1, list2, etc.) テンプレートの本体で、ふつうはリンクのリストを記述します。書式はインラインですが、全体を <div> </div> で囲むことで複数行に分けて書くことができます。最低1つの list パラメータが必要で、追加の list はテーブル内の別の行として表示されます。必要であれば、それぞれの listn の直前に、対応する groupn パラメータを置くことができます(後述)。
リスト部およびテーブル全体の背景色は、初期値が #f9f9f9 になっています。後述する bodystyleoddstyle および evenstyle で変更可能です。

オプション

セル

groupn
(i.e. group1, group2, etc.) これが記述されると、listn とした部分の左に乱しセル画表示されます。省略すると、リスト部はテーブルの幅をすべて使って表示されます。
背景色の初期値は #ddf になっています。後述するgroupstyle パラメータで変更可能です。
グループの中に更にグループを作りたい場合は、{{Navbox generic subgroup}}を併用してください。
imageright
(or image)画像を、タイトルの直下・リスト部の右側に表示します。正常に表示するためには list1 パラメータを指定しておく必要があります。このパラメータは普通に画像を表示する際の wiki テキストをそのまま使います(例: [[画像:Example.jpg|100px]]<code>)。
テンプレートを画面右端一杯まで表示しない場合、画像が右側にはみ出て表示されてしまいます。これを防ぐためには、画像の wiki テキストに right パラメータを指定してください(例: <code>[[画像:Example.jpg|80px|right]]<code>)。
imageleft
画像を、タイトルの直下・リスト部の左側に表示します。正常に表示するためには list1 パラメータを指定しておく必要があります。このパラメータは普通に画像を表示する際の wiki テキストをそのまま使います(例: <code>[[画像:Example.jpg|100px]]<code>)。
above
(or top) 1行分のセルを、タイトルと最初のグループ・リスト部の間に表示します。画像を使わないテンプレートでは、 abovegroup1 を指定しない場合の list1 と同じような表示になります。
below
(or bottom) テンプレートの一番下に、1行分のセルを表示します。画像を使わないテンプレートでは、 below は最後の listn パラメータを groupn を使わずに表示した場合と同じような表示になります。below パラメータの使用例は en:Template:Lists of the provinces and territories of Canada をご覧ください。

テンプレートスタイル

titlestyle
(or title_style, titlebkg, color) CSS styles to apply to title, specifically the titlebar's background color. At present, use as follows:
<code>titlestyle = background:name or #nnnnnn
Use of this parameter is discouraged. Where it is used, care and consensus are needed as multiple navigational templates on one page with different background colors will probably look unpleasant.
bodystyle もしくは style
Specifies CSS styles to apply to the template body. The shorter name style may be used when no other style parameters are specified. This option should be used sparingly as it can lead to visual inconsistencies. Examples:
background:#nnnnnn;
text-align:[right/center/left/justified];
width:N [em/%/px or width:auto];
float:[left/right/none];
clear:[right/left/both/none];
groupstyle
(or group_style, group-style) CSS styles to apply to the groupN cells. This option overrides any styles that are applied to the entire table. Examples:
background:#nnnnnn;
text-align:[left/center/right];
vertical-align:[top/middle/bottom];
white-space:nowrap;
abovestyle
belowstyle
(or above_style, top-style; below_style, bottom-style) CSS styles to apply to the top cell (specified via the above parameter) and bottom cell (specified via the below parameter). Typically used to set background color or text alignment:
background:#nnnnnn;
text-align:[left/center/right];
liststyle
CSS styles to apply to all lists. Overruled by the oddstyle and evenstyle parameters (if specified) below.
oddstyle
evenstyle
(or odd-style, even-style) CSS styles to apply to the odd-numbered list items (list1, list3, etc) or even-numbered list items (list2, list4, etc), respectively. Typically used to set background color (background:#nnnnnn;) in order to achieve an alternating background color between odd and even-numbered lists; see {{Turkey-related topics}} for an example.

その他

state
デフォルトは autocollapse です。これを collapsed にすると、最初は必ず折りたたまれた状態で表示されます。空白を指定するか、 autocollapsecollapsed 以外の値を指定すると、最初は展開された状態で表示されます。autocollapse を指定すると、ページ内に2つかそれ以上の collapsible クラスを使用したテーブルがある場合には折りたたまれた状態で表示され、1つの場合は展開されて表示されます。技術的なことについてはMediaWiki:Common.jsを参照。
To specify different states for transcluding articles, set state to {{{state<includeonly>|autocollapse</includeonly>}}}. Then, in an article, set this parameter to a value described above. For example, {{templateName|state=}} will expand the template.

レイアウト

表示例

コード

{{navbox generic
|name=家庭用ゲーム機メーカ
|title=[[コンシューマーゲーム|家庭用ゲーム機メーカ]]
|style=text-align:left;
|group1=主要メーカ
|list1=[[任天堂]] - [[ソニー・コンピュータエンタテインメント]] - [[マイクロソフト]] - [[セガ]] - 
[[日本電気ホームエレクトロニクス|NECホームエレクトロニクス]]
|group2=その他メーカ
|list2=[[エポック社]] - [[バンダイ]] - [[SNK]] - [[アタリ (企業)|アタリ]]
}}

本体

関連項目

ナビゲーションテンプレート対照
 表示  折畳モード タイトル色 画像 グループ スタイル
パラメータ
例テンプレート
{{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%