模板文檔 | 此模板使用Lua語言： |
本系列模板用以手動顯示/隱藏特定字符串，並批量指定字符串及按鈕樣式。
用法
- 注意字符串代號可以用小寫英文字母、大寫英文字母、漢字等（不被視為wikitext）：
- 不得包含
'、"、<、>、\、/、|、$，不得以@開頭，否則將被無視； - 大小寫、繁簡敏感，請牢記。
- {{切換顯示|參數1|參數2|參數3}}：
- 必需，用以指定需要手動切換的字符串。本模板沒有數量限制。
- 參數
1：字符串代號； - 參數
2：字符串內容（wikitext格式）；- 在參數3未指定為塊元素名時參數2不可以填寫需要換行的wikitext，反之當參數3指定為塊元素名時參數2沒有任何限制（參見#需要換行的wikitext）。
- 參數
3：可選，用以指定字符串根元素的標籤名（默認為span）（參見#根元素標籤）。
- 參數
- {{切換顯示/模板|@=【模板名稱】|@tag=【根元素標籤】|【參數1】=|【參數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可以隱藏「取消選擇」按鈕；
- 參數格式如下：
- 其中，
on和off樣式優先於通用樣式，僅在未指定on和off樣式的情況下才會使用通用樣式。
示例
示例已展開展開示例
根元素標籤
- 本段文字說明的是{{切換顯示}}的
參數3及{{切換顯示/模板}}的參數@tag。 -
- 該參數的參數值可選
div、span等，默認值為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;}}
表格表格
- 添加其他需要換行的wikitext
- 註：此處的
<nowiki/>與wikitext之間應換行，否則wikitext會失效。
{{切換顯示按鈕|data2=列表|@default=data2}}
{{切換顯示|data2|<nowiki/>
* A
* B
*# C
*# D
# 3
##8
; E
: F
|div}}{{切換顯示按鈕樣式|data2=border-color:red}}
列表列表
重新導向
- 別名：