javascript 纯前端实现汉字转拼音

您所在的位置：网站首页 › 拼音自动生成 › javascript 纯前端实现汉字转拼音

javascript 纯前端实现汉字转拼音

2024-06-06 16:12| 来源: 网络整理| 查看: 265

一般实现汉字转拼音的功能都是请求服务端 api 实现，而对于一些比较简单的需求，我们可以通过一个 npm 工具包 —— pinyin-pro ，纯前端实现中文汉字转拼音的功能。

特色功能支持汉字、词语、句子多种格式输入获取获取拼音获取声母获取韵母获取拼音首字母获取音调获取多音字的多种拼音支持人名姓氏模式支持自定义拼音支持字符串和数组两种输出形式版本更新

当前版本： 3.3.1 -> 3.4.0

新增功能支持姓氏模式拼音识别，具体用法见姓氏模式支持自定义拼音功能，具体用法见自定义拼音问题修复修复文本过长时堆栈溢出问题字音校准褚: ‘zhǔ’ -> ‘chǔ zhǔ’俞: ‘yù’ -> ‘yú yù’臧: ‘zàng’ -> ‘zāng’贲: ‘bì’ -> ‘bēn bì’莘: ‘xīn’ -> ‘shēn xīn’郦: ‘zhí’ -> ‘lì zhí’

点击查看版本更新文档

安装

npm 安装

npm install pinyin-pro

yarn 安装

yarn add pinyin-pro 引入

浏览器 script 引入:

var { pinyin } = pinyinPro; pinyin('汉语拼音'); // 'hàn yǔ pīn yīn'

ESModule 引入：

import { pinyin } from 'pinyin-pro'; pinyin('汉语拼音'); // 'hàn yǔ pīn yīn'

commonjs 引入：

const { pinyin } = require('pinyin-pro'); pinyin('汉语拼音'); // 'hàn yǔ pīn yīn' 参数

pinyin(word, options) 接收两个参数

word：必填。String 类型，需要转化为拼音的中文options：可选。Object 类型，用于配置各种输出形式，options 的键值配置如下：参数说明类型可选值默认值pattern输出的结果的信息（拼音 / 声母 / 韵母 / 音调 / 首字母）stringpinyin / initial / final / num / firstpinyintoneType音调输出形式(拼音符号 / 数字 / 不加音调)stringsymbol / num / nonesymboltype输出结果类型（字符串/数组）stringstring / arraystringmultiple输出多音字全部拼音（仅在 word 为长度为 1 的汉字字符串时生效）booleantrue / falsefalsemode拼音查找的模式（常规模式 / 姓氏模式）stringnormal / surnamenormal 使用示例获取拼音 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' 自定义拼音

包内部导出了 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'

【本文地址】

javascript 纯前端实现汉字转拼音

javascript 纯前端实现汉字转拼音

今日新闻

推荐新闻