使用pinyin-pro这个npm包
github: /zh-lx/pinyin-pro
特色功能
支持汉字、词语、句子多种格式输入获取
获取拼音
获取声母
获取韵母
获取拼音首字母
获取音调
获取多音字的多种拼音
支持字符串和数组两种输出形式
版本更新
当前版本： 3.0.7 -> 3.1.0
增加获取拼音首字母功能
修复 readme 中音调形式参数 toneType 错写成了 tone 的错误
点击查看 版本更新文档
安装
npm 安装
npm install pinyin-pro
yarn 安装
yarn add pinyin-pro
引入
ES6 引入：
import {pinyin } from 'pinyin-pro';
commonjs 引入：
const {pinyin } = require('pinyin-pro');
参数
pinyin(word, options) 接收两个参数
word：必填。String 类型，需要转化为拼音的中文
options：可选。Object 类型，用于配置各种输出形式，options 的键值配置如下：
参数 说明 类型 可选值 默认值
pattern 输出的结果的信息（拼音 / 声母 / 韵母 / 音调 / 首字母） string pinyin / initial / final / num / first pinyin
toneType 音调输出形式(拼音符号 / 数字 / 不加音调) string symbol / num / none symbol
type 输出结果类型（字符串/数组） string string / array string
multiple 输出多音字全部拼音（仅在 word 为长度为 1 的汉字字符串时生效） boolean true / false false
使用示例
获取拼音
// 获取带音调拼音
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”]
// 获取带音调拼音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: '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: '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: '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’]
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 选项获取数组形式、韵母等格式
// 获取多音
pinyin(‘好’, { multiple: true }); // ‘hǎo hào’
// 获取数组形式多音
pinyin(‘好’, { multiple: true, type: ‘array’ }); // [“hǎo”, “hào”]
// 获取多音pinyin('好', {multiple: true }); // 'hǎo hào'// 获取数组形式多音pinyin('好', {multiple: true, type: 'array' }); // ["hǎo", "hào"]
