2023年政策修订增补工作正在进行中,欢迎参与!
  • Moegirl.ICU:萌娘百科流亡社群 581077156(QQ),欢迎对萌娘百科运营感到失望的编辑者加入
  • Moegirl.ICU:账号认领正在试运行,有意者请参照账号认领流程

模板:切換顯示按鈕樣式

萌娘百科,萬物皆可萌的百科全書!轉載請標註來源頁面的網頁連結,並聲明引自萌娘百科。內容不可商用。
跳至導覽 跳至搜尋
Template-info.svg 模板文檔  [查看] [編輯] [歷史] [刷新]

本系列模板用以手動顯示/隱藏特定字符串,並批量指定字符串及按鈕樣式。

用法

注意字符串代號可以用小寫英文字母、大寫英文字母、漢字等(不被視為wikitext):
  • 不得包含'"<>\/|$,不得以@開頭,否則將被無視;
  • 大小寫、繁簡敏感,請牢記。
{{切換顯示|参数1|参数2|参数3}}:
必需,用以指定需要手動切換的字符串。本模板沒有數量限制。
  • 參數1:字符串代號;
  • 參數2:字符串內容(wikitext格式);
    • 在參數3未指定為塊元素名時參數2不可以填寫需要換行的wikitext,反之當參數3指定為塊元素名時參數2沒有任何限制(參見#需要換行的wikitext)。
  • 參數3可選,用以指定字符串根元素的標籤名(默認為span)(參見#根元素標籤)。
{{切換顯示/模板|@=【模板名称】|@tag=【根元素标签】|【参数1】=|【参数2】@【字符串代号1】=|…}}:
必需,是{{切換顯示}}的包裝(即本模板是{{切換顯示}}的特殊實現,與之等價),用以指定需要手動切換一個模板的某個/些參數的字符串,以減少代碼書寫量,提高可閱讀性。本模板沒有數量限制。
  • 參數格式中【】內為用戶填寫內容(注意填寫時不要加【】,除非代號與文本內確有此內容)。
  • 參數@:調用的目標模板的名稱,不需要加Template:命名空間前綴;
  • 參數@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;}}

表格表格


添加其他需要換行的wikitext
註:此處的<nowiki/>與wikitext之間應換行,否則wikitext會失效。
{{切换显示按钮|data2=列表|@default=data2}}
{{切换显示|data2|<nowiki/>
* A
* B
*# C
*# D
# 3
##8
; E
: F
|div}}{{切换显示按钮样式|data2=border-color:red}}

列表列表

重新導向

  1. 別名: