Template: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。