テンプレート:Ambox/doc

これはテンプレート:Amboxの解説サブページです。
使用方法、カテゴリ、およびその他テンプレートページ自体に含まれない情報を収容しています。

Luaモジュールを使用しています:

モジュール:Message box

Ambox, Article Message Box（記事用メッセージボックス）は、{{出典の明記}} 等の、記事に使用するお知らせ用のテンプレートを作成するためのテンプレート（メタテンプレート）です。

Ambox にはその用途に応じた6種類の色が用意されています。画像の指定は任意ですが、画像関連のパラメータが指定されない場合は各色ごとに規定の画像が表示されます。

このメタテンプレートは、MediaWiki:Common.css に記述された ambox 用の CSS クラスが適用された状態の雛形を提供するものです。これらの CSS クラスはこのテンプレートに限らず、パイプ構文で書かれた表内で直接使うこともできます。使用方法は en:Wikipedia:Ambox CSS classes を参照してください。

使い方

単純な例：

{{ambox | text = 文章をここに}}

テンプレート:ambox

複雑な例：

{{ambox
| type  = style
| image = [[File:Icon apps query.svg|35px]]
| imageright = [[File:Icon apps query.svg|35px]]
| text  = メッセージボックスの本文
}}

テンプレート:ambox

パラメータ

パラメータの一覧
パラメータ	指定する内容	既定値	説明
type	protection / speedy / delete / content / style / move / notice	notice	色と既定アイコンの選択。#type パラメータと色の対応
image	画像表示の記述。例: [[ファイル:Some image.svg\|40px]] / none / blank		Wiki構文による画像指定。#画像指定方法の詳細
imageright	画像表示の記述。例: [[ファイル:Some image.svg\|40px]]		Wiki構文による右側への画像指定。#画像指定方法の詳細
small	左に配置する場合はleft、右に配置する場合はright。		小型タイプへのスタイル切り替え。#small パラメータ: 小型タイプとの切り替え
printable	空白以外。1 など		印刷時も表示する。#その他の設定
style	CSS の記述		CSS による外観の細かい設定。* 廃止予定 *
background	#rrggbb / #rgb / 色の名前 / transparent		背景色の設定。#その他の設定
text	任意の文章	（省略不可）	メッセージ本文。
smalltext	任意の文章	(text)	小型タイプの場合に表示するメッセージ本文。#small パラメータ: 小型タイプとの切り替え

type パラメータと色の対応

type パラメータには以下の6種のいずれかの値を指定します。テンプレート左側の色は値により変化するので、用途によって使い分けてください。表示されている画像は、画像関連のパラメータを指定しない場合の、それぞれの値に既定のアイコン画像です。

テンプレート:ambox テンプレート:ambox テンプレート:ambox テンプレート:ambox テンプレート:ambox テンプレート:ambox テンプレート:ambox

small パラメータ: 小型タイプとの切り替え

small パラメータで左側の配置したい時はleft、右側に配置したい場合はrightと指定すると、小型タイプに変化します。

テンプレート:ambox

ひとつのテンプレートに、記事冒頭で使うタイプ（ノーマルタイプ）と小型タイプの両方の機能を持たせることもできます。テンプレートが small パラメータを受け取れるようにし、そのまま ambox の small パラメータに渡すだけです。

{{ambox
| small = {{{small|}}}
| text = テンプレート本文
}}

ノーマルタイプと小型タイプで文章を切り替えるには、smalltext パラメータを指定します。

{{ambox
| small = {{{small|}}}
| text = ノーマルタイプの本文
| smalltext = 小型タイプの本文
}}

テンプレート:ambox テンプレート:ambox

旧来の節タイプのように幅を端いっぱい長くしたい場合は以下のように指定します。

{{ambox
| style= width:auto;
| small = left
| text = ノーマルタイプの本文
| smalltext = 小型タイプの本文
}}

テンプレート:ambox

画像の指定

上記の既定アイコンは簡便のために用意されていますが、多くの場合はより目的に合う画像を選んだ方が適切です。以下の例では image-file パラメータを指定し、既定アイコン以外の特定の画像を表示しています。

テンプレート:ambox テンプレート:ambox テンプレート:ambox

画像指定方法の詳細

画像の指定には、image パラメータを使用します。

image: [[ファイル:Unbalanced scales.svg|40px]] のように、普段画像を表示するのと同じ方法で指定します。
smallimage: 小型タイプの場合に指定します。

{{ambox
| image = [[ファイル:Icon apps query.svg|50px]]
| text = ノーマルタイプ
| small = {{{small|}}}
}}

テンプレート:ambox

{{ambox
| smallimage = [[ファイル:Icon apps query.svg|25px]]
| smalltext = 小型タイプ
| small = left
}}

テンプレート:ambox

image パラメータに特定のキーワードを指定することで、画像を非表示にできます。

image = none: 画像を非表示にし、ボックス内をすべてテキスト用の領域とします。このキーワードのみ、image-file パラメータの指定よりも優先されます。
image = blank: 画像を非表示にしますが、本来の表示領域をそのまま空白として残します。複数の ambox を並べたときに、テキストの左揃えの位置を一致させることができます。

テンプレート:ambox テンプレート:ambox テンプレート:ambox

画像を右側にも表示させられます。

imageright: image パラメータと同様の使い方ですが、キーワード指定はありません。

テンプレート:ambox

その他の設定

printable パラメータに空白以外を指定すると、印刷時にもテンプレートが表示されるようになります。通常、お知らせ用のテンプレートは印刷時には必要ないものですが、法的・医学的な注意など印刷される必要のあるものも中には存在するので、そのような場合はこのパラメータを指定してください。

background パラメータを指定すると、ambox の背景色を変更できます。テンプレート間の外観の統一に支障をきたすため、強い警告以外での使用は推奨されていません。#rrggbb 形式や色名での指定など、CSS で色として指定できる文字列を設定します。

style パラメータには、CSS を自由に記述可能です。このパラメータはテンプレート間の外観の統一に支障をきたすため、廃止が予定されています。

技術情報

特殊な文字を text パラメータで使う場合は注意が必要です。中括弧 ( { } ) やパイプ ( | ) を使用する際は、<nowiki></nowiki> で囲むか、文字参照 ( { } → { }, | → |) を使うか、もしくはマジックワードやテンプレートを使って ( | → {{!}}) 、テンプレートの一部と見なされないようにする必要があります。中括弧は単独であれば（2つ以上連続したり、パイプと組み合わさったりしなければ）特に影響はありません。
このテンプレートの外観の大部分は CSS クラスで指定されているので、このテンプレートを使っているテンプレートは type パラメータの指定を変更するだけで枠線の色などを一括変更することが可能です。
テンプレート内部では、パイプ文法ではなく <table> タグ等を使用した XHTML マークアップを使っています。条件文中でパラメータ区切りのパイプと干渉するなど、パイプ文法にはいくつかの欠点があるので、メタテンプレートの作成には XHTML マークアップを使うのが通例です。

この他の技術的詳細はノートページや関連項目以下にあるリンク先を参照してください。