示例
一行一個
不填寫配音演員
填寫配音演員
配音:圖特哈蒙
一行多個
使用 <div class='characters-list'>...</div>
將按鍵包裹
樣板
<div class='characters-list'>
{{角色信息按键|辟邪}}
{{角色信息按键|二两}}
{{角色信息按键|兔爷}}
{{角色信息按键|谛听|藤新}}
{{角色信息按键|金角|咩咩}}
{{角色信息按键|银角|阎么么}}
</div>
模板數據
此模板用於顯示出場角色。
參數 | 描述 | 類型 | 狀態 | |
---|---|---|---|---|
角色姓名 | 1 | 角色姓名
| 行 | 必填 |
配音演員姓名 | 2 | 配音演員名稱,不填寫時將不會顯示。
| 行 | 必填 |
自定義圖片 | 自定义图片 | 此參數用於自定義按鈕使用圖片。 | 行 | 不建議使用 |
鏈接實現細節
MediaWiki要求wikitext中的鏈接只能使用[[]]
或[]
的格式。模板引擎會自動移除<a>
等禁止直接使用的HTML元素。此外,模板引擎也不允許在鏈接文本中嵌入另一個鏈接(注意HTML標準並不允許嵌套<a>
元素)或者圖片(即使通過link=
移除了可點擊的<a>
)。這限制了鏈接的靈活度,不方便使整個按鈕區域都成為可點擊的hotspot。為了繞過這一技術限制,本模板使用了一個占位元素<div class="character-bg">
覆蓋在按鈕上作為鏈接的點擊區域。在版本53726前,本模板使用File:灰色背景.png作為鏈接的占位符並利用圖片鏈接才可使用的link=
參數建立了到角色頁的鏈接。
即使MediaWiki沒有限制<a>
元素,想僅憑模板魔術字模擬wikitext原生鏈接的效果也是較為困難的。到不存在頁面的鏈接應該顯示為紅鏈,模板中判斷目標頁面是否存在可以使用#ifexist
解析器函數,但大量使用它會帶來性能問題。
版本53727嘗試使用aria-hidden="true"
屬性來對屏幕閱讀器隱藏占位符.character-bg
內的鏈接,以避免與.character-name-comic
內的鏈接重複。然而僅這麼做不能改變<a>
鏈接的focusable狀態,使用鍵盤Tab鍵仍能選中占位元素鏈接。解決此問題需要給<a>
元素設置tabindex="-1"
屬性,然而受上文提到的技術限制無法在wikitext的層面做到(另見 commit b186b20),若確實有此需求可能更適合用javascript完成。
有意移除占位元素的編者亦可嘗試給.character-name-comic
內的<a>
設置較大的padding。但注意不應過分影響樣式代碼的可讀性和複雜度。