模板:注释

说明文档

bugfix250107.1

本模板使用OOui实现，修改时请注意和全站JS/CSS的配合。

使用场景

用来高亮需要注解的文字，并在鼠标悬停于文字时显示注解（部分手机版页面则为直接显示）。

请注意，为文字添加注释的首选方式是注脚（即页内<ref></ref>+页脚<references/>的形式），只有在使用注脚的效果不理想的时候，才应当考虑使用本模板，主要包括以下几种情况：

1. 当页面中有较多内容需要注解，尤其是系统性地需要注解时，使用<ref></ref>可能会造成页脚处有大量意义不明的注释，而用本模板可以较为美观地解决问题。
   • 例如：以无敌状态^{(注)持续2.2秒}对面前的一名敌人突进；对目标造成大幅度^{(注)26*(技能等級+1)+2.1*魔法攻击}的魔法伤害；对目标周围^{(注)范围450内}的敌人造成中幅度^{(注)24*(技能等級+1)+1.89*魔法攻击}的魔法伤害。
2. 有时用<ref></ref>会造成注解的范围有歧义，需要在注释中解释，比较啰嗦，而本模板不会遇到这个问题。
   • 例如：某活动将会举办两次，时间分别为5月20日和6月29日^(注)暂定。
3. 当需要注解的内容出现在某些模板（例如页顶模板）中时，将注解放在页脚不一定合理。

用法示例

代码	效果
你{{注释|萝莉|萝莉通常是指出现在动漫中5-13岁的女性，或者拥有5-13岁女性外貌的女性}}！你全家都萝莉！	你萝莉(注)萝莉通常是指出现在动漫中5-13岁的女性，或者拥有5-13岁女性外貌的女性！你全家都萝莉！
我明天{{color|green|{{bgcolor|black|{{注释|更新|假的}}}}}}！	我明天更新(注)假的！
有些时候为了显示更加美观{{注释||因为黄色底色过于难看}}可以将第一参数留空。	有些时候为了显示更加美观(注)因为黄色底色过于难看可以将第一参数留空。

上述第二个例子中使用了{{color}}和{{bgcolor}}模板，但其中需注解文字的背景颜色和注释角标的文字颜色分别被本模板覆盖。如果需要更加精细的颜色控制，或需要修改注释角标上的文字等，可以直接使用本模板所基于的{{高亮文字}}模板。

注意事项

由于技术或网络环境，有时候不能正常显示注解的效果。

注释

---

所有模板列表