Skip to content

汉字转拼音模块,可以用于各类需要进行拼音搜索,或者拼音注音的地方。

License

Notifications You must be signed in to change notification settings

theshiau/simple-pinyin

 
 

Repository files navigation

simple-pinyin

npm version Bower version Build Status codecov devDependency Status

一个简单的汉字转换到拼音模块,目前覆盖了 401 个常用音和和 6765 个常用汉字,可以同时应用于 NodeJS 和浏览器环境。

可以很方便地应用于需要对汉字数据进行转换、或者过滤的各类场合。

安装方法

npm install simple-pinyin

或者

bower install simple-pinyin

使用方法

直接引用

<script src="simple-pinyin/dist/index.min.js"></script>
<script>
    simplePinyin.default('你好 simplePinyin');
</script>

模块加载器

CMD

const simplePinyin = require('simple-pinyin').default;

ES6 Module

import simplePinyin from 'simple-pinyin';

然后就可以直接输入中文,输出拼音了。

simplePinyin('你好 simplePinyin!', { pinyinOnly: false });
>> ["ni", "hao", "simplePinyin", "!"]

可以参考范例

Select2 的过滤可以使用 matcher 参数, CollectionView for ChaplinJS 可以使用 filterer 参数, 更多框架还请参考各自文档。

参数

参数名称 类型 解释 默认值
pinyinOnly boolean 是否只输出拼音,true 为是,false 时将连带英文字符和特殊符号都一起输出 true

更新历史

  • 3.0 - 2016年11月20日
    • 进一步调整输出,取消 short 的拼音首字母输出,如果需要可以直接使用 pinyin.map(p => p[0]).join('') 便能恢复到和 1.0 时相同的首字母拼音输出。
    • 增加 pinyinOnly 参数,默认开启,直接 join 配合上一条可以做到和 1.0 时 full 输出一样的结果。
    • 取消完全没必要的拼音首字母大写。
    • 进一步优化代码,依然是“妈妈跟我说再也不用担心我的 Chinese 不知道怎么念了。”,性能由 2.0 的 3 毫米,缩减到 1-2 毫秒 之间。
  • 2.0 - 2016年11月18日
    • 对逻辑进行了调整,输出由字符串改成了数组,包含英文和特殊符号,这样方便上层应用处理。
    • 使用 TypeScript 重写,变成了 ES6 的模块,通过 webpack 编译。
    • 增加了单元测试。
    • 重构了字典结构,使用原生的 find、fiter 方法进行过滤,性能提升5倍,参考文本“妈妈跟我说再也不用担心我的 Chinese 不知道怎么念了。”,1.0 需要 16 毫秒,2.0 只需要 3 毫秒。
  • 1.1 - 2015年2月27日
    • 主要增加了 AMD 支持。
  • 1.0 - 2014年11月3日
    • 第一个版本发布。

About

汉字转拼音模块,可以用于各类需要进行拼音搜索,或者拼音注音的地方。

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 90.2%
  • HTML 7.7%
  • JavaScript 2.1%