模組: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的形式重構輸出代碼。