模板:LyricsKai/colors/doc

简介

该模板是{{LyricsKai}}的衍生模板，主要用于简便对歌词中使用多种颜色来分辨不同演唱者的操作。

该模板有一个衍生模板{{LyricsKai/colors/hover}}，实现当指针悬停于歌词上时改变歌词背景颜色。

注意：{{LyricsKai}}提供了排版，以及歌词和翻译着色的功能，当歌词不需要大量复杂变化的着色时，请使用{{LyricsKai}}，以防止歌词中的特殊符号被解析为标记，或造成不必要的性能损失。

参数

• colors：所有角色的颜色，中间使用;(半角分号)隔开，最多支持99个。支持为颜色设置一个别名。自动清除各颜色间首尾的空格和换行。

除正常颜色值外，还支持利用CSS3的background-clip属性与渐变色函数实现的渐变色文字，关于这些属性的兼容性问题，请自行搜索。

• lg：线性渐变，最为常用的渐变模式，写法为lg( 参数 )，以下写法均如此，以此类推，具体参数写法请参考该页面，也可以参照{{Gradient_Text}}中的渐变色写法。
• rg：径向渐变，具体参数写法请参考该页面
• rlg：重复线性渐变，具体参数写法请参考该页面
• rrg：重复径向渐变，具体参数写法请参考该页面

注意：该模板中使用的是兼容写法的渐变色函数，请在设置渐变色方向时前面不要加“to”

• co：交替颜色，写法为co( 参数 )，中间的颜色以,(半角逗号)隔开，颜色数量不限。
• rb：纵向排列色，写法同上，颜色数量不限。

注意：只能填颜色值，不能套用上面的渐变色函数

• charas：所有角色的名字，中间使用；(全角分号)隔开，这些角色名将和colors参数中的颜色一一对应，当鼠标放在那个颜色上的歌词时，将显示角色名。

可以在总颜色数量上再多加一个名字，作为全局颜色（由参数lstyle以及rstyle定义的颜色，或默认的黑色）的显示文字。自动清除各角色名间首尾的空格和换行。

• 该参数并不是必填参数。
• 在移动端点触歌词时将在演唱者所属歌词的开始处显示用于提示演唱者的信息框，但在点击合唱（全局颜色）的歌词时无效。

开关：

• traColors：为“on”时，启用translated参数（翻译栏）中的标记解析。
• charaBlock：为“on”时，在歌词栏上方生成一组类似{{charaBlock}}的角色颜色提示。

请仔细阅读以下charaBlock的生成规则及其开启后对其他参数的影响：

1. 生成的charaBlock样式固定，默认带有链接。
2. 生成的内容采集自colors参数中的单色（非渐变色或交替色），各个色块旁的文字与charas中的角色名对应。
3. 自动在最后生成“合唱”的色块，颜色采集自lstyle参数中的color属性，文字默认为“合唱”，若添加了模板:注释，则使用那个的文字，若设置了参数groupName，则该参数的文字优先使用（也就是说优先级为：groupName参数 > 全局颜色显示文字 > 默认文字“合唱”）。但lstyle参数中如果没有设置color属性，则该色块不会显示。
4. charas参数中开始进行链接的括号消歧义：例如诺艾尔(天体的秩序)将在鼠标放置文字时显示的文字和charaBlock中显示为诺艾尔，但链接指向不变。不支持其他类型的消歧义。
5. charas参数中在角色名后加上(@nolink)，可以阻止charaBlock进行自动添加链接。
6. charas参数中在角色名后加上(@link:链接)，可以设置指向的链接
7. 若开启该参数后对模板的使用有任何影响，或生成的信息有误，无法满足的消歧义格式等，请关闭该参数并使用{{charaBlock}}或其他模板等手动列出角色的歌词颜色提示。

其他参数与{{LyricsKai}}相同。

关于“合唱”提示栏和charaBlock“合唱”色块的显示

合唱提示栏：默认显示文字为“合唱”，当设置了“模板:注释”，则使用那个文字的值，若有chorusName参数，则必定使用那个参数的值。

合唱色块：charaBlock中的合唱色块只在lstyle中定义了color属性时才会显示。

charaBlock的合唱色块显示文字默认值为“合唱”、若有“模板:注释”，则使用那个文字的值，若有groupName参数，则必定使用那个参数的值。

groupName参数可以添加样式，但不能使用链接。

简而言之就是：如果在charas中多写了一个名字，那么那个名字就是合唱提示栏的显示文字。如果设置了groupName，那么charaBlock自动生成的合唱色块一定显示groupName参数的文字。

