模板:Ambox/doc

本模板是條目訊息框（article message box，ambox）模板所使用的元模板。

它用於創造文章訊息框模板例如{{wikify}}等。 它提供幾種不同的顏色，用於節省圖像，圖像參數，它有其他特點。

請注意：這個模板只用於在條目名字空間使用的模板，其他名字空間使用的模板請不要使用。

此元模板只是在MediaWiki:Common.css中有關條目訊息框的CSS類的簡單套用。

這些類可以直接使用在維基表格中，特別是在有特殊功能需求時：可參見其用法指南。

注意：

如果下方兩個訊息框看起來不一致，請刷新你的網頁瀏覽器緩存：

硬編碼的訊息框。

有時候此模板會出現暫時性的緩存錯誤。

使用方法

簡單應用的例子：

{{ambox | text = 一些文字。}}

複合應用的例子：

{{ambox
| type  = style
| image = [[File:Icon apps query.svg|38px]]
| text  = 消息框的主体文字。
}}

預設圖像

以下範例使用了不同的type參數，但沒有使用image參數，因而使用了各type（類型）所對應的預設圖像。

其他圖像

上方顯示的預設圖像是十分方便的，但在很多情況下需要使用特別指定的圖像。以下是一些使用image參數來指定其他圖像的案例：

特殊設定

此外，還有一些其他的參數。

參數

所有參數的列表：

{{ambox
| type  = serious / content / style / merge / growth / notice
| image = none / blank / [[File:Some image.svg|40px]]
| imageright = [[File:某幅图像.svg|40px]]
| text  = 消息框的主体文字。
}}

type

如果不指定type參數的話，會返回用於「條目注意」的預設類型notice的模板。這意味着會像上文中的簡單應用那樣產生一個藍色的邊框。

image

無參數 = 如果不指定image參數的話，會返回使用預設圖像的模板。至於是哪張預設圖像則取決於type參數。

一幅圖像 = 應該是一幅帶有常見維基符號的圖像。通常為40px－50px的寬度，這取決於圖像的長寬比。例如：

[[File:Unbalanced scales.svg|40px]]

none = 不使用圖像。

blank = 不使用圖像，但空出與預設圖像寬度相當的區域，這可以讓不使用圖像的訊息框與其他使用圖像的訊息框對齊。（見#特殊設定）

imageright

無參數 = 如果不指定imageright參數的話，會返回右側不帶圖像的模板。

一幅圖像 = 應該是一幅帶有常見維基符號的圖像。通常為40px－50px的寬度，這取決於圖像的長寬比。例如：

[[File:Nuvola apps bookcase.png|40px]]

其他內容 = 任何你想在模板右側顯示的其他內容。

text

訊息框的主體文字。

技術細節

如果你需要在text參數中適用一些特殊字符的話：

{{ambox
| text  = <div>
等号 = 与前后大括号{ }可以正常地使用。
但是管道符{{!}}与两个连接的后大括号<nowiki>}}</nowiki>则不能直接使用。
现在一起用来看看<nowiki>|}}</nowiki>。
</div>
}}

此模板使用CSS類來確定顯示風格，因此可被更換到其他風格。

在此元模板內使用了HTML的表格標示法，而沒有使用維基式的表格標示法。在製作元模板時這是一個常見的方法，因為維基式標示法存在一些缺陷。譬如，維基式標示法會加大模板擴展語法及參數中特殊字符使用的難度。

更多資訊，請參閱維基百科上的相同模板。