模板:Imbox/doc

這個是圖片信息框（image message box，imbox）元模板。

它被用來創建用於圖像頁的信息框模板，像{{EU image}}等。它提供了幾種不同的顏色；如果沒有給出圖片參數，它將使用缺省的圖片；它還有一些其他的特性。

本模板幾乎完全像{{ambox}}一樣工作，並且使用同樣的參數。

用法

簡單應用的例子：

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

一些文字。

複雜一些的例子：

{{imbox
| type      = style
| image     = [[File:Emblem-question-yellow.svg|40px]]
| style     = width: 400px; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = 消息框的主体文字。
}}

消息框的主體文字。

圖像信息框類型

下列示例使用了不同的type參數，但沒有使用圖片參數，因而它們使用了每個類型對應的缺省的圖片。

type=speedy – 速刪模板，如{{isd}}。

type=delete – 刪除類模板，如{{ifd}}。

type=content – 較嚴重的警告和問題，如{{non-free reduce}}。

type=style – 較輕的警告和問題，如{{cleanup-image}}。

type=notice – 注意以及任意種類的信息，包括永久性的和臨時性的。

type=move – 移動/重命名信息和提議，如{{rename media}}。

type=protection – 頁面保護模板，如{{pp-protected}}，當其顯示在一個圖像頁時。

type=license – 許可模板，如{{GFDL}}。

type=featured – 特色圖片模板，如{{FeaturedPicture}}。

其他圖片

上面展示的缺省圖片大多是為了方便使用。在許多情況下，使用更加特定的圖片可能更合適。下面這些例子使用了image參數來指定一個圖片，而不是使用缺省的圖片。

type = style
image = [[File:Gnome-dev-camera.svg|42px]]
此圖片用於{{cleanup-image}}。

type = move
image = [[File:To Commons.svg|52px]]
此圖片用於{{copy to Wikimedia Commons}}。

type = license
image = [[File:Heckert GNU white.svg|48px]]
此圖片用於GFDL license模板，如{{GFDL}}。

特殊設定

一些其他的參數組合。

未給出type和image(default)

未給出type，並且image=none – 不使用圖片，而且text佔用整個信息框區域。

type = license
image = [[File:PD-icon.svg|40px]] <br> [[File:Ambox warning yellow.svg|40px]]
imageright = [[File:Shuttle.svg|30px]]

此文件是在公有領域，因為它是由美國太空總署創建的。
請注意，使用NASA標誌、徽章和徽標受美國法律的約束。

參數說明

所有參數的列表：

{{imbox
| type  = speedy / delete / content / style / notice / 
          move / protection / license / featured
| image = none / [[File:Some image.svg|40px]]
| imageright = [[File:Some image.svg|40px]]
| style = CSS取值
| textstyle = CSS取值
| text  = 消息框的主体文字。
}}

type: 如果未給出type參數，本模板缺省使用notice類型。那意味着它會有一個藍色的邊框。

image

不帶此參數 = 如果未給出image參數，則本模板使用一個缺省的圖片。至於是哪一個缺省圖片則取決於type參數。

一幅圖片 = 應當是帶常見的維基標記的一幅圖片。通常設置為40px - 50px寬比較合適，這取決於圖像的長寬比。（但是此消息框能夠處理任意尺寸的圖片。）例如：

image = [[File:Gnome-dev-camera.svg|40px]]

none = 意味着不使用圖片。

imageright

不帶此參數 = 如果未給出imageright參數，那麼右側不會顯示圖片。

一幅圖片 = 應當是帶常見的維基標記的一幅圖片。通常設置為40px - 50px寬比較合適，這取決於圖像的長寬比。（但是此消息框能夠處理任意尺寸的圖片。）例如：

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

任意內容 = 任意其他的你想顯示在右側的對象。

style

一個可選的CSS取值，被整個消息框表格所用。不帶引號" "。例如：

style = margin-bottom: 0.5em;

textstyle

一個可選的CSS取值，被文本單元格所用。例如：

textstyle = text-align: center;

text: 消息框的主體文字。

技術細節

如果你需要在text參數中使用一些特殊字符的話，那麼就需要像這樣將它們換碼：

{{imbox
| text  = <div>
等号 = 与前后大括号{ }可以正常地使用。
但是管道符{{!}}与两个连着的后大括号<nowiki>}}</nowiki>则不能直接使用。
一起用同样要带nowiki标记<nowiki>|}}</nowiki>。
</div>
}}

等號 = 與前後大括號{ }可以正常地使用。但是管道符|與兩個連着的後大括號}}則不能直接使用。一起用同樣要帶nowiki標記|}}。

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

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

此元模板所用的缺省圖片用的是png格式的，而不是svg格式。其主要原因是在處理MediaWiki為svg圖片所渲染的透明背景時，一些老版本的網絡瀏覽器會遇到一些麻煩。這裏的png格式圖片有手工優化過的透明背景顏色，因而在所有的瀏覽器中它們看上去都是好的。請注意，svg圖標只會在一些老版本的瀏覽器中看上去有點不對頭，因此只有那些非常廣泛使用的圖標才值得費些功夫去做那種手工優化。

更多的技術細節參見討論頁以及下方的#參見一節。

參見

在消息框（mbox）家族中有好幾個元模板：

{{ambox}} – 用於條目消息框。
{{tmbox}} – 用於討論頁消息框。
{{imbox}} – 用於圖像頁消息框。
{{cmbox}} – 用於分類消息框。
{{ombox}} – 用於其他頁面消息框。
{{fmbox}} – 用於頁眉和頁腳消息框。
{{mbox}} – 有名字空間探測功能。某些消息框會用在幾類頁面並因此需要依據所用在的頁面來改變風格，這種情況下的消息框可以用此元模板。