编辑“︁Template:Imbox/doc”︁

{{NoteTA|G1=MediaWiki}}
{{Documentation subpage}}
{{Lua|Module:Message box}}
{{High-use}}
{{Mbox templates}}
<!-- 在本行下編輯模板說明 -->
这个是图片信息框（'''i'''mage '''m'''essage '''box'''，'''imbox'''）元模板。

它被用来创建用于图像页的信息框模板，像{{tl|EU image}}等。它提供了几种不同的颜色；如果没有给出图片参数，它将使用缺省的图片；它还有一些其他的特性。

本模板几乎完全像{{tl|ambox}}一样工作，并且使用同样的参数。
== 用法 ==
简单应用的例子：
<syntaxhighlight lang="wikitext">
{{imbox | text = 一些文字。}}
</syntaxhighlight>

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

复杂一些的例子：
<syntaxhighlight lang="wikitext">
{{imbox
| type      = style
| image     = [[File:Emblem-question-yellow.svg|40px]]
| style     = width: 400px; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = 消息框的主体文字。
}}
</syntaxhighlight>

{{imbox
| type      = style
| image     = [[File:Emblem-question-yellow.svg|40px]]
| style     = width: 400px; 
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = 消息框的主体文字。
}}
== 图像信息框类型 ==
下列示例使用了不同的'''type'''参数，但没有使用图片参数，因而它们使用了每个类型对应的缺省的图片。
{{imbox
| type = speedy
| text = type=<u>speedy</u> – 速删模板，如{{tl|isd}}。
}}
{{imbox
| type = delete
| text = type=<u>delete</u> – 删除类模板，如{{tl|ifd}}。
}}
{{imbox
| type = content
| text = type=<u>content</u> – 较严重的警告和问题，如{{tl|non-free reduce}}。
}}
{{imbox
| type = style
| text = type=<u>style</u> – 较轻的警告和问题，如{{tl|cleanup-image}}。
}}
{{imbox
| type = notice
| text = type=<u>notice</u> – 注意以及任意种类的信息，包括永久性的和临时性的。
}}
{{imbox
| type = move
| text = type=<u>move</u> – 移动/重命名信息和提议，如{{tl|rename media}}。
}}
{{imbox
| type = protection
| text = type=<u>protection</u> – 页面保护模板，如{{tl|pp-protected}}，当其显示在一个图像页时。
}}
{{imbox
| type = license
| text = type=<u>license</u> – 许可模板，如{{tl|GFDL}}。
}}
{{imbox
| type = featured
| text = type=<u>featured</u> – 特色图片模板，如{{tl|FeaturedPicture}}。
}}

== 其他图片 ==
上面展示的缺省图片大多是为了方便使用。在许多情况下，使用更加特定的图片可能更合适。下面这些例子使用了'''image'''参数来指定一个图片，而不是使用缺省的图片。
{{imbox
| type  = style
| image = [[File:Gnome-dev-camera.svg|42px]]
| text  = type = style <br> image = <nowiki>[[File:Gnome-dev-camera.svg|42px]]</nowiki> <br> 此图片用于{{tl|cleanup-image}}。
}}
{{imbox
| type  = move
| image = [[File:To Commons.svg|52px]]
| text  = type = move <br> image = <nowiki>[[File:To Commons.svg|52px]]</nowiki> <br> 此图片用于{{tl|copy to Wikimedia Commons}}。 
}}
{{imbox
| type  = license
| image = [[File:Heckert GNU white.svg|48px]]
| text  = type = license <br> image = <nowiki>[[File:Heckert GNU white.svg|48px]]</nowiki> <br> 此图片用于GFDL license模板，如{{tl|GFDL}}。
}}
== 特殊设定 ==
一些其他的参数组合。
{{imbox
| text  = 未给出type和image('''default''')
}}
{{imbox
| image = none
| text  = 未给出type，并且'''image=none''' – 不使用图片，而且'''text'''占用整个信息框区域。
}}

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

{{imbox
| type = license
| image = [[File:PD-icon.svg|40px]] <br> [[File:Ambox warning yellow.svg|40px]]
| imageright = [[File:Shuttle.svg|30px]]
| text  = '''此文件是在[[public domain|公有领域]]，因为它是由[[NASA|美国国家航空航天局]]创建的。'''
<br>请注意，使用NASA标志、徽章和徽标受美国法律的约束。<!-- Note that use of NASA logos, insignia and emblems are restricted per US law. -->
}}
<!-- 目前不支持“below”参数。2008-11-09

