Semi-chord 是一个实现和弦转换的 JavaScript 库，可以将和弦名称转换为指定的和弦形状和品格，并支持自定义和弦库和使用和维护。
本文将介绍 npm 包 semi-chord 的使用教程，包括安装、导入、使用方法和示例代码。
安装
在使用 semi-chord 之前，需要在项目目录下安装该 npm 包。
npm install semi-chord
导入
在项目中导入 semi-chord。
const semiChord = require('semi-chord');使用方法
转换和弦名称
semiChord.toShape(name, tone)
将和弦名称转换为指定的和弦形状和品格。
name: <string> 要转换的和弦名称。
tone: <string> 选定的基调。如果没有选定的基调，则默认为 C。
semiChord.toShape('C', 'major') // => 'x32010'
semiChord.toShape('D', 'minor') // => 'xx0231'
semiChord.toShape('G', '7') // => '320001'将和弦转换为指定的和弦形状和音。
semiChord.toNotes(name)
name: <string> 要转换的和弦名称。
semiChord.toNotes('Cmaj7') // => ['C', 'E', 'G', 'B']
semiChord.toNotes('Am7') // => ['A', 'C', 'E', 'G']
semiChord.toNotes('G7') // => ['G', 'B', 'D', 'F']自定义和弦库
semiChord.setChordLibrary(library)
设置自定义和弦库。
library: <object> 包含和弦名称和形状的库。
-- -------------------- ---- ------- --------------------------- --------- --------- ----- --------- ------ -------- --- --------------------------- -- -- -------- ----------------------- -- -- -------- ------------------------ -- -- --------
和弦库的切换
semiChord.switchChordLibrary(libraryName)
切换到指定的和弦库。
libraryName: <string> 要切换到的和弦库的名称。
-- -------------------- ---- -------
---------------------------
----------- -
--------- ---------
----- ---------
------ --------
--
----------- -
-------- ---------
----- ---------
------ --------
-
---
-----------------------------------------
--------------------------- -- -- --------
----------------------- -- -- --------
------------------------ -- -- --------
-----------------------------------------
-------------------------- -- -- --------
----------------------- -- -- --------
------------------------ -- -- --------示例代码
-- -------------------- ---- ------- ----- --------- - ---------------------- -- ----------- ----- --------- - ----- ----- ----- - ----------------------------- ------------------------- ---------------- -- -- --- ------------ -- ------------ --------------------------- --------- --------- ----- --------- ------ -------- --- ----- ---------- - --------- ----- ------ - ------------------------------ -------------------------- ----------------- -- -- ------- ------------ -- ---------- ----------------------------------------- ----- ---------- - -------- ----- ------ - ------------------------------ -------------------------- ----------------- -- -- ------ ------------
总结
npm 包 semi-chord 可以帮助前端开发者实现和弦转换的功能，并且支持自定义和弦库。本文介绍了安装、导入、使用方法以及示例代码，希望对大家的前端开发工作有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600562dd81e8991b448e04e9