差分

13,410 バイト追加 、 2018年9月11日 (火) 15:13
ページの作成:「<noinclude>{{Documentation subpage}}</noinclude>{{Lua|モジュール:Message box}} {{Mbox templates}} <!-- 以下でテンプレートの解説を編集してくださ…」
<noinclude>{{Documentation subpage}}</noinclude>{{Lua|モジュール:Message box}}
{{Mbox templates}}
<!-- 以下でテンプレートの解説を編集してください -->
'''Ambox''', '''A'''rticle '''M'''essage '''B'''ox(記事用メッセージボックス)は、{{Tl|出典の明記}} 等の、記事に使用するお知らせ用のテンプレートを作成するためのテンプレート('''メタテンプレート''')です。

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

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

== 使い方 ==
単純な例:

<pre style="margin:.5em 10%">{{Ambox | text = 文章をここに}}</pre>
{{Ambox | text = 文章をここに}}

複雑な例:

<pre style="margin:.5em 10%">{{Ambox
| type = style
| image = [[File:Icon apps query.svg|35px]]
| imageright = [[File:Icon apps query.svg|35px]]
| text = メッセージボックスの本文
}}</pre>
{{Ambox
| type = style
| image = [[File:Icon apps query.svg|35px]]
| imageright = [[File:Icon apps query.svg|35px]]
| text = メッセージボックスの本文
}}

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

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

{{Ambox
| type = protection
| text = type='''protection''' - {{Tl|保護}}や{{Tl|保護依頼}}などの保護中のお知らせ。
}}
{{Ambox
| type = speedy
| text = type='''speedy''' - {{Tl|即時削除}}や{{Tl|sdnd}}などの即時削除に関する告知。
}}
{{Ambox
| type = delete
| text = type='''delete''' - {{Tl|sakujo}}などの削除に関する告知。
}}
{{Ambox
| type = content
| text = type='''content''' - {{Tl|観点}}や{{Tl|国際化}}などの内容に関する注意。
}}
{{Ambox
| type = style
| text = type='''style''' - {{Tl|cleanup}}や{{Tl|wikify}}などのスタイル修正に関する注意。
}}
{{Ambox
| type = move
| text = type='''move''' - {{Tl|改名提案}}や{{Tl|字引}}などの記事の改名・分割・統合・Transwikiに関する提案。
}}
{{Ambox
| type = notice
| text = type='''notice''' - {{Tl|最新の出来事}}や{{Tl|工事中}}などの、その他一般のお知らせ。type パラメータの指定を省略するとこれが適用されます。
}}

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

{{Ambox
| type = style
| small = left
| text = テンプレート本文
}}

ひとつのテンプレートに、記事冒頭で使うタイプ('''ノーマルタイプ''')と小型タイプの両方の機能を持たせることもできます。テンプレートが small パラメータを受け取れるようにし、そのまま ambox の small パラメータに渡すだけです。
<pre style="margin:.5em 10%">{{Ambox
| small = {{{small|}}}
| text = テンプレート本文
}}</pre>

ノーマルタイプと小型タイプで文章を切り替えるには、'''smalltext''' パラメータを指定します。
<pre style="margin:.5em 10%">{{Ambox
| small = {{{small|}}}
| text = ノーマルタイプの本文
| smalltext = 小型タイプの本文
}}</pre>
{{Ambox
| small =
| text = ノーマルタイプの本文
| smalltext = 小型タイプの本文
}}
{{Ambox
| small = left
| text = ノーマルタイプの本文
| smalltext = 小型タイプの本文
}}

旧来の節タイプのように幅を端いっぱい長くしたい場合は以下のように指定します。
<pre style="margin:.5em 10%">{{Ambox
| style= width:auto;
| small = left
| text = ノーマルタイプの本文
| smalltext = 小型タイプの本文
}}</pre>
{{Ambox
| style= width:auto;
| small = left
| text = ノーマルタイプの本文
| smalltext = 小型タイプの本文
}}

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

{{Ambox
| type = content
| image = [[file:Unbalanced scales.svg|40px]]
| text = type = content<br/> image = [[file:Unbalanced scales.svg|40px]]<br/>この画像は{{Tl|観点}}などでよく使われます。
}}
{{Ambox
| type = style
| image = [[file:Wikitext.svg|40px]]
| text = type = style<br/> image = [[file:Wikitext.svg|40px]]<br/>{{Tl|wikify}}などでよく使われる画像です。
}}
{{Ambox
| type = move
| image = [[file:Merge-arrows.svg|40px]]
| text = type = move<br/> image = [[file:Merge-arrows.svg|40px]]<br/>{{Tl|統合提案}}などで使われる画像です。
}}

==== 画像指定方法の詳細 ====
画像の指定には、'''image''' パラメータを使用します。

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

<pre style="margin:.5em 10%">{{Ambox
| image = [[ファイル:Icon apps query.svg|50px]]
| text = ノーマルタイプ
| small = {{{small|}}}
}}</pre>
{{Ambox
| image = [[ファイル:Icon apps query.svg|50px]]
| text = ノーマルタイプ
| small =
}}
<pre style="margin:.5em 10%">{{Ambox
| smallimage = [[ファイル:Icon apps query.svg|25px]]
| smalltext = 小型タイプ
| small = left
}}</pre>
{{Ambox
| smallimage = [[ファイル:Icon apps query.svg|25px]]
| smalltext = 小型タイプ
| small = left
}}

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

{{Ambox
| image = none
| text = image = none<br />全領域にテキストを表示します。
}}
{{Ambox
| image = blank
| text = image = blank<br />画像の表示スペースが空白になります。
}}
{{Ambox
| text = 他の画像有りの ambox と並べたときにテキストが揃います。
}}

画像を右側にも表示させられます。
; imageright
: image パラメータと同様の使い方ですが、キーワード指定はありません。
{{Ambox
| image = [[ファイル:Gnome globe current event.svg|42px]]
| imageright = [[ファイル:Nuvola apps bookcase.svg|40px]]
| text = image = <nowiki>[[ファイル:Gnome globe current event.svg|42px]]</nowiki><br/>imageright = <nowiki>[[ファイル:Nuvola apps bookcase.svg|40px]]</nowiki>
}}

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

'''background''' パラメータを指定すると、ambox の背景色を変更できます。<strong style="color:#d33">テンプレート間の外観の統一に支障をきたすため、強い警告以外での使用は推奨されていません。</strong>#rrggbb 形式や[[:en:Web colors#HTML color names|色名]]での指定など、[[Cascading Style Sheets|CSS]] で色として指定できる文字列を設定します。

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

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

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

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

* [[:en:Wikipedia:Ambox CSS classes]] - [[Help:表の作り方|wikitable]] や [[:en:HTML element#Tables|HTML table]] で直接 ambox CSS classes を使う方法の記述(英語版)
* [[:en:Wikipedia:Article message boxes]] - article message box 作成に関する[[スタイルガイド]](英語版)
* [[:en:Wikipedia talk:Article message boxes]] - これらの問題に関する議論(英語版)
* [[Wikipedia‐ノート:ウィキプロジェクト テンプレート/お知らせテンプレート]] - 日本語版の議論<includeonly>

<!-- カテゴリは以下に追加してください -->
{{デフォルトソート:Ambox}}
[[Category:メタテンプレート]]
</includeonly>
匿名利用者