用法

以@n为标记，n为colors中第n个颜色，如设置了colors= red; blue; #666，@1就是red，@2就是blue，@3就是#666。

以@[...]为标记，“...”为在colors中设置的别名，或是在charas中设置的对应角色名（如果有括号则为删去括号的文字），如设置了：

colors= red = cocoa; blue
charas= 心爱；智乃

此时，@1、@[cocoa]、@[心爱]都为red，@2和@[智乃]都为blue。这在修改一些颜色过多的歌词时尤其有效，省去了查找数字所对应颜色及角色的时间。

该标记向后包括，直到一行结束，若中途遇到其他标记，则中止。

若歌词中有「@」、「$」、与@n相连的数字0-9，与@相连的「[」，均需要用「$」进行转义。

关于注音文字的交替色使用

为了保证单个文字和注音可以正确进行颜色交替，请单独使用{{rubya}}模板。

若读音无法和文字一一对应，请自行处理。

{{LyricsKai/colors
|colors= co(red, gray)
|original=
@1{{rubya|白、しら|樺、かば}}　{{rubya|青、あお|空、ぞら}}　{{rubya|南、みなみ|風、かぜ}}
}}

本段落中所使用的歌词，其著作权属于原权利人，仅以介绍为目的引用。

白しら樺かば

　青あお空ぞら

　南みなみ風かぜ

示例

示例1

{{LyricsKai/colors |colors= green; orange; #ccc; lg(left, red, blue); co(red, blue, pink); rb(red, blue) |charas= 保登心爱；香风智乃；天天座理世；桐间纱路；保登摩卡 |traColors= on |original= @1我是第一句歌词 <!-- 默认直接包括到行尾 --> @2我是第二@3句歌词 <!-- 一句上多种颜色的写法 --> @1我是@第三@2句歌词 <!-- 使用一个后面无数字的「@」符号中止向后包括 --> @2我是第@10四句歌词 <!-- 使用未声明的颜色标记无效 -->

@1$2我是$@第五句$$歌词 <!-- 转义的用法 -->

@4这里是会渐变的第六句歌词~（线性渐变） @5这里是交替颜色的第七句歌词~ @6这里是纵向排列色的第八句歌词~

<!-- 以下为标记和html标签或模板的混合写法示例 -->

最{{ruby|讨厌|@1喜欢@}}你了 <span style="text-shadow:2px 2px 3px #666">@2求这段文字@的阴影@1面积@</span> @3<span style="background:#eee">こんなに</span>{{ruby|好|す}}きなことは　{{ruby|内緒|ないしょ}}@なの |translated= @2在翻译中也是可以使用的 }}

效果：

本段落中所使用的歌词，其著作权属于原权利人，仅以介绍为目的引用。

我是第一句歌词

在翻译中也是可以使用的

我是第二句歌词

我是第三句歌词

我是第四句歌词

2

我是@

第五句$

歌词

这里是会渐变的第六句歌词~（线性渐变）

这里是交替颜色的第七句歌词~

这里是纵向排列色的第八句歌词~

最讨厌喜欢你了

求这段文字的阴影面积

こんなに好すきなことは　内緒ないしょなの

示例2

{{LyricsKai/colors |lstyle=color:orange |colors= red = cocoa; blue; co(red, blue); green; #A0F781; |charas= 保登心爱；香风智乃(@nolink)；心爱&智乃；诺艾尔(天体的秩序)；保登心爱的姐姐(@link:保登摩卡)；全员 <!-- 额外添加的全局显示文字默认不生成链接 --> |traColors= on |charaBlock= on |groupName= 我是合唱色块的显示文字 <!-- 如果没设置这个参数，则会显示【额外添加的全局显示文字】(也就是在上面设置的“全员”) --> |chorusName= 我是合唱提示框的显示文字 <!-- 如果没设置这个参数，则会显示【额外添加的全局显示文字】(也就是在上面设置的“全员”) --> |original= @[cocoa]我是第一句歌词 @[香风智乃]我是第二句歌词 @3我是第三句歌词 我显示的是全局颜色 |translated=

}}

本段落中所使用的歌词，其著作权属于原权利人，仅以介绍为目的引用。

 保登心爱  香风智乃  诺艾尔  保登心爱的姐姐  我是合唱色块的显示文字 

我是第一句歌词

我是第二句歌词

我是第三句歌词

我显示的是全局颜色