Template:Message box

From NeuroWiki
Jump to navigation Jump to search
[ View | Edit | History | Purge ]Documentation page

This template uses Module:Message box, this script is written in Lua.
For more details, please refer to Wikipedia:Lua and Extension:Scribunto.

本模板使用了模板样式Template:Message box/styles.css,此样式表由CSS编写。
更多详情,请参阅Help:模板样式Extension:TemplateStyles

该模板用于向消息框添加一致的样式。

请注意,在页面源代码中将该模板与{{tag}}置于同一行时会导致-{}-{{tag}}换行出错。

用法

不推荐以行内形式使用此模板。

-{}-
{{ Message box
| title = 作为标题的文本
| text = 作为普通文本的文本
| type = 消息框类型(预设样式)
| class = 要附加的消息框基本类的名称
| css = 要附加的消息框基本样式(CSS文本)
| bgcol = 消息框背景色
| linecol = 消息框高亮条(左边框)颜色
| font-size = 消息框的基本字号
| width = 消息框的宽度
| compat = 是否使用紧凑式消息框
| mini = 是否使用段落式消息框
| icon = 要在消息框中显示的CommentSprite图标ID
| iconlink = CommentSprite图标要链接到的页面名
| image = 要在消息框中显示的图片文件名(不含前导File:)
| imagelink = 图片要链接到的页面名
| imagecss = 要附加的消息框图像区样式(CSS文本)
| imagesize = image的大小
| imagetextbefore = 要在图像区的图像前显示的文本
| imagetextafter = 要在图像区的图像后显示的文本
| text-align = 消息框文本区的文本对齐方式
| textcss = 要附加的消息框文本区样式(CSS文本)
| customaction = 要在标题文本后上标区中显示的文本
| discuss = 是否在标题文本后上标区中显示讨论链接
| discussPage = 讨论链接要指向的讨论页名称
| discussAnchor = 讨论链接要指向的讨论页段落名称
| linkshere = 是否在标题文本后上标区中显示链入页面链接
}}
基本参数
  • |title=:推荐,要作为消息框标题显示的文本,此文本会被加粗。可以是任意wikitext。
  • |text=:推荐,要作为消息框普通文本显示的文本。可以是任意wikitext。
基本类型
  • |compat=:可选,指定使用紧凑式消息框(宽度适应文本的消息框)。
  • |mini=:可选,指定使用段落式消息框,适合放置在段落而不是页面顶部时使用。
消息框基本样式
  • |type=:可选,用于代替手动指定|bgcol=|linecol=而使用预设样式。可用的类型见此模板的样式表,目前可用的如下:
  • |bgcol=:可选,指定消息框的背景色(不推荐使用,因为此方式无法适配深色模式),可以为任意CSS支持的格式。使用此参数的页面会列入使用Message box的bgcol参数的页面分类中。
  • |linecol=:可选,指定消息框高亮条(左边框)的颜色(不推荐使用,因为此方式无法适配深色模式),可以为任意CSS支持的格式。使用此参数的页面会列入使用Message box的linecol参数的页面分类中。
  • |font-size=:可选,指定消息框中文字的基本字号,未单独指定字号的文本都会使用此处指定的字号。
  • |width=:可选,指定消息框的宽度,最多可为全页宽度的80%(参见此模板的样式表)。指定此参数后,|compat=不会起效。
  • |class=:可选,指定要对整个消息框生效的附加CSS类。
  • |css=:可选,指定要对整个消息框生效的内联样式。
消息框图像区
  • |icon=:可选,指定要显示的CommentSprite的ID,ID定义见CommentSprite模板文档,对应含义见Comment模板文档
  • |iconlink=:可选,指定CommentSprite要链接到的页面名称。
  • |image=:可选,指定要显示的图片名称(显示在CommentSprite后,不含前导File:)。
  • |imagelink=:可选,指定图片要链接到的页面名称。
  • |imagecss=:可选,指定要对整个消息框图像区生效的内联样式。
  • |imagesize=:可选,指定通过|image=指定的图像的显示大小。若不指定,默认为16px(指定|mini=时)或32px(未指定|mini=时)。
  • |imagetextbefore=:可选,指定要在消息框图像区内,CommentSprite和图片前显示的文本。可以是任意wikitext。
  • |imagetextafter=:可选,指定要在消息框图像区内,CommentSprite和图片后显示的文本。可以是任意wikitext。
消息框文本区
  • |text-align=:可选,指定消息框文本区内文本的对齐方式,可为left(左对齐,默认)、center(居中)、right(右对齐)。
  • |imagecss=:可选,指定要对整个消息框文本区生效的内联样式。
  • |customaction=:可选,指定要作为消息框标题后第一个上标的文本。可以是任意wikitext。
  • |discuss=:可选,指定要在消息框标题后第二个上标处显示自动的“讨论”链接,用于链接至讨论页。
  • |discussPage=:可选,指定“讨论”链接的目标页面。若不指定,则指向使用此模板的页面对应的讨论页。
  • |discussAnchor=:可选,指定“讨论”链接要链接到的目标段落。若不指定,“讨论”链接只会链接到页面。
  • |linkshere=:可选,指定要在消息框标题后第三个上标处显示自动的“链入”链接,用于链接至使用此模板的页面的“链入页面”特殊页面。

示例

基本用法

{{ Message box
| title = 这是一个普通的消息框
| text = 还有叙述性的副文本
}}

将如此显示:

这是一个普通的消息框

还有叙述性的副文本

微型用法

{{ Message box
| mini = 1
| icon = 8
| text = 这是一个有图标并且使用[[Template:CommentSprite]]的微型消息框 
}}

将如此显示:

这是一个有图标并且使用Template:CommentSprite的微型消息框

高级用法

{{ Message box
| type = cyan
| title = 这是一个蓝色的消息框
| text = 它包含一个讨论链接和自定义CSS代码
| discuss = 1
| css = -moz-box-shadow: 0px 0px 6px #888; -webkit-box-shadow: 0px 0px 6px #888;
}}

将如此显示:

这是一个蓝色的消息框 讨论

它包含一个讨论链接和自定义CSS代码

{{ Message box
| type = cyan
| title = 这是一个蓝色消息框
| text = 它包含讨论链接,自定义的CSS代码以及一个自定义图片
| discuss = 1
| image = No_image.svg
| css = -moz-box-shadow: 0px 0px 6px #888; -webkit-box-shadow: 0px 0px 6px #888;
}}

将如此显示:

这是一个蓝色消息框 讨论

它包含讨论链接,自定义的CSS代码以及一个自定义图片

自定义图片的尺寸还可以使用"imagesize"来指定,例如:imagesize = 50px

高级微型用法

{{ Message box
| mini = 1
| image = No_image.svg
| type = cyan
| css = -moz-box-shadow: 0px 0px 6px #888; -webkit-box-shadow: 0px 0px 6px #888;
| text = 这是一个微型消息框,类似于上边的高级消息框。
}}

将如此显示:

这是一个微型消息框,类似于上边的高级消息框。

它的图片同样也能选择尺寸。

en:Template:Message box

[ View | Edit | History | Purge ]The above documentation is transcluded from Template:Message box/doc.