模板: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：縱向排列色，寫法同上，顏色數量不限。
- 注意：只能填顏色值，不能套用上面的漸變色函數
- lg：線性漸變，最為常用的漸變模式，寫法為
- charas：所有角色的名字，中間使用
；(全形分號)隔開，這些角色名將和colors參數中的顏色一一對應，當鼠標放在那個顏色上的歌詞時，將顯示角色名。
- 可以在總顏色數量上再多加一個名字，作為全局顏色（由參數
lstyle以及rstyle定義的顏色，或默認的黑色）的顯示文字。自動清除各角色名間首尾的空格和換行。- 該參數並不是必填參數。
- 在移動端點觸歌詞時將在演唱者所屬歌詞的開始處顯示用於提示演唱者的信息框，但在點擊合唱（全局顏色）的歌詞時無效。
開關：
- traColors：為「on」時，啟用translated參數（翻譯欄）中的標記解析。
- charaBlock：為「on」時，在歌詞欄上方生成一組類似{{charaBlock}}的角色顏色提示。
- 請仔細閱讀以下charaBlock的生成規則及其開啟後對其他參數的影響：
- 生成的charaBlock樣式固定，默認帶有連結。
- 生成的內容採集自colors參數中的單色（非漸變色或交替色），各個色塊旁的文字與charas中的角色名對應。
- 自動在最後生成「合唱」的色塊，顏色採集自lstyle參數中的color屬性，文字默認為「合唱」，若添加了額外的charas全局顏色顯示文字(註)見charas參數第二行介紹，則使用那個的文字，若設置了參數groupName，則該參數的文字優先使用（也就是說優先級為：groupName參數 > 全局顏色顯示文字 > 默認文字「合唱」）。但lstyle參數中如果沒有設置color屬性，則該色塊不會顯示。
- charas參數中開始進行連結的括號消歧義：例如
诺艾尔(天体的秩序)將在鼠標放置文字時顯示的文字和charaBlock中顯示為诺艾尔，但連結指向不變。不支持其他類型的消歧義。 - charas參數中在角色名後加上
(@nolink)，可以阻止charaBlock進行自動添加連結。 - charas參數中在角色名後加上
(@link:链接)，可以設置指向的連結 - 若開啟該參數後對模板的使用有任何影響，或生成的信息有誤，無法滿足的消歧義格式等，請關閉該參數並使用{{charaBlock}}或其他模板等手動列出角色的歌詞顏色提示。
其他參數與{{LyricsKai}}相同。
關於「合唱」提示欄和charaBlock「合唱」色塊的顯示
合唱提示欄：默認顯示文字為「合唱」，當設置了「額外的charas全局顏色顯示文字(註)見charas參數第二行介紹」，則使用那個文字的值，若有chorusName參數，則必定使用那個參數的值。
合唱色塊：charaBlock中的合唱色塊只在lstyle中定義了color屬性時才會顯示。
charaBlock的合唱色塊顯示文字默認值為「合唱」、若有「額外的charas全局顏色顯示文字(註)見charas參數第二行介紹」，則使用那個文字的值，若有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
{{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=
}}
本段落中所使用的歌詞，其著作權屬於原著作權人，僅以介紹為目的引用。
保登心愛 香風智乃 諾艾爾 保登心愛的姐姐 我是合唱色塊的顯示文字
實際用例可以參考：Buonappetito S、Memories、舞台少女心得 幕間等