安装
npm install pinyin-pro
# 或
yarn add pinyin-pro
引入
浏览器 script
引入:
<!-- 引入某个版本,如3.5.0版本 -->
<script src="https://cdn.jsdelivr.net/gh/zh-lx/pinyin-pro@3.5.0/dist/pinyin-pro.js"></script>
<!-- 或 -->
<!-- 引入最新版本 -->
<script src="https://cdn.jsdelivr.net/gh/zh-lx/pinyin-pro@latest/dist/pinyin-pro.js"></script>
<script>
var { pinyin } = pinyinPro;
pinyin('汉语拼音'); // 'hàn yǔ pīn yīn'
</script>
git 地址
https://github.com/zh-lx/pinyin-pro
帮助文档:https://github.com/zh-lx/pinyin-pro/blob/main/docs/3.9.x.md
js下载地址
https://cdn.jsdelivr.net/gh/zh-lx/pinyin-pro@latest/dist/pinyin-pro.js
代码示例
<script th:src="@{/js/plugins/pinyin/pinyin-pro.js}"></script>
<!-- <script src="https://cdn.jsdelivr.net/gh/zh-lx/pinyin-pro@latest/dist/pinyin-pro.js"></script>-->
<script type="text/javascript">
console.log("hello ")
var { pinyin } = pinyinPro;
// 'hàn yǔ pīn yīn'
console.log(pinyin('汉语拼音heloo'))
console.log(pinyin('赵钱孙李额', { pattern: 'first', toneType: 'none' }).replace(/\s+/g, ""));
console.log("world ")
</script》
使用示例
获取拼音
import { pinyin } from 'pinyin-pro'; // 获取带音调拼音 pinyin('汉语拼音'); // 'hàn yǔ pīn yīn' // 获取不带声调的拼音 pinyin('汉语拼音', { toneType: 'none' }); // 'han yu pin yin' // 获取声调转换为数字后缀的拼音 pinyin('汉语拼音', { toneType: 'num' }); // 'han4 yu3 pin1 yin1' // 获取数组形式带音调拼音 pinyin('汉语拼音', { type: 'array' }); // ["hàn", "yǔ", "pīn", "yīn"] // 获取数组形式不带声调的拼音 pinyin('汉语拼音', { toneType: 'none', type: 'array' }); // ["han", "yu", "pin", "yin"] // 获取数组形式声调转换为数字后缀的拼音 pinyin('汉语拼音', { toneType: 'num', type: 'array' }); // ["han4", "yu3", "pin1", "yin1"]
获取声母
import { pinyin } from 'pinyin-pro'; // 获取声母 pinyin('汉语拼音', { pattern: 'initial' }); // 'h y p y' // 获取数组形式声母 pinyin('汉语拼音', { pattern: 'initial', type: 'array' }); // ["h", "y", "p", "y"]
获取韵母
import { pinyin } from 'pinyin-pro'; // 获取带音调韵母 pinyin('汉语拼音', { pattern: 'final' }); // 'àn ǔ īn īn' // 获取不带音调韵母 pinyin('汉语拼音', { pattern: 'final', toneType: 'none' }); // 'an u in in' // 获取音调为数字的韵母 pinyin('汉语拼音', { pattern: 'final', toneType: 'num' }); // 'an4 u3 in1 in1' // 获取数组形式带音调韵母 pinyin('汉语拼音', { pattern: 'final', type: 'array' }); // ["àn", "ǔ", "īn", "īn"] // 获取数组形式不带音调韵母 pinyin('汉语拼音', { pattern: 'final', toneType: 'none', type: 'array' }); // ["an", "u", "in", "in"] // 获取数组形式音调为数字的韵母 pinyin('汉语拼音', { pattern: 'final', toneType: 'num', type: 'array' }); // ['an4', 'u3', 'in1', 'in1']
获取音调
import { pinyin } from 'pinyin-pro'; // 获取音调 pinyin('汉语拼音', { pattern: 'num' }); // '4 3 1 1' // 获取数组形式音调 pinyin('汉语拼音', { pattern: 'num', type: 'array' }); // ["4", "3", "1", "1"]
获取拼音首字母
import { pinyin } from 'pinyin-pro'; // 获取拼音首字母 pinyin('赵钱孙李额', { pattern: 'first' }); // 'z q s l é' // 获取不带音调拼音首字母 pinyin('赵钱孙李额', { pattern: 'first', toneType: 'none' }); // 'z q s l e' // 获取数组形式拼音首字母 pinyin('赵钱孙李额', { pattern: 'first', type: 'array' }); // ['z', 'q', 's', 'l', 'é'] // 获取数组形式不带音调拼音首字母 pinyin('赵钱孙李额', { pattern: 'first', toneType: 'none', type: 'array' }); // ['z', 'q', 's', 'l', 'e']
获取单个字的多音
只有单字可以获取到多音模式, 词语、句子无效。同样可以通过配置 options 选项获取数组形式、韵母等格式
import { pinyin } from 'pinyin-pro'; // 获取多音 pinyin('好', { multiple: true }); // 'hǎo hào' // 获取数组形式多音 pinyin('好', { multiple: true, type: 'array' }); // ["hǎo", "hào"]
姓氏模式
通过设置 mode: 'surname'
开启姓氏模式后,匹配到百家姓中的姓氏优先输出姓氏拼音
import { pinyin } from 'pinyin-pro'; // 不开启姓氏模式 pinyin('我叫曾小贤'); // 'wǒ jiào céng xiǎo xián' // 开启姓氏模式 pinyin('我叫曾小贤', { mode: 'surname' }); // 'wǒ jiào zēng xiǎo xián'
过滤非汉字字符
通过设置 removeNonZh: true
,可以过滤输入字符串中的非汉字字符
此参数已不推荐使用,建议使用 nonZh: removed
代替
import { pinyin } from 'pinyin-pro'; // 不开启过滤 pinyin('汉sa语2拼音'); // 'hàn s a yǔ 2 pīn yīn' // 开启过滤 pinyin('汉sa语2拼音', { removeNonZh: true }); // 'hàn yǔ pīn yīn'
定义非汉字字符输出形式
通过设置 nonZh
,可以设置非汉字字符的不同输出形式
import { pinyin } from 'pinyin-pro'; pinyin('我very喜欢你'); // 'wǒ v e r y xǐ huān nǐ' 默认以空格间隔输出 pinyin('我very喜欢你', { nonZh: 'spaced' }); // 'wǒ v e r y xǐ huān nǐ' 以空格间隔输出 pinyin('我very喜欢你', { nonZh: 'consecutive' }); // 'wǒ very xǐ huān nǐ' 紧凑输出 pinyin('我very喜欢你', { nonZh: 'removed' }); // 'wǒ xǐ huān nǐ' 移除非汉字字符
自定义拼音
包内部导出了 customPinyin
方法,支持用户自定义设置词句拼音,当中文中匹配用户自己定义的词句拼音时,优先使用用户自定义的词句拼音
import { pinyin, customPinyin } from 'pinyin-pro'; customPinyin({ 干一行行一行: 'gàn yī háng xíng yī háng', }); pinyin('干一行行一行'); // 'gàn yī háng xíng yī háng'
拼音匹配
包内含 match
方法,可以检测拼音和文本内容是否匹配,拼音支持缩写,且默认开启多音字所有读音匹配模式:
import { match } from 'pinyin-pro'; const matches1 = match('汉语拼音', 'hanyupinyin'); // [0, 1, 2, 3] 拼音和文本匹配,返回匹配上的文本下标 const matches2 = match('汉语拼音', 'hanpin'); // [0, 2] 拼音和文本匹配,返回匹配上的文本下标 const matches3 = match('汉语拼音', 'hyupy'); // [0, 1, 2, 3] 支持各种格式的拼音缩写匹配 const matches4 = match('汉语拼音', 'lsaf'); // null,未匹配成功返回 null const matches5 = match('汉语拼音', 'hanyupinle'); // null,最后的 le 和音不匹配,匹配不成功,返回 null const matches6 = match('会计', 'kuaiji'); // [0, 1],匹配成功,返回匹配上的文本下标 const matches7 = match('会计', 'huiji'); // [0, 1],多音字只要其中一个读音匹配上即算匹配成功
将拼音 ǚ 替换为 v
设置可选配置项 v: true
之后,转换结果中的 ü 将会被替换为 v (带音调的 ü 不会被转换): :
import { pinyin } from 'pinyin-pro'; const result1 = pinyin('吕布', { toneType: 'none' }); // lü bu const result2 = pinyin('吕布', { toneType: 'none', v: true }); // lv bu const result3 = pinyin('吕布', { v: true }); // lǚ bù