模板: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}} — 自動檢測命名空間