テンプレート:LoadBox/doc

[更新]

これは、メインのテンプレートページで参照されるべきである解説ページです。詳細についてはテンプレート:Documentationを参照してください。

LoadBoxの例 [開く] [編集]

このテンプレートは、別のページのコンテンツを読み込むことができるボックスを作成します。

使用法

{{LoadBox
|page=<page>
|title=<title>
|float=<float>
|class=<class>
|style=<style>
|titlestyle=<titlestyle>
|contentstyle=<contentstyle>
}}

page

読み込むコンテンツのページ名を指定します。（例：page=名前空間:記事/サブページ）

title

ボックスに表示されるタイトルを指定します（例：title=ボックスのタイトル）。titleを指定しなかった場合はエラーメッセージが表示されます。

float

任意。ボックスが配置される位置を指定します。有効な値は left（ボックスを左寄せで配置）または none（幅を最大まで広げる）の2つです。floatを指定しなかった場合、または有効な値ではない場合は、ボックスは右寄せで配置されます。style（以下に記載）でこの設定を上書きすることもできます。

class

任意。外側のボックスに追加する1つ以上のCSSクラスを指定します。

style

任意。ボックス全体に適用するスタイルを指定します。このパラメータの値は、中括弧や引用符のないCSS宣言でなければなりません。（例：style=background-color: yellow;）

titlestyle

任意。タイトルに適用するスタイルを指定します。このパラメータの値は、中括弧や引用符のないCSS宣言でなければなりません。（例：titlestyle=background-color: yellow;）

contentstyle

任意。読み込まれるコンテンツに適用するスタイルを指定します。このパラメータの値は、中括弧や引用符のないCSS宣言でなければなりません。（例：contentstyle=background-color: yellow;）

考慮すべき事項

生成されるボックスは、コンテンツが読み込まれる際に大きさが変動します。ボックスが重なったり、他のコンテンツが不適切にずれたりしないように {{-}} の使用を検討してください（例えば、上の使用法の節の前には {{-}} が使用されており、LoadBoxの例はその内容が読み込まれても、他のコンテンツに重なりません）。ただし、必ずしもLoadBoxの直後に {{-}} を使用する必要はありません。

代替の手段

The preferred method for initially hiding content that won't significantly impact server load times is a table with class="collapsible", because it keeps all of an article's content in one place.

LoadBox is intended for small article fragments which could impact server load times if placed in the article directly. For large article fragments, which could actually constitute article sections, consider {{LoadPage}}.