「テンプレート:Navbox with collapsible groups/doc」を編集中 (節単位)

== パラメータ ==
このテンプレートは姉妹テンプレートである {{tl|Navbox}} や {{tl|Navbox with columns}} と多くのパラメータを共有します。その共通のパラメータは短剣符<sup>'''†'''</sup>でマークされています。より多くの詳細な説明やそれらのパラメータの例がある {{tl|Navbox}} の解説も参照してください。

=== パラメータ ===
:; name<sup>†</sup>
:: テンプレートの名前は、テンプレートが使われている全てのページで「表・話・編・歴」（"表示・会話・編集・履歴"）リンクが正しく機能するために必須です。値には<code><nowiki>{{subst:PAGENAME}}</nowiki></code>を用いると便利です。
:; ''state''<sup>†</sup> <span style="font-weight:normal;">[<code>autocollapse, uncollapsed, collapsed, plain, off</code>]</span>
:* デフォルトは <code>autocollapse</code> です。<code>autocollapse</code> を設定すると、同一ページに折り畳み可能な表 （[隠す] リンクありの表、すなわち <code>plain, off</code> 以外を指定） が複数ある場合には折り畳んで初期表示されますが、それ以外の場合は展開した状態で初期表示されます。技術的詳細は[[MediaWiki:Common.js]]をご覧ください。
:* <code>collapsed</code> を設定すると、Navbox は折り畳んだ状態で初期表示されます。
:* <code>plain</code> を設定すると、Navbox は右端に [隠す] リンクなしで展開された状態で表示され、タイトルはセンタリングされます。
:* <code>off</code> を設定すると、Navbox は右端に [隠す] リンクなしで展開された状態で表示されますが、タイトルはセンタリングされません。これは上級者向けのオプションで、多くの場合 <code>plain</code> の使用で十分です。
:* <code>autocollapse</code>, <code>collapsed</code>, <code>plain</code>, <code>off</code> 以外の値（例: <code>uncollapsed</code>）を設定すると、Navbox は [隠す] リンクありで展開された状態で初期表示されます。

:: 初期状態をテンプレート作者の期待する Navbox の初期状態を記事で上書きできる様にする場合は、テンプレートに "state" という名前のパラメータを作成し、次の様にパススルーにします。
:: <tt><nowiki>| state = {{{state<includeonly>|希望する初期状態</includeonly>}}}</nowiki></tt>
:: 例: {{tl|建築}} のデフォルト状態は autocollapse です。 [[建築家]]には Navbox が1つしかないので、展開表示されます。一方、 [[都市計画]] には autocollapse な Navbox が2つあるので、閉じた状態で表示されます。<!-- テンプレートの使用状況が変わると例にならなくなるので時々チェックと差し替えが必要そうです。-->
:; ''navbar''<sup>†</sup>
:: デフォルトは <code>Tnavbar</code> です。<code>plain</code> を設定すると、タイトルバー左の {{Tnavbar|Navbox|mini=1|nodiv=1}} リンクは表示されません。
:; ''border''<sup>†</sup>
:: 指定可能な値には<code>child</code>と<code>none</code>があります。既定値は空白です。<code>child</code>と指定するとテンプレート全体の罫線が非表示になります。任意のNavboxテンプレートを{{tl|Navbox subgroup}}のように別のNavboxテンプレート(親Navbox)の中におけるリストの一つをしてネストしたい場合に<code>child</code>と指定し、親Navboxの<code>list</code>の部分にテンプレートを置きます。

=== 基本的なパラメータ ===
:; '''''title'''''<sup>†</sup>
:: 表の最上部中央に表示されるテキストです。通常はテンプレートの主題、つまり表本体の簡潔な説明です。これは一行でなければなりませんが、二行目が必要な場合は、センタリングが正しく行われる様、<code><nowiki>{{-}}</nowiki></code>を使ってください。
:; ''above''<sup>†</sup>
:: タイトルバーと最初の group/list との間、すなわちテンプレート本体（group、list または image）の ''above'' （上）に表示される全幅セルです。画像のないテンプレートの場合、''above''は''group1''パラメータなしの''list1''と同様に表示されます。
:; ''image''<sup>†</sup>
:: タイトルバーの下、本体 (group/list) の右に指定された画像を表示します。''list1''の指定は適切な表示に必須です。画像の指定には、
::: <code><nowiki>[[ファイル:Example.jpg|100px]]</nowiki></code>
:: といった、画像表示に用いられる標準的ウィキコードを用います。
:; ''imageleft''<sup>†</sup>
:: タイトルバーの下、本体 (group/list) の左に指定された画像を表示します。''list1''の指定は適切な表示に必須です。画像の指定には、
::: <code><nowiki>[[ファイル:Example.jpg|100px]]</nowiki></code>
:: といった、画像表示に用いられる標準的ウィキコードを用います。
:; ''below''<sup>†</sup>
:: テンプレート本体（group、list または image）の ''below'' （下）に表示される全幅セルです。画像のないテンプレートの場合、''below''は''group<sub>n</sub>''パラメータなしの最後の''list<sub>n</sub>''と同様に表示されます。''below'' パラメータの使用例は{{tl|イギリス国鉄の蒸気機関車}}を参照。

