模板:AdvancedSiteNotices/doc
注意:請只放置對本網站項目有重要意義的通告,並先閱讀使用文檔後再對Template:AdvancedSiteNotices/notices進行修改。
用法
添加一項通告時,請將通告填寫在源代碼內的{{AdvancedSiteNotices/notices}}模板內。假如修改前的源代碼為:
{{AdvancedSiteNotices/notices|
{{AdvancedSiteNotices/item|欢迎来到本站}}
}}
修改後的源代碼將類似於下面的代碼:
{{AdvancedSiteNotices/notices|
{{AdvancedSiteNotices/item|欢迎来到本站}}
'''{{AdvancedSiteNotices/item|你好,世界}}'''
}}
{{AdvancedSiteNotices/item}}的參數
{{AdvancedSiteNotices/item}}有兩個匿名參數和三個命名參數:{{{1}}}為必填參數,填寫通告的實際內容;{{{2}}}、{{{criteria}}}、{{{html}}}和{{{style}}}為選填參數。
參數{{{criteria}}}應為有效的JavaScript表達式。提供以下測試函數:
- in_group - 測試用戶所在用戶組
- only_for - 測試用戶所在國家或地區
參數{{{2}}}有多種模式,各種模式可以混用,以空格分隔:
- only_sysop - 只對管理員顯示
- only_logged - 只對登錄用戶顯示
- only_anon - 只對匿名用戶顯示
- only_zh_cn - 只對中國大陸用戶顯示
- only_zh_hk - 只對中國香港用戶顯示
- only_zh_mo - 只對中國澳門用戶顯示
- only_zh_tw - 只對中國台灣用戶顯示
- only_zh_my - 只對馬來西亞用戶顯示
- only_zh_sg - 只對新加坡用戶顯示
當參數{{{criteria}}}存在時,參數{{{2}}}將被忽略。
實際用例
以下示例演示各選填參數的具體用法,可直接複製到Template:AdvancedSiteNotices/notices中測試:
{{AdvancedSiteNotices/item|1=仅对登录用户显示的公告|2=only_logged}}
{{AdvancedSiteNotices/item|1=仅对管理员显示的公告|2=only_sysop}}
{{AdvancedSiteNotices/item|1=仅对中国大陆用户显示的公告|2=only_zh_cn}}
{{AdvancedSiteNotices/item|1=管理员或巡查员可见(criteria 写法)|criteria=in_group('sysop') {{!!}} in_group('patroller')}}
{{AdvancedSiteNotices/item|1=只对中国大陆用户显示(criteria 写法)|criteria=only_for('zh-cn')}}
{{AdvancedSiteNotices/item|1=这条公告文字为红色加粗(style 写法)|style=color:red;font-weight:bold;}}
{{AdvancedSiteNotices/item|1=html 参数会原样输出内容,不经过解析器|html=<span style="color:green">这是用 html 参数写入的公告</span>}}
說明:
- {{{2}}}:以空格分隔的類名模式,可混用,如
only_sysop only_zh_cn。 - {{{criteria}}}:有效的 JavaScript 表達式,支持
in_group、only_for函數與&&、||、!運算;存在時 {{{2}}} 被忽略。表達式中的||在 wikitext 中需寫作{{!!}}。 - {{{html}}}:公告內容改為直接輸出該參數的原始 HTML(不經過 wikitext 解析),適合包含複雜標籤的公告。
- {{{style}}}:附加的 CSS 樣式文本,僅在該公告顯示時生效。
注意事項
- 如在公告包含其他模板,而該模板的內容會在不用編輯的情況下自動更新(如倒數),您可能需要清除ajax頁面的緩存,內容才會更新。要清除緩存,請點選此處。
- 如需查詢目前公告的顯示性質,請至Template:AdvancedSiteNotices/viewer。