这是Module:Utawari的文档页面
简介
此模块作为模板{{Utawari}}的背后实现，主要用于简便地书写歌割り对齐的歌词。
在仅有不超过9句歌割り歌词时，建议使用模板{{Utawari}}。
根据2018年11月19日-2018年11月22日关于宽屏/窄屏缩进行为的讨论，目前的效果为：
- 歌词模式下：
- 宽屏设备浏览时显示缩进；
- 窄屏设备浏览时隐藏缩进。
- 非歌词模式下：
- 宽屏/窄屏设备浏览时均显示缩进。
参数
使用格式：
{{#invoke:Utawari[|noLyric=][|lineSeparator=][|第1行歌词[|第2行歌词|...[|第n行歌词]]]}}
- 或者更加直观易读且在原{{LyricsKai}}/{{LyricsKai/colors}}基础上改动最小的格式：
{{#invoke:Utawari[|noLyric=][|lineSeparator=][|
第1行歌词[|
第2行歌词[|
...[|
第n行歌词]]]
}}
lyricMode：是否开启歌词模式。歌词模式详见#歌词模式与#非歌词模式章节。lineSeparator：模块的自定义换行字符串。- （默认）当值为空时，等同于值为两个“
回车换行符（ ）”。
- （默认）当值为空时，等同于值为两个“
（各行歌词）（ ） = 歌割中的和声部分。这部分参数兼容{{LyricsKai}}/{{LyricsKai/colors}}的使用格式，更高阶的拓展格式请见模板:Utawari/doc#用法章节。
用法
此模块的功能与用法与模板{{Utawari}}基本相同。建议仅当歌割り中歌词超过9句时使用本模块。
更多详细用法请见：模板:Utawari/doc。
贡献者
- サンムル[更多]
- Nzh21[更多]
- 迟昫123[更多]
- Silverpearl[更多]
版本历史
- 2018年11月19日 (一) 02:05 代码本地测试通过。模块基础逻辑在本地测试通过，上传调试。
- 2018年11月19日 (一) 03:01 用span标签替换模板输出。输出内容中包含的wiki文本（模版）无法解析，使用HTML的span标签替换，实现等价效果。
- 2018年11月19日 (一) 03:01 添加对用户定制换行字符串功能的支持。增设
lineSeparator参数。 - 2018年11月19日 (一) 15:57 区分歌词模式和非歌词模式的换行行为；修复了不能同时识别标志“#n”和转义“##”的问题。增设
lyricMode参数。 - 2018年11月19日 (一) 17:39 模版转正现在可以通过
Utawari这个名称来使用模版了。 - 2018年11月22日 (四) 00:09 添加对TemplateStyles的支持。依循TemplateStyles格式重构输出代码。添加歌词模式下的缩进在宽屏时显示、窄屏时隐藏的功能。
- 2018年11月22日 (四) 21:16 使用mw.html库重写部分逻辑。舍弃字符串硬编写HTML源代码，使用类似创建DOM的形式重构输出代码。