模板:切换显示/doc

来自维阿百科
< 模板:切换显示
霓虹灯鱼讨论 | 贡献2023年9月26日 (二) 19:36的版本 (创建页面,内容为“本系列模板用以手动显示/隐藏特定字符串,并批量指定字符串及按钮样式。 == 用法 == ;注意字符串代号可以用小写英文字母…”)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳转至: 导航搜索

本系列模板用以手动显示/隐藏特定字符串,并批量指定字符串及按钮样式。

用法

注意字符串代号可以用小写英文字母、大写英文字母、汉字等(不被视为wikitext):
  • 不得包含'"<>\/|$,不得以@开头,否则将被无视;
  • 大小写、繁简敏感,请牢记。
{{切换显示|参数1|参数2|参数3}}:
必需,用以指定需要手动切换的字符串。本模板没有数量限制。
  • 参数1:字符串代号;
  • 参数2:字符串内容(wikitext格式);
    • 在参数3未指定为块元素名时参数2不可以填写需要换行的wikitext,反之当参数3指定为块元素名时参数2没有任何限制(参见#需要换行的wikitext)。
  • 参数3可选,用以指定字符串根元素的标签名(默认为span)(参见#根元素标签)。
{{切换显示/模板|@=【模板名称】|@tag=【根元素标签】|【参数1】=|【参数2】@【字符串代号1】=|…}}:
必需,是{{切换显示}}的包装(即本模板是{{切换显示}}的特殊实现,与之等价),用以指定需要手动切换一个模板的某个/些参数的字符串,以减少代码书写量,提高可阅读性。本模板没有数量限制。
  • 参数格式中【】内为用户填写内容(注意填写时不要加【】,除非代号与文本内确有此内容)。
  • 参数@:调用的目标模板的名称,不需要加模板:名字空间前缀;
  • 参数@tag可选,同{{切换显示}}的参数3,用以指定字符串根元素的标签名(默认为span)(参见#根元素标签);
  • 格式参数:调用的目标模板的参数的名称;
    • 参数名称与直接调动目标模板所需要书写的参数名称基本一致。唯一区别是,目标模板参数名称中的每个@字符都需要写成2个(@@,以免和表示参数名称与字符串代号间隔的1个@字符混淆;
  • 格式字符串代号:字符串代号;
    • 若不填写格式字符串代号,这个参数的值将会作为所有字符串代号的默认值
注:{{切换显示/模板}}实际上多次调用了目标模板,而非仅对参数部分进行处理。若目标模板代码中包含计数器等(设计时未考虑重复调用情况),需要注意对其状态进行重置。
{{切换显示按钮|@default=|@radio=|@reverse=|@forceNoCancel=|@toggleClass=|【字符串代号1】=【按钮文本1】|…}}:
必需,用以显示切换按钮,本模板没有数量限制。若一个本模板中有多个“字符串代号”,则这些“字符串代号”对应的按钮将并排显示。
  • 参数格式为 |【字符串代号】=【按钮文本】,其中【】内为用户填写内容(注意填写时不要加【】,除非代号与文本内确有此内容)。
    【按钮文本】为wikitext格式,但其内的点击事件不会被触发(即链接、缩略图等无法点开)。
    • 可选格式如下(仅@on@off会被识别为参数,“@+其他任意字符”则会被识别为“字符串代号”的一部分):
      • |【字符串代号】@on=【按钮文本】:指定字符串代号对应按钮激活时显示的按钮文本(普通模式下按钮复选框/单选框勾选时显示,反转模式下按钮复选框/单选框未勾选时显示);
      • |【字符串代号】@off=【按钮文本】:指定字符串代号对应按钮未激活时显示的按钮文本(普通模式下按钮复选框/单选框未勾选时显示,反转模式下按钮复选框/单选框勾选时显示)。
    • 另外,如果 【字符串代号】包含$,那么该按钮绑定的实际代号为 【字符串代号】$分割后的数组,通过此方法可以将单一按钮绑定到多个元素上。
  • 另外,可以选择配置以下选项:
    • @default可选,用以指定默认激活的按钮(此处的参数值为该按钮对应的字符串代号);
    • @radio可选,参数值不为空时将会使该模板内的按钮变为单选框,一次只能显示一种字符串;
      • 使用该参数时单选按钮旁边会显示“取消选择”按钮。
    • @reverse可选,参数值不为空时将会使该模板内的按钮变为反转模式:没有勾选的将会显示,勾选的将会隐藏;
    • @forceNoCancel可选,参数值不为空且@radio@default均不为空时强制隐藏取消选择单选框。
    • @toggleClass可选,参数值不为空时可以指定切换显示具体切换的 class 名称;此 class 默认为hidden,所以只要改成hidden以外的 class 名称就可以不隐藏切换显示的内容、而是改为利用 CSS 样式表应用不同的显示效果。
注:{{切换显示}}与{{切换显示按钮}}的位置决定了字符串和按钮的位置关系,例如编辑文档时{{切换显示}}在{{切换显示按钮}}的前面,则显示内容时字符串在按钮的前面,反之亦然。
{{切换显示样式|【字符串代号1】=【样式文本1】|…}}:
可选,用以批量指定某些需要手动切换的字符串的样式,会同时影响按钮内文字的样式(普通模式下按钮复选框/单选框勾选时激活,反转模式下按钮复选框/单选框未勾选时激活)。本模板没有数量限制但是一个就够用了
  • 参数格式为 |【字符串代号】=【样式文本】,其中【】内为用户填写内容(注意填写时不要加【】,除非代号与文本内确有此内容)。
{{切换显示按钮样式}}:
可选,用以指定按钮样式。本模板没有数量限制但是一个就够用了
  • 参数格式如下:
    • |【字符串代号】=【样式文本】:指定字符串代号对应按钮的通用样式;
      • |【字符串代号】@on=【样式文本】:指定字符串代号对应按钮激活时的样式(普通模式下按钮复选框/单选框勾选时激活,反转模式下按钮复选框/单选框未勾选时激活);
      • |【字符串代号】@off=【样式文本】:指定字符串代号对应按钮未激活时的样式(普通模式下按钮复选框/单选框未勾选时激活,反转模式下按钮复选框/单选框勾选时激活);
      • |【字符串代号】@input=【样式文本】:指定单选框“圆点”和复选框“对勾背景”的样式(仅在显示这些内容的情况下生效);
      • 【字符串代号】@cancel时将指定“取消选择”按钮的样式(所有“取消选择”按钮都使用该样式);
        • @cancel@on指定“取消选择”按钮未激活时的样式;
        • @cancel@off指定“取消选择”按钮激活时的样式;
        • @cancel=display:none可以隐藏“取消选择”按钮;
其中,onoff样式优先于通用样式,仅在未指定onoff样式的情况下才会使用通用样式。
注:{{切换显示样式}}和{{切换显示按钮样式}}都可以指定按钮文本样式。当二者同时存在时,{{切换显示按钮样式}}优先级高于{{切换显示样式}}。

示例

示例已展开展开示例

根元素标签

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

显示gifts显示gifts

宽屏模式显示视频
参数3的参数值为div时:
{{切换显示按钮
|div1=显示gifts
}}{{切换显示|div1|
{{bilibiliVideo|id=BV1nC4y147iy|page=1|width=600|height=421|autoplay=yes}}<nowiki/>
|div}}
显示gifts显示gifts


不需要换行的模板
参数3的参数值为span时:
{{切换显示按钮
|span2=显示丘比
}}{{切换显示|span2|
{{颜文字|丘比}}<nowiki/>
|span}}

显示丘比显示丘比

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

需要换行的wikitext

添加表格
注:由于表格wikitext较为娇贵恶心,里面所有带有|的格式符号都需要进行替换。
当然,任何时候=都需要替换。
{{切换显示按钮|data1=表格|@default=data1}}
{{切换显示|data1|<nowiki/>
{{(!}} class{{=}}"wikitable sortable"
{{!-}}
! A
! B
{{!-}}
{{!}} 1
{{!}} 2
{{!-}}
{{!}} 3
{{!}} 4
{{!)}}|div}}{{切换显示样式|data1=color: red; font-weight: 700;}}

表格表格