注意:請只放置對本網站項目有重要意義的通告,並先閱讀使用文檔後再對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_grouponly_for 函數與 &&||! 運算;存在時 {{{2}}} 被忽略。表達式中的 || 在 wikitext 中需寫作 {{!!}}
  • {{{html}}}:公告內容改為直接輸出該參數的原始 HTML(不經過 wikitext 解析),適合包含複雜標籤的公告。
  • {{{style}}}:附加的 CSS 樣式文本,僅在該公告顯示時生效。

注意事項

  • 如在公告包含其他模板,而該模板的內容會在不用編輯的情況下自動更新(如倒數),您可能需要清除ajax頁面的緩存,內容才會更新。要清除緩存,請點選此處
  • 如需查詢目前公告的顯示性質,請至Template:AdvancedSiteNotices/viewer

參見