模板:Fmbox
此模板基於以下Lua語言模塊編寫:
本模板使用以下模板樣式:
本模板{{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參數,因此會顯示各類型的默認圖片。
type=warning —— 警告通知,如 MediaWiki:Revision-info 與 MediaWiki:Protectedpagewarning。
type=editnotice —— 透明背景,用於編輯提示。
type=system —— 淺灰色系統消息背景(默認)。
其他圖片
上方顯示的默認圖片大多用於測試與演示。多數情況下,更適合使用更具體的圖片,或完全不使用圖片。以下示例通過image參數指定了默認圖片以外的圖片。
image = [[File:User-info.svg|40px]]
此圖片用於 MediaWiki:Sp-contributions-footer。
此圖片用於 MediaWiki:Sp-contributions-footer。
特殊用法
一些其他參數組合。
未指定圖片(默認)
image=none —— 不使用圖片,
text占滿整個消息框區域。參數
全部參數列表:
{{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>
}}
等號 = 與前後大括號 { } 可以正常使用。 但管道符 | 與兩個相連的後大括號 }} 不能直接使用。 一起使用同樣需要 nowiki 標記 |}}。
本元模板內部使用 HTML 標記而非維基表格標記。這是製作元模板的常見做法,因為維基表格標記存在若干缺陷,例如難以在參數中使用解析器函數和特殊字符。
管理員注意:MediaWiki 不會像處理普通頁面那樣解析和轉換系統消息中的 HTML 標記。例如
不會自動轉換為
,缺失的 與 標籤不會自動補全。因此請確保系統消息中的 HTML 代碼為有效的 XHTML,即閉合所有開啟的標籤。不過,常規維基標記在多數系統消息中可正常工作。
更多技術細節參見討論頁。由於本模板與{{mbox}}、{{ambox}}、{{tmbox}}和{{ombox}}的工作方式幾乎完全相同,它們的討論頁及相關頁面也可能包含更多細節。