Module:Utawari/doc

简介

此模块作为模板{{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：模块的自定义换行字符串。
  • （默认）当值为空时，等同于值为两个“回车换行符（\r\n）”。
• （各行歌词）（匿名参数） = 歌割中的和声部分。这部分参数兼容{{LyricsKai}}/{{LyricsKai/colors}}的使用格式，更高阶的拓展格式请见模板:Utawari/doc#用法章节。

用法

此模块的功能与用法与模板{{Utawari}}基本相同。建议仅当歌割り中歌词超过9句时使用本模块。

更多详细用法请见：模板:Utawari/doc。

贡献者

• サンムル[更多]讨论页贡献上传历史封禁及历史被删贡献移动日志巡查日志用户权限及日志用户查核
• Nzh21[更多]讨论页贡献上传历史封禁及历史被删贡献移动日志巡查日志用户权限及日志用户查核
• 迟昫123[更多]讨论页贡献上传历史封禁及历史被删贡献移动日志巡查日志用户权限及日志用户查核
• Silverpearl[更多]讨论页贡献上传历史封禁及历史被删贡献移动日志巡查日志用户权限及日志用户查核

版本历史

模块版本历史  

这个版本历史文档嵌入自模块:Utawari/versionhistory。

• 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的形式重构输出代码。