模板:角色信息按键/doc

现有角色按键目录

示例

一行一个

不填写配音演员

您所输入的

{{角色信息按键|四不像}}

您所看到的

四不像

填写配音演员

您所输入的

{{角色信息按键|四不像|图特哈蒙}}

您所看到的

四不像
配音:图特哈蒙

一行多个

使用 <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。但注意不应过分影响样式代码的可读性和复杂度。