{{imbox
| type       = license
| image      = [[File:PD-icon.svg|40px]]
| text       = 
type = license <br> image = <nowiki>[[File:PD-icon.svg|40px]]</nowiki> <br> below = <nowiki>{{imbox | type = content | text = '''本许可标签不推荐使用！''' }}</nowiki>
| below = 
  {{imbox
  | type = content
  | text = '''本许可标签不推荐使用！This license tag is deprecated!'''
  }}
}}
-->
== 参数说明 ==
所有参数的列表：

<syntaxhighlight lang="wikitext">
{{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  = 消息框的主体文字。
}}
</syntaxhighlight>
<!-- 
| below = More text or another imbox.
-->
;type
:如果未给出'''type'''参数，本模板缺省使用'''notice'''类型。那意味着它会有一个蓝色的边框。

;image
:'''不带此参数''' = 如果未给出'''image'''参数，则本模板使用一个缺省的图片。至于是哪一个缺省图片则取决于'''type'''参数。
:'''一幅图片''' = 应当是带常见的维基标记的一幅图片。通常设置为40px - 50px宽比较合适，这取决于图像的长宽比。（但是此消息框能够处理任意尺寸的图片。）例如：
::<code><nowiki>image = [[File:Gnome-dev-camera.svg|40px]]</nowiki></code>
:'''none''' = 意味着不使用图片。

;imageright
:'''不带此参数''' = 如果未给出'''imageright'''参数，那么右侧不会显示图片。
:'''一幅图片''' = 应当是带常见的维基标记的一幅图片。通常设置为40px - 50px宽比较合适，这取决于图像的长宽比。（但是此消息框能够处理任意尺寸的图片。）例如： 
::<code><nowiki>imageright = [[File:Nuvola apps bookcase.png|40px]]</nowiki></code>
:'''任意内容''' = 任意其他的你想显示在右侧的对象。

;style
:一个可选的CSS取值，被整个消息框表格所用。不带引号<code>" "</code>。例如：
::<code>style = margin-bottom: 0.5em;</code>

;textstyle
:一个可选的CSS取值，被文本单元格所用。例如：
::<code>textstyle = text-align: center;</code>

;text
:消息框的主体文字。
<!-- 目前中文模板不支持below参数。2008-11-11
;below
-->
== 技术细节 ==
如果你需要在text参数中使用一些特殊字符的话，那么就需要像这样将它们换码：

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

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

此模板使用CSS类来确定显示风格，因此可被更换到其他风格。

在此元模板内使用了HTML的表格标示法，而没有使用维基式的表格标示法。在制作元模板时这是一个常见的方法，因为维基式标示法存在一些缺陷。譬如，维基式标示法会加大[[Help:模板扩展语法|模板扩展语法]]及参数中特殊字符使用的难度。

此元模板所用的缺省图片用的是png格式的，而不是svg格式。其主要原因是在处理MediaWiki为svg图片所渲染的透明背景时，一些老版本的网络浏 览器会遇到一些麻烦。这里的png格式图片有手工优化过的透明背景颜色，因而在所有的浏览器中它们看上去都是好的。请注意，svg图标只会在一些老版本的 浏览器中看上去有点不对头，因此只有那些非常广泛使用的图标才值得费些功夫去做那种手工优化。

更多的技术细节参见[[{{TALKPAGENAME}}|讨论页]]以及下方的[[#參見]]一节。
== 參見 ==
在消息框（mbox）家族中有好几个元模板：
* {{tl|ambox}} – 用于条目消息框。
* {{tl|tmbox}} – 用于讨论页消息框。
* {{tl|imbox}} – 用于图像页消息框。
* {{tl|cmbox}} – 用于分类消息框。
* {{tl|ombox}} – 用于其他页面消息框。
* {{tl|fmbox}} – 用于页眉和页脚消息框。
* {{tl|mbox}} – 有名字空间探测功能。某些消息框会用在几类页面并因此需要依据所用在的页面来改变风格，这种情况下的消息框可以用此元模板。
<includeonly>
<!-- 本行下加入模板的分類 -->
[[Category:維基百科元模板]]
[[Category:檔案頁模板| ]]
</includeonly>