pinyin-pro實現javascript獲取漢字拼音

特色功能

• 支持漢字、詞語、句子多種格式輸入獲取
• 獲取拼音
• 獲取聲母
• 獲取韻母
• 獲取拼音首字母
• 獲取音調
• 獲取多音字的多種拼音
• 支持字符串和數組兩種輸出形式

版本更新

當前版本： 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"]

獲取聲母

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 選項獲取數組形式、韻母等格式

// 獲取多音 pinyin('好', { multiple: true }); // 'hǎo hào' // 獲取數組形式多音 pinyin('好', { multiple: true, type: 'array' }); // ["hǎo", "hào"]

貢獻與反饋

使用遇到問題或者需要功能支持歡迎提 issue。

交流及參與貢獻歡迎加微信：

總結

以上是生活随笔為你收集整理的js获取汉字拼音的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。