Template:Ambox

メッセージボックス; メタテンプレート
テンプレート	対象たいしょう
{{Ambox}}	記事きじ
{{Cmbox}}	カテゴリ
{{Imbox}}	ファイル
{{Tmbox}}	ノート
{{Fmbox}}	フッタ / ヘッダ
{{Ombox}}	その他た
{{Mbox}}	自動じどう判別はんべつ
{{Asbox}}	記事きじスタブ
{{Dmbox}}	曖昧あいまいさ回避かいひ

テンプレートの解説かいせつ[表示ひょうじ] [編集へんしゅう] [履歴りれき] [キャッシュを破棄はき]

このテンプレートは240,000以上いじょうのページで使つかわれています。
余計よけいな混乱こんらんやサーバーへの負荷ふかを避さけるために、どんな変更へんこうでも最初さいしょはテンプレートのサンドボックス・サブページ、テストケース・サブページもしくはあなた自身じしんの利用りよう者しゃスペースのページで試ためすべきです。そうすれば、試ためした変更へんこうを1度どの編集へんしゅうでこのテンプレートに加くわえることができます。しかし、最初さいしょにあなたの提案ていあんした変更へんこうを、この項目こうもくのノートで議論ぎろんするようにお願ねがいします。

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

モジュール:Message box

Ambox, Article Message Box（記事きじ用ようメッセージボックス）は、{{出典しゅってんの明記めいき}} 等とうの、記事きじに使用しようするお知しらせ用ようのテンプレートを作成さくせいするためのテンプレート（メタテンプレート）です。

Ambox にはその用途ようとに応おうじた6種類しゅるいの色いろが用意よういされています。画像がぞうの指定していは任意にんいですが、画像がぞう関連かんれんのパラメータが指定していされない場合ばあいは各かく色いろごとに規定きていの画像がぞうが表示ひょうじされます。

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

記事きじページにおいて、このテンプレートを用もちいて記事きじの編集へんしゅうについての注意ちゅうい事項じこうの記述きじゅつ（このページを編集へんしゅうする際さいには……）など、その記事きじがウィキペディアの一部いちぶであるという前提ぜんていに依拠いきょした使用しようはしないでください。詳くわしくはWikipedia:ウィキペディアへの自己じこ言及げんきゅうをご覧らんください。編集へんしゅう時じの注意ちゅういをしたい場合ばあいは、コメントアウトで記事きじのソース内ないに注意ちゅうい書がきを置おいてください。

使つかい方かた

単純たんじゅんな例れい：

{{Ambox | text = 文章ぶんしょうをここに}}

複雑ふくざつな例れい：

{{Ambox
| type  = style
| image = [[ファイル:Icon apps query.svg|35px]]
| imageright = [[ファイル:Icon apps query.svg|35px]]
| text  = メッセージボックスの本文ほんぶん
}}

一般いっぱん的てきな例れい：最低限さいていげん、必要ひつようと考かんがえられるパラメータを設定せっていした例れいです。組くみ合あわせによって、必要ひつようなパラメータが変かわる可能かのう性せいがあります。

{{Ambox
| name  = <!-- テンプレート名めい -->
| subst = <includeonly>{{subst:substcheck}}</includeonly>
| small = {{{small|}}}
| type  = 
| image = 
| sect  = {{{1|}}}
| issue = 
| talk  = {{{talk|}}}
| fix   = 
| date  = {{{date|}}}
| cat   = 
| all   = 
}}

パラメータ

パラメータの一覧いちらん
パラメータ	指定していする内容ないよう	既定きてい値ち	説明せつめい
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 / no	no	小型こがたタイプへのスタイル切きり替かえ。#small パラメータ: 小型こがたタイプとの切きり替かえ
printable	空白くうはく以外いがい。1 など		印刷いんさつ時じも表示ひょうじする。#その他たの設定せってい
style	CSS の記述きじゅつ		CSS による外観がいかんの細こまかい設定せってい。
background	#rrggbb / #rgb / 色いろの名前なまえ / transparent		背景はいけい色しょくの設定せってい。#その他たの設定せってい
text	任意にんいの文章ぶんしょう	（省略しょうりゃく不可ふか）	メッセージ本文ほんぶん。
smalltext	任意にんいの文章ぶんしょう	(text)	小型こがたタイプの場合ばあいに表示ひょうじするメッセージ本文ほんぶん。#small パラメータ: 小型こがたタイプとの切きり替かえ

