Template:Ambox

テンプレートの解説表示編集履歴キャッシュを破棄

メッセージボックス メタテンプレート
テンプレート	対象
{{Ambox}}	記事
{{Cmbox}}	カテゴリ
{{Imbox}}	ファイル
{{Tmbox}}	ノート
{{Fmbox}}	フッタ / ヘッダ
{{Ombox}}	その他
{{Mbox}}	自動判別
{{Asbox}}	記事スタブ
{{Dmbox}}	曖昧さ回避

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 を自由に記述可能ですが、Wikipedia:色の使用の考慮も検討してください

{{ambox|type=style|text=この記事は、一部ブラウザで正しく表示されない可能性があります。 全てのブラウザで正しく表示されるよう記事を修正してください。|textstyle=color:#ff8082;}}

技術情報

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

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

カテゴリ

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

カテゴリ	ソートキー	説明
記事メッセージボックス	テンプレート名またはデフォルトソート	適切に name パラメータが設定された場合、テンプレート名前空間で有効になります。
パラメータ指定の無い記事メッセージボックス	テンプレート名またはデフォルトソート	パラメータに不足がある場合、テンプレート名前空間で有効になります。

TemplateData

Ambox

記事名前空間向けのメッセージボックスを作成するためのメタテンプレートです。

テンプレートパラメーター[テンプレートデータを編集]

パラメーター		説明	型	状態
本文	text	メッセージボックスの本文。	内容	必須
種類（type）	type	左端の色と既定アイコンの選択。用途に応じて指定します。 値の候補 protection speedy delete content style move notice 既定 notice	文字列	省略可能
小型表示	small	「left」を指定すると小型（左寄せ）表示にします。テンプレート側でこの引数を受け渡すことで、記事側で |small=left が使えるようになります。 値の候補 no left 既定 no	文字列	省略可能
本文（小型表示用）	smalltext	small=left のときに表示する本文。未指定の場合は text の内容が使われます。	内容	省略可能
画像（左側）	image	メッセージボックス左側に表示する画像を指定します。未指定の場合は type に応じた既定画像が使われます。none=画像なし、blank=画像領域を空白のまま確保します。 例 [[ファイル:Icon apps query.svg|40px]]	文字列	省略可能
画像（右側）	imageright	メッセージボックス右側に表示する画像を指定します。 例 [[ファイル:Icon apps query.svg|40px]]	文字列	省略可能
小型表示用の左画像	smallimage	small=left のときに使用する左側画像を指定します。 例 [[ファイル:Icon apps query.svg|25px]]	文字列	省略可能
小型表示用の右画像	smallimageright	small=left のときにのみ右側に表示する画像を指定します。	文字列	省略可能
印刷時も表示	printable	空白以外（例：1）を指定すると印刷時にも表示されます。 例 1	文字列	省略可能
背景色	background	背景色をCSSの色指定で設定します。通常は指定非推奨です（テンプレート間の外観の統一に支障をきたすため）。	文字列	省略可能
外枠のスタイル（CSS）	style	Ambox全体に適用するCSSを指定します。 例 width:auto;	文字列	省略可能
本文のスタイル（CSS）	textstyle	本文領域に適用するCSSを指定します。	文字列	省略可能
対象（記事/節など）	sect	文言中の「この記事」を「この節」等に差し替えるための引数を指定します。 値の候補 {{{1|}}}	文字列	省略可能
ノート（トーク）	talk	ノート（トーク）ページへのリンクを制御します。節見出しやページ名（アンカー付き）を指定できます。 自動入力値 {{{talk|}}}	文字列	省略可能
date	date	説明なし	不明	省略可能
テンプレート名	name	テンプレート名（Template:名前 の「名前」部分）。	文字列	省略可能
subst	subst	テンプレートが誤って subst された場合を検出するための必須引数。通常はドキュメントにある定型のコードをそのまま渡します。 例 <includeonly>{{subst:substcheck}}</includeonly>	文字列	省略可能
問題点	issue	記事の問題点を簡潔に説明します。	内容	省略可能
改善方法	fix	改善のために何をすべきかを説明します。	内容	省略可能
cat	cat	説明なし	不明	省略可能
all	all	説明なし	不明	省略可能

関連項目

• {{ambox}} - 記事用
• {{tmbox}} - ノートページ用
• {{cmbox}} - カテゴリ用
• {{ombox}} - その他のページ用
• {{mbox}} - 名前空間を自動判定して表示形式を変えるメッセージボックス
• {{fmbox}} - ヘッダ／フッタ用
• {{dmbox}} - 曖昧さ回避用
• {{asbox}} - 記事スタブ用

• Wikipedia‐ノート:ウィキプロジェクト テンプレート/お知らせテンプレート - 日本語版の議論

この解説は、Template:Ambox/docから呼び出されています。 (編集 | 履歴)
編集者は、このテンプレートをサンドボックス (編集 | 差分)とテストケース (編集)で試すことができます。（解説）
/docのサブページにカテゴリを追加してください。 このテンプレートのサブページ一覧。