模板:Fmbox/doc

本模板{{fmbox}}為頁首與頁尾訊息框（footer and header message box）。

本模板可用於構建MediaWiki:Sp-contributions-footer-anon等系統消息的消息框，也可用於用戶頁的頁首與頁腳消息框，以及編輯提示。

本模板與{{ambox}}工作原理類似，大部分參數相同；主要區別在於本框寬度為 100%，且配色風格不同。

使用方法

簡易用法如下：

{{fmbox | text = 範例文字。}}

完整用法如下：

{{fmbox
| type      = editnotice
| image     = [[File:Emblem-question-yellow.svg|40px]]
| style     = border: 1px solid #f4c430;
| textstyle = color: red; font-weight: bold; font-style: italic;
| text      = 訊息主體文字。
}}

頁首與頁尾消息框類型

以下示例使用了不同的type參數，但未指定image參數，因此會顯示各類型的默認圖片。

其他圖片

上方顯示的默認圖片大多用於測試與演示。多數情況下，更適合使用更具體的圖片，或完全不使用圖片。以下示例通過image參數指定了默認圖片以外的圖片。

特殊用法

一些其他參數組合。

參數

全部參數列表：

{{fmbox
| type  = system / editnotice / warning
| image = none / [[File:Some image.svg|40px]]
| imageright = [[File:Some image.svg|40px]]
| id = CSS id
| class = CSS class names
| style = CSS values
| textstyle = CSS values
| text  = 消息正文。
}}

type

若未指定type參數，模板默認使用 type=system，即淺灰色背景。

image

未指定參數 = 未指定image參數時，模板會根據type參數使用對應的默認圖片。

指定圖片 = 應使用常規 wiki 圖片語法，例如：

image = [[File:User-info.svg|40px]]

寬度 40px–50px 通常比較合適（取決於圖片寬高比）；消息框可容納任意尺寸的圖片。

none = 不使用圖片。

imageright

未指定參數 = 未指定imageright參數時，右側不顯示圖片。

指定圖片 = 應使用常規 wiki 圖片語法，例如：

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

寬度 40px–50px 通常比較合適；消息框可容納任意尺寸的圖片。

任意內容 = 可在右側顯示任意其他對象。

id

整個消息框的可選CSS id，不帶引號 " "。主要用於標記消息框名稱，便於 JavaScript 檢測。例如 MediaWiki:Sp-contributions-footer 使用：

id = sp-contributions-footer

class

整個消息框的可選CSS類名，不帶引號 " "。主要用於標記消息框名稱，便於單獨定製皮膚。例如 MediaWiki:Sp-contributions-footer 使用：

class = sp-contributions-footer

style

整個消息框的可選CSS樣式，不帶引號 " "，但需以分號 ; 結尾。例如：

style = margin-top: 1em;

textstyle

文字單元格的可選CSS樣式。例如：

textstyle = font-size: 90%; text-align: center;

text

消息正文。

技術細節

本模板目前使用硬編碼的樣式與類名，未來將僅使用 CSS 類以便更換皮膚（目前可通過 "!important" 關鍵字覆蓋樣式）。

如需製作寬度小於 100% 的消息框，請不要使用本模板，改用{{ombox}}。因為本框沒有使其他消息框在寬度小於 100% 時於所有瀏覽器中獲得正確框流布局的"1px 空圖片單元格"代碼。

若需在text參數中使用特殊字符，需如下轉義：

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

本元模板內部使用 HTML 標記而非維基表格標記。這是製作元模板的常見做法，因為維基表格標記存在若干缺陷，例如難以在參數中使用解析器函數和特殊字符。

管理員注意：MediaWiki 不會像處理普通頁面那樣解析和轉換系統消息中的 HTML 標記。例如
不會自動轉換為
，缺失的 與 標籤不會自動補全。因此請確保系統消息中的 HTML 代碼為有效的 XHTML，即閉合所有開啟的標籤。不過，常規維基標記在多數系統消息中可正常工作。 更多技術細節參見討論頁。由於本模板與{{mbox}}、{{ambox}}、{{tmbox}}和{{ombox}}的工作方式幾乎完全相同，它們的討論頁及相關頁面也可能包含更多細節。

參見

• {{mbox}} – 多命名空間消息框（自動檢測命名空間）
• {{ambox}} – 條目消息框
• {{tmbox}} – 討論頁消息框
• {{ombox}} – 其他頁面消息框
• {{fmbox}} – 頁眉和頁腳消息框
• {{dmbox}} – 消歧義消息框