type パラメータと色いろの対応たいおう

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

small パラメータ: 小型こがたタイプとの切きり替かえ

small パラメータにleftと指定していすると、小型こがたタイプに変化へんかします。

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

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

ノーマルタイプと小型こがたタイプで文章ぶんしょうを切きり替かえるには、smalltext パラメータを指定していします。

{{ambox
| small = {{{small|}}}
| text = ノーマルタイプの本文ほんぶん
| smalltext = 小型こがたタイプの本文ほんぶん
}}

旧来きゅうらいの節ふしタイプのように幅はばを端はしいっぱい長ながくしたい場合ばあいは以下いかのように指定していします。

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

画像がぞうの指定してい

上記じょうきの既定きていアイコンは簡便かんべんのために用意よういされていますが、多おおくの場合ばあいはより目的もくてきに合あう画像がぞうを選えらんだ方ほうが適切てきせつです。以下いかの例れいでは image-file パラメータを指定していし、既定きていアイコン以外いがいの特定とくていの画像がぞうを表示ひょうじしています。

画像がぞう指定してい方法ほうほうの詳細しょうさい

画像がぞうの指定していには、image パラメータを使用しようします。

image: [[ファイル:Unbalanced scales.svg|40px]] のように、普段ふだん画像がぞうを表示ひょうじするのと同おなじ方法ほうほうで指定していします。
smallimage: 小型こがたタイプの場合ばあいに指定していします。

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

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

image パラメータに特定とくていのキーワードを指定していすることで、画像がぞうを非ひ表示ひょうじにできます。

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

画像がぞうを右側みぎがわにも表示ひょうじさせられます。

imageright: image パラメータと同様どうようの使つかい方かたですが、キーワード指定していはありません。

問題もんだいと修正しゅうせい

issue引数ひきすうはその記事きじの問題もんだいを説明せつめいするのに使つかいます。短みじかく要点ようてんを書かき（英語えいご版ばんの説明せつめいで約やく10-20単語たんごとされる）、関係かんけいする方針ほうしんとガイドラインへのリンクを含ふくめます。

fix引数ひきすうは、その記事きじを改善かいぜんするためにすべきことは何なにかを説明せつめいします。issueの説明せつめいよりも長ながくなると思おもいますが、2行ぎょうを超こえないようにします。

テンプレートがコンパクト型がたで表示ひょうじされている場合ばあい（英語えいご版ばんでは{{複数ふくすうの問題もんだい}}内ないにある場合ばあい）、あるいは小型こがたの場合ばあい（|small=leftの使用しよう）issueだけが表示ひょうじされます。

その他たの設定せってい

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

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

style パラメータには、CSS を自由じゆうに記述きじゅつ可能かのうです。

技術ぎじゅつ情報じょうほう

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

この他ほかの技術ぎじゅつ的てき詳細しょうさいはノートページや関連かんれん項目こうもく以下いかにあるリンク先さきを参照さんしょうしてください。

カテゴリ

このテンプレートは、貼はり付づけられたページに次つぎのカテゴリを適用てきようします:

カテゴリ	ソートキー	説明せつめい
記事きじメッセージボックス	テンプレート名めいまたはデフォルトソート	適切てきせつに name パラメータが設定せっていされた場合ばあい、テンプレート名前なまえ空間くうかんで有効ゆうこうになります。
パラメータ指定していの無ない記事きじメッセージボックス	テンプレート名めいまたはデフォルトソート	パラメータに不足ふそくがある場合ばあい、テンプレート名前なまえ空間くうかんで有効ゆうこうになります。