imported>SunAfterRain：/* {{AdvancedSiteNotices/item}}的参数 */

2025-04-19T07:37:34Z

{{AdvancedSiteNotices/item}}的参数

新页面

<includeonly></includeonly><noinclude>{{Documentation subpage}}</noinclude>

{{NoteTA|G1=IT}}
{{For|英语维基百科模板[[:en:Template:ASN|Template:ASN]]|Template:ASNet}}

== 用法 ==
添加通告时，请将通告填写在源代码内的{{tl|AdvancedSiteNotices/core}}模板内。假如修改前的源代码为：
<syntaxhighlight lang="wikitext">
{{AdvancedSiteNotices/core|
{{AdvancedSiteNotices/item|-{zh-cn:欢迎来到维基百科; zh-tw:歡迎來到維基百科;}-}}
}}
</syntaxhighlight>

修改后的源代码将类似于下面的代码：
<syntaxhighlight lang="wikitext" highlight="3">
{{AdvancedSiteNotices/core|
{{AdvancedSiteNotices/item|-{zh-cn:欢迎来到维基百科; zh-tw:歡迎來到維基百科;}-}}
{{AdvancedSiteNotices/item|你好，世界}}
}}
</syntaxhighlight>

=== {{AdvancedSiteNotices/item}}的参数 ===
{{AdvancedSiteNotices/item}}有两个匿名参数和一个命名参数：'''{{{1}}}'''为必填参数，填写通告的实际内容；'''{{{2}}}'''和'''{{{criteria}}}'''为选填参数，可以定义通告面向的人群：

{{AdvancedSiteNotices/item|'''{{{1}}}'''|'''{{{2}}}'''|'''criteria={{{criteria}}}'''}}

参数'''{{{criteria}}}'''应为有效的JavaScript表达式。须注意，'''由于安全原因，表达式中只支持以下语法'''：
* 字串（僅支援 <code><nowiki>'</nowiki></code>、<code><nowiki>"</nowiki></code> 包裹，支援跳脫字元 <code><nowiki>\n</nowiki></code>、<code><nowiki>\t</nowiki></code>、<code><nowiki>\r</nowiki></code>、<code><nowiki>\b</nowiki></code>、<code><nowiki>\f</nowiki></code>、<code><nowiki>\x</nowiki></code>、<code><nowiki>\u</nowiki></code>）；
* 布林值；
* 邏輯運算子<code><nowiki>&&</nowiki></code>和<code><nowiki>||</nowiki></code>；
* 一元運算子<code><nowiki>!</nowiki></code>；
* 用括號包裹表達式（如<code><nowiki>(a && b) || c</nowiki></code>）；
* 函數调用（僅支援<code><nowiki>func(arg1, arg2)</nowiki></code>的形式，仅支持调用下方列明的函数）。
<div style="background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 0.3em 1em;">
* 需傳值的函數：
** in_country - 测试用户所在[[ISO 3166-1|国家或地区]]，只要匹配其中一個傳入值就會返回 <code>true</code>
** in_region - 测试用户所在[[ISO 3166-2|主要行政区]]，只要匹配其中一個傳入值就會返回 <code>true</code>
** in_city - 测试用户所在城市，只要匹配其中一個傳入值就會返回 <code>true</code>
** in_group - 测试用户所在用户组，只要匹配其中一個傳入值就會返回 <code>true</code>
** in_group_every - 测试用户所在用户组，{{red|只有用戶擁有所有用戶組時才返回 <code>true</code>}}
** in_lang - 测试用户使用語言，只要匹配其中一個傳入值就會返回 <code>true</code>
* 無需傳值的函數：
** is_anon - 测试用户是不是匿名用戶
** is_temp - 测试用户是不是臨時帳戶
** is_named - 测试用户是不是註冊用户
</div>

当没有填写时，将使用参数'''{{{2}}}'''。

参数'''{{{2}}}'''有多种模式，各种模式可以混用，并以空格分隔：
<div style="background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 0.3em 1em;">
* only_sysop - 只对管理员显示
* only_logged（'''已棄用'''）、only_logged_in、is_named - 只对註冊用户显示
* only_anon（'''已棄用'''）、only_logged_out - 只对'''登出用户'''显示，請注意臨時帳號'''算是登出用戶'''
* is_temp - 只对臨時帳號显示
* is_anon - 只对'''匿名用户'''显示，請注意臨時帳號'''不算是匿名用戶'''
* only_zh_cn - 只对大陆用户显示
* only_zh_hk - 只对香港和澳门用户显示
* only_zh_sg - 只对新加坡和马来西亚用户显示
* only_zh_tw - 只对台湾用户显示
</div>

实际用例：
<syntaxhighlight lang="wikitext">
{{AdvancedSiteNotices/item|[[Wikipedia:聚会/2010年台湾秋聚|'''2010年台湾维基人秋聚''']]与[[Wikipedia_talk:聚会/2010上海夏聚|'''2010年上海维基人夏聚''']]圆满落幕。|criteria=in_country('TW') {{!!}} in_country('CN') && in_city('Shanghai')}}
{{AdvancedSiteNotices/item|这条消息只有位于对应用户组的用户才能看见|criteria=in_group('rollbacker', 'patroller, 'sysop', 'autoreviewer')}}
{{AdvancedSiteNotices/item|這條消息在東八區跨到2025年後不顯示，不過由於快取問題實際上可能要一小時才會不再顯示|criteria={{#ifexpr:{{#time:YmdHi}}>202501010800|false|true}}}}
</syntaxhighlight>

== 注意事項 ==
* 如在公告'''包含其他模板，而該模板的內容會在{{zh-em|不用編輯}}的情況下自動更新'''（如倒數），您可能'''需要清除[[Template:AdvancedSiteNotices/ajax|ajax頁面]]的緩存'''，內容才會更新。要'''清除緩存，請點選[[Special:Purge/Template:AdvancedSiteNotices/ajax|此處]]'''。
* 如需查詢目前公告的顯示性質，請至[[Template:AdvancedSiteNotices/viewer]]。
* 本頁面目前被全保護——需要在公告中加入內容的用戶請到[[Template_talk:AdvancedSiteNotices]]提出請求，由管理員代為加入。

== 參見 ==
* [[MediaWiki:Gadget-AdvancedSiteNotices.js]]
* [[MediaWiki:Gadget-AdvancedSiteNotices.css]]
<includeonly>

[[category:公告栏|模]]
[[Category:辅助模板|{{PAGENAME}}]]
</includeonly>

Template:AdvancedSiteNotices/doc - 版本历史

imported>SunAfterRain：​/* {{AdvancedSiteNotices/item}}的参数 */

imported>SunAfterRain：/* {{AdvancedSiteNotices/item}}的参数 */