=== group/list パラメータ ===
:; ''group<sub>n</sub>''<sup>†</sup>
:: （''group1''、''group2''、など）指定されたテキストが''list<sub>n</sub>''の左、ヘッダセルに表示されます。指定がなければ、''list<sub>n</sub>''は表の全幅を使います。また、指定されたテキストでリンクアンカーが設定されます。[[Help:セクション]]も参照。
:; ''list<sub>n</sub>''<sup>†</sup>
:: （''list1''、''list2''、など）テンプレート本体、通常はリンク先のリストです。書式はインラインですが、<code><nowiki><div> </div></nowiki></code>でリスト全体を囲めば複数行での入力もできます。最低でも''list''パラメータは一つ必要です。以降の''list''は、それぞれ表の別の行に表示されます。 ''group<sub>n</sub>''パラメータが指定されていると、個々の ''list<sub>n</sub>'' の前にそのグループが表示されます。
:; ''abbr<sub>n</sub>''
:: <code>selected</code>で指定するgroupの値の略称。
:; ''selected''
:: <code>abbr</code>の値を指定すると該当するgroupのみが常時表示されます。<tt><nowiki>{{{1|}}}</nowiki></tt>と記述すると、記事に<nowiki>{{Navbox名|abbrの値}}</nowiki>を指定することで記事によって常時表示させるgroupを選ぶことができます。
:; ''state<sub>n</sub>'' <span style="font-weight:normal;">[<code>autocollapse, uncollapsed, collapsed, plain, off</code>]</span>
:: list<sub>n</sub>個別の折りたたみの状態を上記の4つから選べます。既定値は<code>collapsed</code>です。<code>selected</code>で指定した<code>abbr<sub>n</sub></code>に該当するlist<sub>n</sub>は常時表示されます。
:; ''image<sub>n</sub>''
:: list<sub>n</sub>の右側に表示する画像。
:; ''imageleft<sub>n</sub>''
:: list<sub>n</sub>の左側に表示する画像。

=== スタイルパラメータ ===
:; ''bodystyle''<sup>†</sup>
:: テンプレート全体に適用されるCSS属性。
:; ''titlestyle''<sup>†</sup>
:: タイトルバーに適用されるCSS属性。通常<code>background:''色名''</code>のように背景色の指定に使用します。内部リンクのテキスト色を変更したい場合は<code><nowiki>title = [[Scouting|<span style="color:ivory;">Scouting</span>]]</nowiki></code> のように指定します。[隠す]/[表示]ボタンのテキスト色も変更したい場合もbodystyleで指定します。
::: <code>titlestyle = background:darkgreen;color:ivory;</code>
:; ''abovestyle''<sup>†</sup>
:; ''belowstyle''<sup>†</sup>
:: ''above''、''below''それぞれに適用されるCSS属性。
:; ''basestyle''<sup>†</sup>
:: ''title''、''above''、''below''、''group<sub>n</sub>''に適用されるCSS属性。
:; ''imagestyle''<sup>†</sup>
:: ''image''に適用されるCSS属性。image<sub>n</sub>には適用されません。
:; ''imageleftstyle''<sup>†</sup>
:: ''imageleft''に適用されるCSS属性。imageleft<sub>n</sub>には適用されません。
:; ''groupstyle''<sup>†</sup>
:: groupに適用されるCSS属性。例:
::: <code>groupstyle = background:lightgreen;</code>
:; ''group<sub>n</sub>''style<sup>†</sup>
:: 特定のgroupに適用されるCSS属性。''groupstyle''の設定を上書きします。
:; ''liststyle''<sup>†</sup>
:: listに適用されるCSS属性。
:; ''list<sub>n</sub>''style<sup>†</sup>
:: 特定のlistに適用されるCSS属性。''liststyle''の設定を上書きします。
:; ''listpadding''<sup>†</sup>
:: listの上下左右の余白を設定します。