查看“︁模板:切换显示/doc”︁的源代码

{{Lua|切换显示}}
本系列模板用以手动显示/隐藏特定字符串，并批量指定字符串及按钮样式。
== 用法 ==
;注意字符串代号可以用小写英文字母、大写英文字母、汉字等（不被视为wikitext）：
*'''不得包含<code><nowiki>'</nowiki></code>、<code><nowiki>"</nowiki></code>、<code><nowiki><</nowiki></code>、<code><nowiki>></nowiki></code>、<code><nowiki>\</nowiki></code>、<code><nowiki>/</nowiki></code>、<code><nowiki>|</nowiki></code>、<code><nowiki>$</nowiki></code>，不得以<code>@</code>开头，否则将被无视；'''
*'''大小写、繁简敏感，请牢记。'''

;{{tl|切换显示|<nowiki>参数1|参数2|参数3</nowiki>}}：
:{{color|red|'''必需'''}}，用以指定需要手动切换的字符串。本模板没有数量限制。
:* 参数<code>1</code>：字符串代号；
:* 参数<code>2</code>：字符串内容（wikitext格式）；
:** 在参数3未指定为块元素名时参数2不可以填写需要换行的wikitext，反之当参数3指定为块元素名时参数2没有任何限制（参见[[#需要换行的wikitext]]）。
:* 参数<code>3</code>：{{color|#0099FF|可选}}，用以指定字符串根元素的标签名（默认为<code><nowiki>span</nowiki></code>）（参见[[#根元素标签]]）。

;{{tl|切换显示/模板|<nowiki>@=【模板名称】|@tag=【根元素标签】|【参数1】=|【参数2】@【字符串代号1】=|…</nowiki>}}：
:{{color|red|'''必需'''}}，是{{tl|切换显示}}的包装（即本模板是{{tl|切换显示}}的特殊实现，与之等价），用以指定需要手动切换一个模板的某个/些参数的字符串，以减少代码书写量，提高可阅读性。本模板没有数量限制。
:* 参数格式中<code>【】</code>内为用户填写内容（注意填写时不要加【】，除非代号与文本内确有此内容）。
:* 参数<code>@</code>：调用的目标模板的名称，不需要加<code>{{ns:Template}}:</code>名字空间前缀；
:* 参数<code>@tag</code>：{{color|#0099FF|可选}}，同{{tl|切换显示}}的<code>参数3</code>，用以指定字符串根元素的标签名（默认为<code><nowiki>span</nowiki></code>）（参见[[#根元素标签]]）；
:* 格式<code>参数</code>：调用的目标模板的参数的名称；
:** 参数名称与直接调动目标模板所需要书写的参数名称基本一致。唯一区别是，目标模板参数名称中的'''每个<code>@</code>字符都需要写成2个（<code>@@</code>）'''，以免和表示参数名称与字符串代号间隔的1个<code>@</code>字符混淆；
:* 格式<code>字符串代号</code>：字符串代号；
:** 若不填写格式<code>字符串代号</code>，这个参数的值将会作为'''所有字符串代号的默认值'''；
:'''{{color|red|注：}}{{tl|切换显示/模板}}实际上多次调用了目标模板，而非仅对参数部分进行处理。若目标模板代码中包含计数器等（设计时未考虑重复调用情况），需要注意对其状态进行重置。'''

;{{tl|切换显示按钮|<nowiki>@default=|@radio=|@reverse=|@forceNoCancel=|@toggleClass=|【字符串代号1】=【按钮文本1】|…</nowiki>}}：
:{{color|red|'''必需'''}}，用以显示切换按钮，本模板没有数量限制。若一个本模板中有多个“字符串代号”，则这些“字符串代号”对应的按钮将并排显示。
:* 参数格式为 <code><nowiki>|【字符串代号】=【按钮文本】</nowiki></code>，其中<code>【】</code>内为用户填写内容（注意填写时不要加【】，除非代号与文本内确有此内容）。<br>【按钮文本】为wikitext格式，但其内的点击事件不会被触发（即链接、缩略图等无法点开）。
:** 可选格式如下（仅<code>@on</code>和<code>@off</code>会被识别为参数，“@+其他任意字符”则会被识别为“字符串代号”的一部分）：
:*** <code><nowiki>|【字符串代号】@on=【按钮文本】</nowiki></code>：指定字符串代号对应按钮'''激活时'''显示的按钮文本（普通模式下按钮复选框/单选框'''勾选'''时显示，反转模式下按钮复选框/单选框'''未勾选'''时显示）；
:*** <code><nowiki>|【字符串代号】@off=【按钮文本】</nowiki></code>：指定字符串代号对应按钮'''未激活时'''显示的按钮文本（普通模式下按钮复选框/单选框'''未勾选'''时显示，反转模式下按钮复选框/单选框'''勾选'''时显示）。
:** 另外，如果 <code><nowiki>【字符串代号】</nowiki></code>包含<code><nowiki>$</nowiki></code>，那么该按钮绑定的实际代号为 <code><nowiki>【字符串代号】</nowiki></code>按<code><nowiki>$</nowiki></code>分割后的数组，通过此方法可以将单一按钮绑定到多个元素上。
:* 另外，可以选择配置以下选项：
:** <code>@default</code>：{{color|#0099FF|可选}}，用以指定默认激活的按钮（此处的参数值为该按钮对应的字符串代号）；
:** <code>@radio</code>：{{color|#0099FF|可选}}，参数值不为空时将会使该模板内的按钮变为单选框，一次只能显示一种字符串；
:*** 使用该参数时单选按钮旁边会显示“取消选择”按钮。
:** <code>@reverse</code>：{{color|#0099FF|可选}}，参数值不为空时将会使该模板内的按钮变为反转模式：没有勾选的将会显示，勾选的将会隐藏；
:** <code>@forceNoCancel</code>：{{color|#0099FF|可选}}，参数值不为空且<code>@radio</code>和<code>@default</code>均不为空时强制隐藏取消选择单选框。
:** <code>@toggleClass</code>：{{color|#0099FF|可选}}，参数值不为空时可以指定切换显示具体切换的 class 名称；此 class 默认为<code>hidden</code>，所以只要改成<code>hidden</code>以外的 class 名称就可以不隐藏切换显示的内容、而是改为利用 CSS 样式表应用不同的显示效果。
;'''{{color|red|注：}}{{tl|切换显示}}与{{tl|切换显示按钮}}的位置决定了字符串和按钮的位置关系，例如编辑文档时{{tl|切换显示}}在{{tl|切换显示按钮}}的前面，则显示内容时字符串在按钮的前面，反之亦然。'''

;{{tl|切换显示样式|<nowiki>【字符串代号1】=【样式文本1】|…</nowiki>}}：
:{{color|#0099FF|可选}}，用以批量指定某些需要手动切换的字符串的样式，会同时影响按钮内文字的样式（普通模式下按钮复选框/单选框勾选时激活，反转模式下按钮复选框/单选框未勾选时激活）。本模板没有数量限制<del>但是一个就够用了</del>。
:* 参数格式为 <code><nowiki>|【字符串代号】=【样式文本】</nowiki></code>，其中<code>【】</code>内为用户填写内容（注意填写时不要加【】，除非代号与文本内确有此内容）。

;{{tl|切换显示按钮样式}}：
:{{color|#0099FF|可选}}，用以指定按钮样式。本模板没有数量限制<del>但是一个就够用了</del>。
:* 参数格式如下：
:** <code><nowiki>|【字符串代号】=【样式文本】</nowiki></code>：指定字符串代号对应按钮的通用样式；
:*** <code><nowiki>|【字符串代号】@on=【样式文本】</nowiki></code>：指定字符串代号对应按钮'''激活时'''的样式（普通模式下按钮复选框/单选框'''勾选'''时激活，反转模式下按钮复选框/单选框'''未勾选'''时激活）；
:*** <code><nowiki>|【字符串代号】@off=【样式文本】</nowiki></code>：指定字符串代号对应按钮'''未激活时'''的样式（普通模式下按钮复选框/单选框'''未勾选'''时激活，反转模式下按钮复选框/单选框'''勾选'''时激活）；
:*** <code><nowiki>|【字符串代号】@input=【样式文本】</nowiki></code>：指定单选框“圆点”和复选框“对勾背景”的样式（仅在显示这些内容的情况下生效）；
:*** <code>【字符串代号】</code>为<code>@cancel</code>时将指定“取消选择”按钮的样式（所有“取消选择”按钮都使用该样式）；
:**** <code>@cancel@on</code>指定“取消选择”按钮'''未激活时'''的样式；
:**** <code>@cancel@off</code>指定“取消选择”按钮'''激活时'''的样式；
:**** <code>@cancel=display:none</code>可以隐藏“取消选择”按钮；
:其中，<code>on</code>和<code>off</code>样式优先于通用样式，仅在未指定<code>on</code>和<code>off</code>样式的情况下才会使用通用样式。

;'''{{color|red|注：}}{{tl|切换显示样式}}和{{tl|切换显示按钮样式}}都可以指定按钮文本样式。当二者同时存在时，{{tl|切换显示按钮样式}}优先级高于{{tl|切换显示样式}}。'''

== [[Template:切换显示/doc/示例|示例]] ==
{{切换显示按钮|wjz@on=示例已展开|wjz@off=展开示例}}
{{切换显示按钮样式|wjz@on=opacity:0.6;|wjz@off=border-left-width:1px;font-weight:bold;border-color:red;color:red;}}
{{切换显示|wjz|{{Template:切换显示/doc/示例}}<nowiki/>|div}}

== 根元素标签 ==
;'''本段文字说明的是{{tl|切换显示}}的 <code>参数3</code> 及{{tl|切换显示/模板}}的参数 <code>@tag</code>。'''
:* 该参数的参数值可选<code>div</code>、<code>span</code>等，默认值为<code>span</code>。
:** 当参数值为<code>span</code>时，字符串根元素为行内元素。需要换行的模板在此情况下无法隐藏，将一直显示；
:** 当参数值为<code>div</code>时，字符串根元素为块状元素。需要换行的模板在此情况下可以隐藏，随按钮的激活与否保持显示/隐藏状态；
:** 不需要换行的模板不受参数值的限制，但会根据字符串根元素的类型而改变版式。
;<big>示例：</big>
;需要换行的模板
<div>参数3的参数值为<code>span</code>时（此时本模板无法生效）：<pre>{{切换显示按钮
|span1=显示gifts
}}{{切换显示|span1|
{{bilibiliVideo|id=BV1nC4y147iy|page=1|width=600|height=421|autoplay=yes}}<nowiki/>
|span}}</pre>
{{切换显示按钮
|span1=显示gifts
}}{{切换显示|span1|
{{bilibiliVideo|id=BV1nC4y147iy|page=1|width=600|height=421|autoplay=yes}}<nowiki/>
|span}}</div>

<div>参数3的参数值为<code>div</code>时：<pre>{{切换显示按钮
|div1=显示gifts
}}{{切换显示|div1|
{{bilibiliVideo|id=BV1nC4y147iy|page=1|width=600|height=421|autoplay=yes}}<nowiki/>
|div}}</pre>
{{切换显示按钮
|div1=显示gifts
}}{{切换显示|div1|
{{bilibiliVideo|id=BV1nC4y147iy|page=1|width=600|height=421|autoplay=yes}}<nowiki/>
|div}}</div>
<br/>
;不需要换行的模板
<div>参数3的参数值为<code>span</code>时：<pre>{{切换显示按钮
|span2=显示丘比
}}{{切换显示|span2|
{{颜文字|丘比}}<nowiki/>
|span}}</pre>
{{切换显示按钮
|span2=显示丘比
}}{{切换显示|span2|
{{颜文字|丘比}}<nowiki/>
|span}}</div>

<div>参数3的参数值为<code>div</code>时：<pre>{{切换显示按钮
|div2=显示丘比
}}{{切换显示|div2|
{{颜文字|丘比}}<nowiki/>
|div}}</pre>
{{切换显示按钮
|div2=显示丘比
}}{{切换显示|div2|
{{颜文字|丘比}}<nowiki/>
|div}}</div>

== 需要换行的wikitext ==
;添加表格
:'''{{color|red|注：}}'''由于表格wikitext较为{{rubyh|娇贵|恶心}}，里面所有带有<code>{{!}}</code>的格式符号都需要进行替换。
:当然，任何时候<code><nowiki>=</nowiki></code>都需要替换。
{{example|pre=<nowiki>{{切换显示按钮|data1=表格|@default=data1}}
{{切换显示|data1|<nowiki/>
{{(!}} class{{=}}"wikitable sortable"
{{!-}}
! A
! B
{{!-}}
{{!}} 1
{{!}} 2
{{!-}}
{{!}} 3
{{!}} 4
{{!)}}|div}}{{切换显示样式|data1=color: red; font-weight: 700;}}</nowiki>}}
<br/>
;添加其他需要换行的wikitext
:'''{{color|red|注：}}'''此处的<code><nowiki><nowiki/></nowiki></code>与wikitext之间应换行，否则wikitext会失效。
{{example|pre=<nowiki>{{切换显示按钮|data2=列表|@default=data2}}
{{切换显示|data2|<nowiki/>
* A
* B
*# C
*# D
# 3
##8
; E
: F
|div}}{{切换显示按钮样式|data2=border-color:red}}</nowiki>}}

== 重定向 ==
# 别名：
#* [[Template:切换显示]]又名[[Template:文本切换显示]]、[[Template:Switch]]；
#* [[Template:切换显示/模板]]又名[[Template:文本切换显示/模板]]、[[Template:Switch/Template]]；
#* [[Template:切换显示按钮]]又名[[Template:文本切换显示按钮]]、[[Template:Switch/Button]]；
#* [[Template:切换显示样式]]又名[[Template:文本切换显示样式]]、[[Template:Switch/Style]]；
#* [[Template:切换显示按钮样式]]又名[[Template:文本切换显示按钮样式]]、[[Template:Switch/Button/Style]]。<noinclude>[[Category:模板文档]]</noinclude>