Security News
RubyGems.org Adds New Maintainer Role
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
cnchar-trad
Advanced tools
在线试用 | 更新日志 | 应用:打字游戏 | 我要反馈错误/缺漏 | Easy-ICON
[TOC]
感谢同学们对于cnchar的支持,由于cnchar词库来源于网络,虽然经过了本人的修改的扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 反馈 给我(或自行修改提交,经过审查无误过后会合到cnchar中)
使用 npm 安装:
npm i cnchar
import cnchar from 'cnchar';
'汉字'.spell();
'汉字'.stroke();
使用 script 标签使用:
<script src="https://www.theajack.com/cnchar/dist/cnchar.2.0.4.min.js"></script>
<script>
'汉字'.spell();
'汉字'.stroke();
</script>
考虑到不同的需求,cnchar的功能被拆分到以下四个库中:
名称 | 描述 | 功能 |
---|---|---|
cnchar | 主js库,其他三个库依赖于这个库 | 含有简体字拼音、多音字、音调、笔画数等功能 |
cnchar-poly | 多音词库 | 含有识别多音词功能 |
cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
安装基础库:
npm i cnchar
安装附加功能库:
npm i cnchar-poly cnchar-order cnchar-trad
当然您也可以按需安装其中的几个,但是 cnchar
这个基础库是必须安装的
或者您可以通过安装cnchar-all
来使用完整功能,这个库引用了上面的四个库
npm i cnchar-all
<script src="https://www.theajack.com/cnchar/dist/cnchar.2.0.4.min.js"></script>
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.2.0.4.min.js"></script>
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.2.0.4.min.js"></script>
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.2.0.4.min.js"></script>
npm 安装好几个库之后:
// 请保证最先引入 cnchar 基础库,其他几个库顺序无所谓
import cnchar from 'cnchar';
import 'cnchar-poly';
import 'cnchar-order';
import 'cnchar-trad';
console.log('汉字'.spell());// prototype 方式调用
console.log(cnchar.spell('汉字'));// cnchar api 调用
浏览器环境下会在 window
对象上定义 cnchar
对象
非浏览器环境下需要使用 cnchar.use()
方法加载功能库:
// 请保证最先引入 cnchar 基础库,其他几个库顺序无所谓
var cnchar = require('cnchar');
var poly = require('cnchar-poly');
var order = require('cnchar-order');
var trad = require('cnchar-trad');
cnchar.use(poly, order, trad);
console.log('汉字'.spell());// prototype 方式调用
console.log(cnchar.spell('汉字'));// cnchar api 调用
其他使用方式与浏览器环境一致
原生浏览器环境就需要使用 script 标签引入js文件:
<script src="https://www.theajack.com/cnchar/dist/cnchar.2.0.4.min.js"></script>
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.2.0.4.min.js"></script>
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.2.0.4.min.js"></script>
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.2.0.4.min.js"></script>
<script>
console.log('汉字'.spell());// prototype 方式调用
console.log(cnchar.spell('汉字'));// cnchar api 调用
</script>
为了尽可能使api使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
// 获取汉字的拼音、多音词、音调等都集成在以下方法上
cnchar.spell(string[,...args]);
// 或
string.spell([...args])
// 获取汉字的笔画、笔画顺序等都集成在以下方法上
cnchar.stroke(string[,...args]);
// 或
string.stroke([...args])
该 api 设计一致,string
表示要处理的汉字字符串
关键在于可选参数的配置,参数配置将在第六章单独介绍
当引入 cnchar-trad
之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 cnchar.convert
对象上的方法,你就可以使用这个功能
自从v2.0.4以后,cnchar保留以下方法可供使用:
cnchar.convert.simpleToTrad(string); // 简体 => 繁体
cnchar.convert.simpleToSpark(string); // 简体 => 火星文
cnchar.convert.tradToSimple(string); // 繁体 => 简体
cnchar.convert.tradToSpark(string); // 繁体 => 火星文
cnchar.convert.sparkToSimple(string); // 火星文 => 简体
cnchar.convert.sparkToTrad(string); // 火星文 => 繁体
string.convertSimpleToTrad();
string.convertSimpleToSpark();
string.convertTradToSimple();
string.convertTradToSpark();
string.convertSparkToSimple();
string.convertSparkToTrad();
当引入 cnchar-order
功能库(版本2.0.2及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
cnchar.orderToWord(orderNameArray[,...args]);
orderNameArray
是笔画名称序列,是一个数组,可用的笔画名称可以通过以下api查看
var dict = cnchar.orderToWord.orders;
args
是参数列表,可选值有 ['all','simple']
, 使用 cnchar.type.orderToWord
可以查看可选值
'all'
表示匹配所有以该笔序开头的汉字
'simple'
表示禁用繁体字,该参数仅在引入了 cnchar-trad
后有效
以下是一个例子:
cnchar.orderToWord(['横','撇','捺']);
// 返回 ["丈", "大"]
cnchar.orderToWord(['横','撇','捺'],'all');
// 返回 ["丈", "大", "太", "犬", "夯", "夸", "夺", "夼", "奁", "奄", "奈", "奋", "奔", "态", "奎", "耷", "套", "奢", "瓠", "鹩", "奪", "奮", "遼"]
cnchar.orderToWord(['横','撇','捺'],'all','simple');
// 返回 ["丈", "大", "太", "犬", "夯", "夸", "夺", "夼", "奁", "奄", "奈", "奋", "奔", "态", "奎", "耷", "套", "奢", "瓠", "鹩"]
如果输入的笔画不在 cnchar.orderToWord.orders
内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
这个api的功能是显式启用 poly
、order
、trad
三个功能库
cnchar.use(...libs);
这个启用在非浏览器环境(比如nodejs等)中是必须的,使用如下:
// 请保证最先引入 cnchar 基础库,其他几个库顺序无所谓
var cnchar = require('cnchar');
var poly = require('cnchar-poly');
var order = require('cnchar-order');
var trad = require('cnchar-trad');
cnchar.use(poly, order, trad); // 参数顺序无关,三个参数可以任意选择
在浏览器环境中则无需调用:
// 请保证最先引入 cnchar 基础库,其他几个库顺序无所谓
import cnchar from 'cnchar';
import 'cnchar-poly';
import 'cnchar-order';
import 'cnchar-trad';
type对象用户获取当前可用的 spell
、 stroke
和 orderToWord
参数类型:
var spellArg = cnchar.type.spell;
var strokeArg = cnchar.type.stroke;
var orderToWordArg = cnchar.type.orderToWord;
spellArg 最多可用值: ["array", "low", "up", "first", "poly", "tone", "simple"]
strokeArg 最多可用值:["letter", "shape", "count", "name", "detail", "array", "order", "simple"]
orderToWordArg 最多可用值:["all", "simple"]
具体用法第六章讲到
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为true
参数校验能够对 spell
和 stroke
传入的参数进行检查,在控制台显示 无效·
,忽略
和冗余
的参数
cnchar.check = false; // 关闭参数校验
获取当前版本:
var version = cnchar.version; // string 类型
当前使用的功能库列表,最多的情况为 ["order", "trad", "poly"]
var plugins = cnchar.plugins; // array 类型
参数调用如下,所有arg参数都是可选的
cnchar.spell(string,arg1,arg2,...);
string.spell(arg1,arg2,...)
arg 参数信息如下:
参数 | 作用 | 是否默认 | 依赖库 | 备注 |
---|---|---|---|---|
array | 返回数组 | 否 | -- | -- |
first | 返回拼音首字母 | 否 | -- | -- |
up | 将结果全部大写 | 否 | -- | -- |
low | 将结果全部小写 | 否 | -- | 会被up参数覆盖 |
poly | 使用候选多音字 | 否 | -- | -- |
tone | 启用音调 | 否 | -- | -- |
simple | 是否繁体字的拼音功能 | 否 | cnchar-trad | 使用cnchar-trad之后,默认对繁体字拼音进行转换,该参数用于禁用繁体字拼音 |
参数调用如下,所有arg参数都是可选的
cnchar.stroke(string,arg1,arg2,...);
string.stroke(arg1,arg2,...)
arg 参数信息如下:
参数 | 作用 | 是否默认 | 依赖库 | 备注 |
---|---|---|---|---|
array | 返回数组 | 否 | -- | 使用cnchar-order 且启用 order参数后该参数被忽略 |
order | 启用笔画顺序 | 否 | cnchar-order | -- |
letter | 使用笔画顺序字母序列 | 是 | cnchar-order | 当启用order后,该值是默认值 |
detail | 使用笔画顺序详情作为返回值,每个汉字对应一个json | 否 | cnchar-order | 优先级小于letter |
shape | 使用笔画形状作为返回值 | 否 | cnchar-order | 优先级小于detail |
name | 使用笔画名称作为返回值 | 否 | cnchar-order | 优先级小于shape |
count | 使用笔画数作为返回值 | 否 | cnchar-poly | 优先级小于name |
simple | 是否繁体字的笔画功能 | 否 | cnchar-trad | 使用cnchar-trad之后,默认对繁体字启用笔画功能,该参数用于禁用繁体字笔画功能 |
参数调用如下,所有arg参数都是可选的
cnchar.orderToWord(orderArray,arg1,arg2);
arg 参数信息如下:
参数 | 作用 | 是否默认 | 依赖库 | 备注 |
---|---|---|---|---|
all | 匹配所有以该笔序开头的汉字 | 否 | -- | -- |
simple | 禁用繁体字 | 否 | cnchar-trad | 该参数仅在引入了 cnchar-trad 后有效 |
//spell 功能
"测试".spell() // 返回 'CeShi'
"测试".spell("up") // 返回 'CESHI'
"测试".spell("low") // 返回 'ceshi'
"测试".spell("first") // 返回 'CS'
"测试".spell("first","low") // 返回 'cs'
"测试".spell("array") // 返回 ['Ce','Shi']
"测试".spell("array","first","low") // 返回 ['c','s']
"测试".spell('tone') // 返回 'CèShì'
"长大了".spell('poly') // 返回 '(Zhang|Chang)(Da|Dai)(Le|Liao)'
//stroke 功能
"测".stroke() // 返回 9
"测试".stroke() // 返回 17
"测试".stroke('array') // 返回 [9,8]
备注:
cnchar.spell(string,...args)
cnchar.stroke(string,...args)
该库用于准确识别多音词,同样支持 6.3.1中的其他参数功能
"长大了".spell() // 返回 'ZhangDaLe'
"长大了".spell('array') // 返回 ["Zhang", "Da", "Le"]
"长大了".spell('poly') // 返回 '(Zhang|Chang)(Da|Dai)(Le|Liao)'
该库用于查询汉字笔画顺序、笔画名称等,返回值为 数组
"一个".stroke('order') // 返回 ["j","slf"] 需要显式使用 order 参数 默认返回笔画数字母序列
"一个".stroke('order','detail') //
/* 返回详细笔画信息:
[
[{
"shape": "㇐",
"type": "平笔",
"foldCount": "0",
"name": "横"
}],[{
"shape": "㇓",
"type": "平笔",
"foldCount": "0",
"name": "撇"
},{
"shape": "㇏",
"type": "平笔",
"foldCount": "0",
"name": "捺"
},{
"shape": "㇑",
"type": "平笔",
"foldCount": "0",
"name": "竖"
}]
]*/
"一个".stroke('order','shape') // 返回 [["横"],["撇", "捺", "竖"]]
"一个".stroke('order','name') // 返回 [["㇐"],["㇓","㇏","㇑"]]
"一个".stroke('order','count') // 返回 [1, 3]
根据笔画名称序列推出原汉字
var orders = cnchar.orderToWord.orders; //查看支持的笔画名称
cnchar.orderToWord(['横','撇','捺']);
// 返回 ["丈", "大"]
cnchar.orderToWord(['横','撇','捺'],'all');
// 返回 ["丈", "大", "太", "犬", "夯", "夸", "夺", "夼", "奁", "奄", "奈", "奋", "奔", "态", "奎", "耷", "套", "奢", "瓠", "鹩", "奪", "奮", "遼"]
cnchar.orderToWord(['横','撇','捺'],'all','simple');
// 返回 ["丈", "大", "太", "犬", "夯", "夸", "夺", "夼", "奁", "奄", "奈", "奋", "奔", "态", "奎", "耷", "套", "奢", "瓠", "鹩"]
该库用于支持繁体字火星文转换及其拼音笔画数功能
"一个人".convertSimpleToTrad(); // 返回 "壹個人" 等价于 cnchar.convert.simpleToTrad
cnchar.convert.simpleToTrad("一个人");
"一个人".convertSimpleToSpark(); // 返回 "①個亾" 等价于 cnchar.convert.simpleToSpark
cnchar.convert.simpleToSpark("一个人");
"壹個人".convertTradToSimple(); // 返回 "一个人" 等价于 cnchar.convert.tradToSimple
cnchar.convert.tradToSimple("壹個人");
"壹個人".convertTradToSpark(); // 返回 "①個亾" 等价于 cnchar.convert.tradToSpark
cnchar.convert.tradToSpark("壹個人");
"①個亾".convertSparkToSimple(); // 返回 "一个人" 等价于 cnchar.convert.sparkToSimple
cnchar.convert.sparkToSimple("①個亾");
"①個亾".convertSparkToTrad(); // 返回 "壹個人" 等价于 cnchar.convert.sparkToTrad
cnchar.convert.sparkToTrad("①個亾");
该库增加了对于繁体字的拼音笔画功能扩展,其他基础用法与 基础库一致:
//spell 功能
"長大".spell() // 返回 'ZhangDa'
"長大".spell('simple') // 返回 '長Da' // 禁用繁体字拼音功能
//stroke 功能
"長大".stroke('array') // 返回 [8, 3]
"長大".stroke('array','simple') // 返回 [0, 3] // 禁用繁体字笔画功能
"長大".stroke('order','shape') // 返回 [["㇐","㇑","㇐","㇐","㇐","㇙","㇓","㇏"],["㇐","㇓","㇏"]]
"長大".stroke('order','shape','simple') // 返回 [undefined, ["㇐","㇓","㇏"]]
FAQs
功能全面、多端支持的汉字拼音笔画 js 库
The npm package cnchar-trad receives a total of 48 weekly downloads. As such, cnchar-trad popularity was classified as not popular.
We found that cnchar-trad demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
Security News
Node.js will be enforcing stricter semver-major PR policies a month before major releases to enhance stability and ensure reliable release candidates.
Security News
Research
Socket's threat research team has detected five malicious npm packages targeting Roblox developers, deploying malware to steal credentials and personal data.