跳转到内容

模板:Ambox/doc

勤求古训,博采众方
鹿野耕云留言 | 贡献2026年6月25日 (四) 00:20的版本
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
消息框模板

{{Ambox}}(Article message box,条目消息框)是条目信息框的元模板,用于创建各类条目提示和维护模板。此模板只应在条目名字空间使用。

常用参数

参数 说明
type 消息类型,决定左侧色条颜色和默认图标
image 自定义左侧图标
issue 问题简述(必填)
fix 改进指引
sect 指定章节(如“章节”),改变所指的条目部分
date 标记日期,用于按月分类
time 配合 {{#time:c}} 显示精确时间
small left 时显示为小型右浮框
talk 讨论页链接
cat 按月分类名称
all 全部分类名称
name 模板名称(不含 Template: 前缀),用于检测错误替换引用

type 类型

type 参数指定模板默认的左侧色条颜色和图片,根据消息类型选择:

未指定 type 时默认使用 notice

小尺寸模式

|small=left 产生小型浮动框:

标准尺寸效果:

image 参数

使用 image 参数可指定模板中显示的图片。语法与普通图片相同,建议宽度 40-50px。如果 image 设为 none 则不显示图片。

sect 参数

许多条目信息框开头为“此条目…”,如果用于章节则应显示“此章节…”。使用 |sect= 实现此功能,编辑者可在第一个无名参数中输入“章节”来改变所指的条目部分。

issue & fix 参数

issue 用于描述条目问题,建议 10-20 字内,并包含相关方针指引的链接。fix 包含改进指导文字,比 issue 可稍长。当模板以整合状态(如放在 {{Multiple issues}} 中)或小型状态显示时,仅显示 issue 中的文字。

talk 参数

|talk= 可让编辑者指定讨论页章节链接。当讨论页不存在时不显示链接。

date 参数

|date= 让编辑者或机器人标记模板放置日期,以小字显示在主文字后。配合 cat 参数可实现按月自动分类。

cat & all 参数

  • cat:配合 date 可将条目分类至“Category:自 DATE 起 CATEGORY”
  • all:指定所有包含模板的条目的分类名

完整参数列表

{{Ambox
| name        = 
| subst       = <includeonly>{{subst:substcheck}}</includeonly>
| small       = {{{small|}}}
| type        = 
| image       = 
| imageright  = 
| smallimage  = 
| smallimageright = 
| class       = 
| style       = 
| textstyle   = 
| sect        = {{{1|}}}
| issue       = 
| talk        = {{{talk|}}}
| fix         = 
| date        = {{{date|}}}
| time        = {{{time|}}}
| text        = 
| smalltext   = 
| cat         = 
| all         = 
| cat2        = 
| all2        = 
| cat3        = 
| all3        = 
}}

技术细节

如需在 text 参数中使用特殊字符,需如下转义:

{{Ambox
| text  = 
等号 = 与前后大括号 { } 可以正常使用。
但管道符 {{!}} 与两个后大括号 <nowiki>}}</nowiki> 不能直接使用。
同时使用需加 nowiki 标记 <nowiki>|}}</nowiki>}}

此模板使用 CSS 类确定显示风格,可更换为其他皮肤。内部使用 HTML 表格标记而非维基式表格标记,这是元模板常见做法。

参见

其他 mbox 家族模板:

  • {{Tmbox}} — 讨论页消息框
  • {{Imbox}} — 文件页消息框
  • {{Cmbox}} — 分类消息框
  • {{Ombox}} — 其他页面消息框
  • {{Fmbox}} — 页眉和页脚消息框
  • {{Mbox}} — 自动检测命名空间