feat: 2.1.0 正式上线,支持可视化绘制汉字
This commit is contained in:
parent
6d7c6a7285
commit
9b98c5855f
229
README.md
229
README.md
|
@ -13,11 +13,56 @@
|
||||||
|
|
||||||
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
||||||
|
|
||||||
**<a href="#64-使用实例大全">快速上手</a> | [在线试用](https://theajack.gitee.io/cnchar) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://theajack.gitee.io/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/new)**
|
**<a href="#66-使用实例大全">快速上手</a> | [在线试用/文档](https://theajack.gitee.io/cnchar) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://theajack.gitee.io/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/new)**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
[TOC]
|
<!-- toc -->
|
||||||
|
|
||||||
|
- [前言](#%E5%89%8D%E8%A8%80)
|
||||||
|
- [0.快速使用](#0%E5%BF%AB%E9%80%9F%E4%BD%BF%E7%94%A8)
|
||||||
|
- [1.功能](#1%E5%8A%9F%E8%83%BD)
|
||||||
|
- [2.概览](#2%E6%A6%82%E8%A7%88)
|
||||||
|
- [3 安装](#3-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.1 使用 npm 安装](#31-%E4%BD%BF%E7%94%A8-npm-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.2 使用 script 引入](#32-%E4%BD%BF%E7%94%A8-script-%E5%BC%95%E5%85%A5)
|
||||||
|
- [4 使用](#4-%E4%BD%BF%E7%94%A8)
|
||||||
|
* [4.1 webpack浏览器环境(有window对象)](#41-webpack%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83%E6%9C%89window%E5%AF%B9%E8%B1%A1)
|
||||||
|
* [4.2 nodejs 等非浏览器环境](#42-nodejs-%E7%AD%89%E9%9D%9E%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
* [4.3 原生浏览器环境](#43-%E5%8E%9F%E7%94%9F%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
- [5 API](#5-api)
|
||||||
|
* [5.1 拼音笔画基础 API: spell & stroke](#51-%E6%8B%BC%E9%9F%B3%E7%AC%94%E7%94%BB%E5%9F%BA%E7%A1%80-api-spell--stroke)
|
||||||
|
* [5.2 可视化绘制汉字: draw](#52-%E5%8F%AF%E8%A7%86%E5%8C%96%E7%BB%98%E5%88%B6%E6%B1%89%E5%AD%97-draw)
|
||||||
|
+ [5.2.1 使用](#521-%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [5.2.2 参数](#522-%E5%8F%82%E6%95%B0)
|
||||||
|
* [5.3 繁体、简体、火星文互转: convert](#53-%E7%B9%81%E4%BD%93%E7%AE%80%E4%BD%93%E7%81%AB%E6%98%9F%E6%96%87%E4%BA%92%E8%BD%AC-convert)
|
||||||
|
* [5.4 笔画序列推出原汉字: orderToWord](#54-%E7%AC%94%E7%94%BB%E5%BA%8F%E5%88%97%E6%8E%A8%E5%87%BA%E5%8E%9F%E6%B1%89%E5%AD%97-ordertoword)
|
||||||
|
* [5.5 通过拼音查询原汉字: spellToWord](#55-%E9%80%9A%E8%BF%87%E6%8B%BC%E9%9F%B3%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-spelltoword)
|
||||||
|
* [5.6 通过笔画数查询原汉字: strokeToWord](#56-%E9%80%9A%E8%BF%87%E7%AC%94%E7%94%BB%E6%95%B0%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-stroketoword)
|
||||||
|
* [5.7 查询拼音详细信息: spellInfo](#57-%E6%9F%A5%E8%AF%A2%E6%8B%BC%E9%9F%B3%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF-spellinfo)
|
||||||
|
* [5.8 其他 api](#58-%E5%85%B6%E4%BB%96-api)
|
||||||
|
+ [5.8.1 .use()](#581-use)
|
||||||
|
+ [5.8.2 .type](#582-type)
|
||||||
|
+ [5.8.3 .check](#583-check)
|
||||||
|
+ [5.8.4 .version](#584-version)
|
||||||
|
+ [5.8.5 .plugins](#585-plugins)
|
||||||
|
- [6 spell stroke 参数](#6-spell-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.1 spell 参数](#61-spell-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.2 stroke 参数](#62-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.3 orderToWord 参数](#63-ordertoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.4 spellToWord 参数](#64-spelltoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.5 strokeToWord 参数](#65-stroketoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.6 使用实例大全:](#66-%E4%BD%BF%E7%94%A8%E5%AE%9E%E4%BE%8B%E5%A4%A7%E5%85%A8)
|
||||||
|
+ [6.6.0 安装使用](#660-%E5%AE%89%E8%A3%85%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [6.6.1 cnchar 基础库功能](#661-cnchar-%E5%9F%BA%E7%A1%80%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.2 cnchar-poly 库功能](#662-cnchar-poly-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.3 cnchar-order 库功能](#663-cnchar-order-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.4 cnchar-trad 库功能](#664-cnchar-trad-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
- [6.6.4.1 convert 字体转换](#6641-convert-%E5%AD%97%E4%BD%93%E8%BD%AC%E6%8D%A2)
|
||||||
|
- [6.6.4.2 spell 和 stroke 方法](#6642-spell-%E5%92%8C-stroke-%E6%96%B9%E6%B3%95)
|
||||||
|
- [7 应用例子](#7-%E5%BA%94%E7%94%A8%E4%BE%8B%E5%AD%90)
|
||||||
|
|
||||||
|
<!-- tocstop -->
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
@ -44,18 +89,14 @@ import cnchar from 'cnchar';
|
||||||
使用 script 标签使用:
|
使用 script 标签使用:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<!--
|
|
||||||
或通过版本号引用
|
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
-->
|
|
||||||
<script>
|
<script>
|
||||||
'汉字'.spell();
|
'汉字'.spell();
|
||||||
'汉字'.stroke();
|
'汉字'.stroke();
|
||||||
</script>
|
</script>
|
||||||
```
|
```
|
||||||
|
|
||||||
<a href="#64-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
<a href="#66-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
||||||
|
|
||||||
### 1.功能
|
### 1.功能
|
||||||
|
|
||||||
|
@ -64,16 +105,17 @@ import cnchar from 'cnchar';
|
||||||
3. 支持 **拼音音调**
|
3. 支持 **拼音音调**
|
||||||
4. 获取汉字 **笔画数** 、支持数组分割
|
4. 获取汉字 **笔画数** 、支持数组分割
|
||||||
5. 获取汉字 **笔画顺序** 、笔画详细名称
|
5. 获取汉字 **笔画顺序** 、笔画详细名称
|
||||||
6. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
6. 支持可视化 **绘制汉字笔画** 、多种绘制模式可选
|
||||||
7. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
7. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
||||||
8. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
8. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
||||||
9. 支持 **根据笔画顺序查询** 汉字
|
9. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
||||||
10. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
10. 支持 **根据笔画顺序查询** 汉字
|
||||||
11. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
11. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
||||||
12. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
12. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
||||||
13. **多端可用**,可用于 **浏览器、nodejs、小程序/小游戏、ReactNative/Weex/Uniapp/Electron、webpack**...,支持所有 js 能运行的环境
|
13. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
||||||
14. **typescript支持**,支持在typescript中调用
|
14. **多端可用**,可用于 **浏览器、nodejs、小程序/小游戏、ReactNative/Weex/Uniapp/Electron、webpack**...,支持所有 js 能运行的环境
|
||||||
15. 丰富的配置,按需取用
|
15. **typescript支持**,支持在typescript中调用
|
||||||
|
16. 丰富的配置,按需取用
|
||||||
|
|
||||||
### 2.概览
|
### 2.概览
|
||||||
|
|
||||||
|
@ -85,6 +127,7 @@ import cnchar from 'cnchar';
|
||||||
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
||||||
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
||||||
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
||||||
|
| cnchar-draw | 绘制笔画库 | 指出可视化绘制汉字,有 normal,animation,stroke,test 四种模式可选,该库仅在浏览器环境下可用 |
|
||||||
|
|
||||||
### 3 安装
|
### 3 安装
|
||||||
|
|
||||||
|
@ -99,7 +142,7 @@ npm i cnchar
|
||||||
安装附加功能库:
|
安装附加功能库:
|
||||||
|
|
||||||
```
|
```
|
||||||
npm i cnchar-poly cnchar-order cnchar-trad
|
npm i cnchar-poly cnchar-order cnchar-trad cnchar-draw
|
||||||
```
|
```
|
||||||
|
|
||||||
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
||||||
|
@ -113,17 +156,20 @@ npm i cnchar-all
|
||||||
#### 3.2 使用 script 引入
|
#### 3.2 使用 script 引入
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
<!-- 或使用版本号引用 -->
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.poly.{version}.min.js"></script>
|
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.order.{version}.min.js"></script>
|
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.trad.{version}.min.js"></script>
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
或使用以下cdn,包含了以上五个库
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-all/cnchar.all.min.js"></script>
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
### 4 使用
|
### 4 使用
|
||||||
|
|
||||||
#### 4.1 webpack浏览器环境(有window对象)
|
#### 4.1 webpack浏览器环境(有window对象)
|
||||||
|
@ -136,6 +182,8 @@ import cnchar from 'cnchar';
|
||||||
import 'cnchar-poly';
|
import 'cnchar-poly';
|
||||||
import 'cnchar-order';
|
import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
|
import 'cnchar-draw';
|
||||||
|
// 插件请按需取用
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -153,6 +201,8 @@ var cnchar = require('cnchar');
|
||||||
var poly = require('cnchar-poly');
|
var poly = require('cnchar-poly');
|
||||||
var order = require('cnchar-order');
|
var order = require('cnchar-order');
|
||||||
var trad = require('cnchar-trad');
|
var trad = require('cnchar-trad');
|
||||||
|
// 插件请按需取用
|
||||||
|
// cnchar-draw 在非浏览器环境下不可使用
|
||||||
cnchar.use(poly, order, trad);
|
cnchar.use(poly, order, trad);
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
|
@ -166,10 +216,11 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script>
|
<script>
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -178,6 +229,8 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
|
||||||
### 5 API
|
### 5 API
|
||||||
|
|
||||||
|
类型声明:[cnchar.d.ts](https://github.com/theajack/cnchar/blob/master/src/main/index.d.ts)
|
||||||
|
|
||||||
#### 5.1 拼音笔画基础 API: spell & stroke
|
#### 5.1 拼音笔画基础 API: spell & stroke
|
||||||
|
|
||||||
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
||||||
|
@ -198,7 +251,93 @@ string.stroke([...args])
|
||||||
|
|
||||||
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
||||||
|
|
||||||
#### 5.2 繁体、简体、火星文互转: convert
|
#### 5.2 可视化绘制汉字: draw
|
||||||
|
|
||||||
|
类型声明:[cnchar.draw.d.ts](https://github.com/theajack/cnchar/blob/master/src/plugin/draw/index.d.ts)
|
||||||
|
|
||||||
|
`cnchar-draw` 库用于支持在浏览器环境下可视化绘制汉字,所以该库仅在浏览器环境下可用。
|
||||||
|
|
||||||
|
##### 5.2.1 使用
|
||||||
|
|
||||||
|
使用方式如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.draw('你好', options); // options 为可选参数, 在5.2.2 种会详细介绍
|
||||||
|
```
|
||||||
|
|
||||||
|
运行结果如下:
|
||||||
|
|
||||||
|
![draw.jpg](https://cdn.jsdelivr.net/gh/theajack/cnchar/assets/readme/draw.jpg)
|
||||||
|
|
||||||
|
该库支持脱离cnchar 独立使用
|
||||||
|
|
||||||
|
```js
|
||||||
|
import draw from 'cnchar-draw';
|
||||||
|
draw('你好')
|
||||||
|
```
|
||||||
|
|
||||||
|
使用cdn引用时,会在window对向上暴露 `CncharDraw` 对象
|
||||||
|
|
||||||
|
##### 5.2.2 参数
|
||||||
|
|
||||||
|
draw 的参数比较繁多,首先需要理解的是,draw 分为四种绘制模式:
|
||||||
|
|
||||||
|
1. normal: 常规绘制
|
||||||
|
2. animation: 带有绘制动画,支持连续绘制、同时绘制、循环绘制
|
||||||
|
3. stroke: 按汉字笔顺单步绘制
|
||||||
|
4. test: 测试模式,用户可以在容器内绘制汉字,cnchar-draw会检测是否绘制正确
|
||||||
|
|
||||||
|
以下是 options 的所有可选参数及描述,使用详情请参考[在线文档](https://theajack.gitee.io/cnchar):
|
||||||
|
|
||||||
|
```ts
|
||||||
|
declare interface DrawOption {
|
||||||
|
el?: string | HTMLElement; // 绘制的容器,支持id和dom,若是不填,会在body后append一个dom作为容器
|
||||||
|
type?: DrawType; // 绘制模式,默认为normal
|
||||||
|
style?: { // 样式类
|
||||||
|
showOutline?: boolean;//: true,
|
||||||
|
showCharacter?: boolean;//: true,
|
||||||
|
currentColor?: string;//: '#b44', // 仅在stroke模式下有效
|
||||||
|
length?: number;//: 60,
|
||||||
|
padding?: number;//: 5, // 数值, 默认 20。 画布的汉字和边缘之间的填充
|
||||||
|
outlineColor?: string;//: '#ddd', // 十六进制字符, 默认 '#DDD'。
|
||||||
|
strokeColor?: string;//: '#555', // 十六进制字符, 默认 '#555'。绘制每个笔划的颜色。
|
||||||
|
radicalColor?: string;//: null, // 十六进制字符, 默认 null。 如果存在偏旁部首数据,则在笔划中绘制偏旁部首的颜色。 如果没有设置,激光将绘制与其他笔划相同的颜色。
|
||||||
|
strokeFadeDuration?: number; //400
|
||||||
|
},
|
||||||
|
line?: { // 背景线条类
|
||||||
|
lineStraight?: boolean;// : true,
|
||||||
|
lineCross?: boolean;// : true,
|
||||||
|
lineWidth?: number;// : 1,
|
||||||
|
lineColor?: string;// : '#ddd',
|
||||||
|
lineDash?: boolean;// : true,
|
||||||
|
border?: boolean;// : true,
|
||||||
|
borderWidth?: number;// : 1,
|
||||||
|
borderColor?: string;// : '#ccc',
|
||||||
|
borderDash?: boolean;// : false,
|
||||||
|
},
|
||||||
|
animation?: {
|
||||||
|
strokeAnimationSpeed?: number;// : 1, // 数值, 默认 1。 绘制每个笔划的速度必须大于0。增加此数字可以更快地绘制笔划,减少绘制笔划的速度更慢。
|
||||||
|
delayBetweenStrokes?: number;// : 1000, // 数值, 默认 1000。 动画进行中每个笔画之间的间隔时间(以毫秒为单位)。
|
||||||
|
delayBetweenLoops?: number;// : 200, // 数值, 默认 2000。 循环动画时每个动画循环之间的时间(以毫秒为单位)。
|
||||||
|
autoAnimate?: boolean;// : true,
|
||||||
|
animateComplete?: Function;// : () => {},
|
||||||
|
stepByStep?: boolean;// : true,
|
||||||
|
loopAnimate?: boolean;// : false,
|
||||||
|
},
|
||||||
|
test?: {
|
||||||
|
strokeHighlightSpeed?: number;// : 20, // 数值, 默认 20。 在测验中给出提示时突出显示每个笔划的速度必须大于0。增加此数字以突出显示更快,减少以突出显示更慢。
|
||||||
|
highlightColor?: number;// : '#aaf', // 十六进制字符, 默认 '#AAF'。 用于在测验中突出显示的颜色。
|
||||||
|
drawingColor?: number;// : '#333', // 十六进制字符, 默认 '#333'。 测验期间绘制的线条颜色。
|
||||||
|
drawingWidth?: number;// : 4, // 数值, 默认 4。 进行测验时绘制的线条宽度。
|
||||||
|
showHintAfterMisses?: number;// : 3, // 整数, 默认 3 中风高亮提示之前的未命中数被给予用户。 设置为 false 以禁用。 创建测验时也可以设置此项。
|
||||||
|
highlightOnComplete?: number;// : true, // 布尔值, 默认 true。 控制当用户完成绘制整个字符时,测验是否会短暂突出显示字符。 创建测验时也可以设置此项。
|
||||||
|
highlightCompleteColor?: number;// : null, // 十六进制字符, 默认 null。 在测验中突出显示字符时使用的颜色。 如果未设置,则将使用highlightColor。 仅当highlightOnComplete为true时才相关。
|
||||||
|
onTestStatus?(args: TestStatus):void;// : null, // ({index, status, data})=>{}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.3 繁体、简体、火星文互转: convert
|
||||||
|
|
||||||
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
||||||
|
|
||||||
|
@ -220,7 +359,7 @@ string.convertSparkToSimple();
|
||||||
string.convertSparkToTrad();
|
string.convertSparkToTrad();
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.3 笔画序列推出原汉字: orderToWord
|
#### 5.4 笔画序列推出原汉字: orderToWord
|
||||||
|
|
||||||
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
||||||
|
|
||||||
|
@ -295,7 +434,7 @@ cnchar.orderToWord(['横', '撇', '捺'], 'start', 'simple');
|
||||||
|
|
||||||
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
||||||
|
|
||||||
#### 5.4 通过拼音查询原汉字: spellToWord
|
#### 5.5 通过拼音查询原汉字: spellToWord
|
||||||
|
|
||||||
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -319,7 +458,7 @@ spell 表示拼音,可以使用音调字母或音调数标方式:
|
||||||
|
|
||||||
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
||||||
|
|
||||||
#### 5.5 通过笔画数查询原汉字: strokeToWord
|
#### 5.6 通过笔画数查询原汉字: strokeToWord
|
||||||
|
|
||||||
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -335,7 +474,7 @@ cnchar.strokeToWord(25, 'simple'); // 返回 '鬣馕囔戆攮纛'
|
||||||
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.6 查询拼音详细信息: spellInfo
|
#### 5.7 查询拼音详细信息: spellInfo
|
||||||
|
|
||||||
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
||||||
|
|
||||||
|
@ -369,9 +508,9 @@ cnchar.spellInfo.tones;
|
||||||
// n 的一声使用 * 代替
|
// n 的一声使用 * 代替
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.7 其他 api
|
#### 5.8 其他 api
|
||||||
|
|
||||||
##### 5.7.1 .use()
|
##### 5.8.1 .use()
|
||||||
|
|
||||||
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
||||||
|
|
||||||
|
@ -400,7 +539,7 @@ import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.2 .type
|
##### 5.8.2 .type
|
||||||
|
|
||||||
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
||||||
|
|
||||||
|
@ -424,7 +563,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
|
|
||||||
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
||||||
|
|
||||||
##### 5.7.3 .check
|
##### 5.8.3 .check
|
||||||
|
|
||||||
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
||||||
|
|
||||||
|
@ -434,7 +573,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
cnchar.check = false; // 关闭参数校验
|
cnchar.check = false; // 关闭参数校验
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.4 .version
|
##### 5.8.4 .version
|
||||||
|
|
||||||
获取当前版本:
|
获取当前版本:
|
||||||
|
|
||||||
|
@ -442,7 +581,7 @@ cnchar.check = false; // 关闭参数校验
|
||||||
var version = cnchar.version; // string 类型
|
var version = cnchar.version; // string 类型
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.5 .plugins
|
##### 5.8.5 .plugins
|
||||||
|
|
||||||
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
||||||
|
|
||||||
|
@ -734,3 +873,7 @@ cnchar.convert.sparkToTrad('①个亾');
|
||||||
### 7 应用例子
|
### 7 应用例子
|
||||||
|
|
||||||
[汉字打字游戏](https://www.theajack.com/type/)
|
[汉字打字游戏](https://www.theajack.com/type/)
|
||||||
|
|
||||||
|
**致谢**
|
||||||
|
|
||||||
|
`cnchar-draw` 库功能基于 [hanzi-writer](https://github.com/chanind/hanzi-writer), 特此表示感谢!
|
||||||
|
|
Binary file not shown.
After Width: | Height: | Size: 2.5 KiB |
|
@ -0,0 +1,834 @@
|
||||||
|
# [cnchar](https://github.com/theajack/cnchar) <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/github/stars/theajack/cnchar.svg?style=social" alt="star"></a> <a href="https://theajack.gitee.io"><img src="https://img.shields.io/badge/author-theajack-blue.svg?style=social" alt="Author"></a>
|
||||||
|
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="https://www.npmjs.com/package/cnchar"><img src="https://img.shields.io/npm/v/cnchar.svg" alt="Version"></a>
|
||||||
|
<a href="https://npmcharts.com/compare/cnchar?minimal=true"><img src="https://img.shields.io/npm/dm/cnchar.svg" alt="Downloads"></a>
|
||||||
|
<a href="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"><img src="https://img.shields.io/bundlephobia/minzip/cnchar.svg" alt="Size"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/cnchar.svg" alt="License"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/search?l=javascript"><img src="https://img.shields.io/github/languages/top/theajack/cnchar.svg" alt="TopLang"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/issues"><img src="https://img.shields.io/github/issues-closed/theajack/cnchar.svg" alt="issue"></a>
|
||||||
|
<!-- <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/librariesio/dependent-repos/npm/cnchar.svg" alt="Dependent"></a> -->
|
||||||
|
</p>
|
||||||
|
|
||||||
|
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
||||||
|
|
||||||
|
**<a href="#66-使用实例大全">快速上手</a> | [在线试用/文档](https://theajack.gitee.io/cnchar) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://theajack.gitee.io/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/new)**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
<!-- toc -->
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 前言
|
||||||
|
|
||||||
|
感谢同学们对于 cnchar 的支持,由于 cnchar 词库来源于网络,虽然经过了本人的修改和扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 [反馈](https://github.com/theajack/cnchar/issues/new) 给我(或自行修改提交,经过审查无误过后会合到 cnchar 中)
|
||||||
|
|
||||||
|
[我要反馈错误或缺漏](https://github.com/theajack/cnchar/issues/new)
|
||||||
|
|
||||||
|
### 0.快速使用
|
||||||
|
|
||||||
|
使用 npm 安装:
|
||||||
|
|
||||||
|
```
|
||||||
|
npm i cnchar
|
||||||
|
```
|
||||||
|
|
||||||
|
```js
|
||||||
|
import cnchar from 'cnchar';
|
||||||
|
'汉字'.spell();
|
||||||
|
'汉字'.stroke();
|
||||||
|
```
|
||||||
|
|
||||||
|
使用 script 标签使用:
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
|
<script>
|
||||||
|
'汉字'.spell();
|
||||||
|
'汉字'.stroke();
|
||||||
|
</script>
|
||||||
|
```
|
||||||
|
|
||||||
|
<a href="#66-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
||||||
|
|
||||||
|
### 1.功能
|
||||||
|
|
||||||
|
1. 获取 **汉字拼音** ,支持首字母、大小写、数组分割、备选 **多音字** 等功能
|
||||||
|
2. 支持 **多音词**
|
||||||
|
3. 支持 **拼音音调**
|
||||||
|
4. 获取汉字 **笔画数** 、支持数组分割
|
||||||
|
5. 获取汉字 **笔画顺序** 、笔画详细名称
|
||||||
|
6. 支持可视化 **绘制汉字笔画** 、多种绘制模式可选
|
||||||
|
7. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
||||||
|
8. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
||||||
|
9. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
||||||
|
10. 支持 **根据笔画顺序查询** 汉字
|
||||||
|
11. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
||||||
|
12. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
||||||
|
13. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
||||||
|
14. **多端可用**,可用于 **浏览器、nodejs、小程序/小游戏、ReactNative/Weex/Uniapp/Electron、webpack**...,支持所有 js 能运行的环境
|
||||||
|
15. **typescript支持**,支持在typescript中调用
|
||||||
|
16. 丰富的配置,按需取用
|
||||||
|
|
||||||
|
### 2.概览
|
||||||
|
|
||||||
|
考虑到不同的需求,cnchar 的功能被拆分到以下四个库中:
|
||||||
|
|
||||||
|
| 名称 | 描述 | 功能 |
|
||||||
|
| :----------: | :------------------------------: | :--------------------: |
|
||||||
|
| cnchar | 主 js 库,其他三个库依赖于这个库 | 含有简体字拼音、多音字、音调、笔画数等功能 |
|
||||||
|
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
||||||
|
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
||||||
|
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
||||||
|
| cnchar-draw | 绘制笔画库 | 指出可视化绘制汉字,有 normal,animation,stroke,test 四种模式可选,该库仅在浏览器环境下可用 |
|
||||||
|
|
||||||
|
### 3 安装
|
||||||
|
|
||||||
|
#### 3.1 使用 npm 安装
|
||||||
|
|
||||||
|
安装基础库:
|
||||||
|
|
||||||
|
```
|
||||||
|
npm i cnchar
|
||||||
|
```
|
||||||
|
|
||||||
|
安装附加功能库:
|
||||||
|
|
||||||
|
```
|
||||||
|
npm i cnchar-poly cnchar-order cnchar-trad cnchar-draw
|
||||||
|
```
|
||||||
|
|
||||||
|
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
||||||
|
|
||||||
|
或者您可以通过安装`cnchar-all`来使用完整功能,这个库引用了上面的四个库
|
||||||
|
|
||||||
|
```
|
||||||
|
npm i cnchar-all
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 3.2 使用 script 引入
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
|
```
|
||||||
|
|
||||||
|
或使用以下cdn,包含了以上五个库
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-all/cnchar.all.min.js"></script>
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### 4 使用
|
||||||
|
|
||||||
|
#### 4.1 webpack浏览器环境(有window对象)
|
||||||
|
|
||||||
|
npm 安装好几个库之后:
|
||||||
|
|
||||||
|
```js
|
||||||
|
// 请保证最先引入 cnchar 基础库,其他几个库顺序无所谓
|
||||||
|
import cnchar from 'cnchar';
|
||||||
|
import 'cnchar-poly';
|
||||||
|
import 'cnchar-order';
|
||||||
|
import 'cnchar-trad';
|
||||||
|
import 'cnchar-draw';
|
||||||
|
// 插件请按需取用
|
||||||
|
|
||||||
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
```
|
||||||
|
|
||||||
|
浏览器环境下会在 `window` 对象上定义 `cnchar` 对象
|
||||||
|
|
||||||
|
#### 4.2 nodejs 等非浏览器环境
|
||||||
|
|
||||||
|
非浏览器环境下需要使用 `cnchar.use()` 方法加载功能库:
|
||||||
|
|
||||||
|
```js
|
||||||
|
// 请保证最先引入 cnchar 基础库,其他几个库顺序无所谓
|
||||||
|
var cnchar = require('cnchar');
|
||||||
|
var poly = require('cnchar-poly');
|
||||||
|
var order = require('cnchar-order');
|
||||||
|
var trad = require('cnchar-trad');
|
||||||
|
// 插件请按需取用
|
||||||
|
// cnchar-draw 在非浏览器环境下不可使用
|
||||||
|
cnchar.use(poly, order, trad);
|
||||||
|
|
||||||
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
```
|
||||||
|
|
||||||
|
其他使用方式与浏览器环境一致
|
||||||
|
|
||||||
|
#### 4.3 原生浏览器环境
|
||||||
|
|
||||||
|
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
|
<script>
|
||||||
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
</script>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5 API
|
||||||
|
|
||||||
|
类型声明:[cnchar.d.ts](https://github.com/theajack/cnchar/blob/master/src/main/index.d.ts)
|
||||||
|
|
||||||
|
#### 5.1 拼音笔画基础 API: spell & stroke
|
||||||
|
|
||||||
|
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
||||||
|
|
||||||
|
```js
|
||||||
|
// 获取汉字的拼音、多音词、音调等都集成在以下方法上
|
||||||
|
cnchar.spell(string[,...args]);
|
||||||
|
// 或
|
||||||
|
string.spell([...args])
|
||||||
|
|
||||||
|
// 获取汉字的笔画、笔画顺序等都集成在以下方法上
|
||||||
|
cnchar.stroke(string[,...args]);
|
||||||
|
// 或
|
||||||
|
string.stroke([...args])
|
||||||
|
```
|
||||||
|
|
||||||
|
该 api 设计一致,`string` 表示要处理的汉字字符串
|
||||||
|
|
||||||
|
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
||||||
|
|
||||||
|
#### 5.2 可视化绘制汉字: draw
|
||||||
|
|
||||||
|
类型声明:[cnchar.draw.d.ts](https://github.com/theajack/cnchar/blob/master/src/plugin/draw/index.d.ts)
|
||||||
|
|
||||||
|
`cnchar-draw` 库用于支持在浏览器环境下可视化绘制汉字,所以该库仅在浏览器环境下可用。
|
||||||
|
|
||||||
|
##### 5.2.1 使用
|
||||||
|
|
||||||
|
使用方式如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.draw('你好', options); // options 为可选参数, 在5.2.2 种会详细介绍
|
||||||
|
```
|
||||||
|
|
||||||
|
运行结果如下:
|
||||||
|
|
||||||
|
![draw.jpg](https://cdn.jsdelivr.net/gh/theajack/cnchar/assets/readme/draw.jpg)
|
||||||
|
|
||||||
|
该库支持脱离cnchar 独立使用
|
||||||
|
|
||||||
|
```js
|
||||||
|
import draw from 'cnchar-draw';
|
||||||
|
draw('你好')
|
||||||
|
```
|
||||||
|
|
||||||
|
使用cdn引用时,会在window对向上暴露 `CncharDraw` 对象
|
||||||
|
|
||||||
|
##### 5.2.2 参数
|
||||||
|
|
||||||
|
draw 的参数比较繁多,首先需要理解的是,draw 分为四种绘制模式:
|
||||||
|
|
||||||
|
1. normal: 常规绘制
|
||||||
|
2. animation: 带有绘制动画,支持连续绘制、同时绘制、循环绘制
|
||||||
|
3. stroke: 按汉字笔顺单步绘制
|
||||||
|
4. test: 测试模式,用户可以在容器内绘制汉字,cnchar-draw会检测是否绘制正确
|
||||||
|
|
||||||
|
以下是 options 的所有可选参数及描述,使用详情请参考[在线文档](https://theajack.gitee.io/cnchar):
|
||||||
|
|
||||||
|
```ts
|
||||||
|
declare interface DrawOption {
|
||||||
|
el?: string | HTMLElement; // 绘制的容器,支持id和dom,若是不填,会在body后append一个dom作为容器
|
||||||
|
type?: DrawType; // 绘制模式,默认为normal
|
||||||
|
style?: { // 样式类
|
||||||
|
showOutline?: boolean;//: true,
|
||||||
|
showCharacter?: boolean;//: true,
|
||||||
|
currentColor?: string;//: '#b44', // 仅在stroke模式下有效
|
||||||
|
length?: number;//: 60,
|
||||||
|
padding?: number;//: 5, // 数值, 默认 20。 画布的汉字和边缘之间的填充
|
||||||
|
outlineColor?: string;//: '#ddd', // 十六进制字符, 默认 '#DDD'。
|
||||||
|
strokeColor?: string;//: '#555', // 十六进制字符, 默认 '#555'。绘制每个笔划的颜色。
|
||||||
|
radicalColor?: string;//: null, // 十六进制字符, 默认 null。 如果存在偏旁部首数据,则在笔划中绘制偏旁部首的颜色。 如果没有设置,激光将绘制与其他笔划相同的颜色。
|
||||||
|
strokeFadeDuration?: number; //400
|
||||||
|
},
|
||||||
|
line?: { // 背景线条类
|
||||||
|
lineStraight?: boolean;// : true,
|
||||||
|
lineCross?: boolean;// : true,
|
||||||
|
lineWidth?: number;// : 1,
|
||||||
|
lineColor?: string;// : '#ddd',
|
||||||
|
lineDash?: boolean;// : true,
|
||||||
|
border?: boolean;// : true,
|
||||||
|
borderWidth?: number;// : 1,
|
||||||
|
borderColor?: string;// : '#ccc',
|
||||||
|
borderDash?: boolean;// : false,
|
||||||
|
},
|
||||||
|
animation?: {
|
||||||
|
strokeAnimationSpeed?: number;// : 1, // 数值, 默认 1。 绘制每个笔划的速度必须大于0。增加此数字可以更快地绘制笔划,减少绘制笔划的速度更慢。
|
||||||
|
delayBetweenStrokes?: number;// : 1000, // 数值, 默认 1000。 动画进行中每个笔画之间的间隔时间(以毫秒为单位)。
|
||||||
|
delayBetweenLoops?: number;// : 200, // 数值, 默认 2000。 循环动画时每个动画循环之间的时间(以毫秒为单位)。
|
||||||
|
autoAnimate?: boolean;// : true,
|
||||||
|
animateComplete?: Function;// : () => {},
|
||||||
|
stepByStep?: boolean;// : true,
|
||||||
|
loopAnimate?: boolean;// : false,
|
||||||
|
},
|
||||||
|
test?: {
|
||||||
|
strokeHighlightSpeed?: number;// : 20, // 数值, 默认 20。 在测验中给出提示时突出显示每个笔划的速度必须大于0。增加此数字以突出显示更快,减少以突出显示更慢。
|
||||||
|
highlightColor?: number;// : '#aaf', // 十六进制字符, 默认 '#AAF'。 用于在测验中突出显示的颜色。
|
||||||
|
drawingColor?: number;// : '#333', // 十六进制字符, 默认 '#333'。 测验期间绘制的线条颜色。
|
||||||
|
drawingWidth?: number;// : 4, // 数值, 默认 4。 进行测验时绘制的线条宽度。
|
||||||
|
showHintAfterMisses?: number;// : 3, // 整数, 默认 3 中风高亮提示之前的未命中数被给予用户。 设置为 false 以禁用。 创建测验时也可以设置此项。
|
||||||
|
highlightOnComplete?: number;// : true, // 布尔值, 默认 true。 控制当用户完成绘制整个字符时,测验是否会短暂突出显示字符。 创建测验时也可以设置此项。
|
||||||
|
highlightCompleteColor?: number;// : null, // 十六进制字符, 默认 null。 在测验中突出显示字符时使用的颜色。 如果未设置,则将使用highlightColor。 仅当highlightOnComplete为true时才相关。
|
||||||
|
onTestStatus?(args: TestStatus):void;// : null, // ({index, status, data})=>{}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.3 繁体、简体、火星文互转: convert
|
||||||
|
|
||||||
|
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
||||||
|
|
||||||
|
自从 v2.0.4 以后,cnchar 保留以下方法可供使用:
|
||||||
|
|
||||||
|
```js
|
||||||
|
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();
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.4 笔画序列推出原汉字: orderToWord
|
||||||
|
|
||||||
|
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.orderToWord(orderNames[,...args]);
|
||||||
|
```
|
||||||
|
|
||||||
|
`orderNames` 是笔画名称序列
|
||||||
|
|
||||||
|
`args` 是参数列表,可选值有 `['match','matchorder','contain','start','array','simple']`, 使用 `cnchar.type.orderToWord` 可以查看可选值。 参数详细使用方法请参见<a href="#63-ordertoword-参数">第六章 orderToWord 参数</a>
|
||||||
|
|
||||||
|
`orderNames` 可以是空格分隔的笔画名称字符串或笔画名称数组,可用的笔画名称可以通过以下 api 查看
|
||||||
|
|
||||||
|
```js
|
||||||
|
var dict = cnchar.orderToWord.orders; // dict 是一个包含所有笔画数的详细信息的json数据
|
||||||
|
```
|
||||||
|
|
||||||
|
笔画详细信息的如下,orderNames 只需要传入笔画名称即可,也就是下面 json 数据的 key 值
|
||||||
|
|
||||||
|
```js
|
||||||
|
{
|
||||||
|
卧钩: {shape: "㇃", letter: "y", sameLetterTo: "斜钩"}
|
||||||
|
弯钩: {shape: "㇁", letter: "t"}
|
||||||
|
捺: {shape: "㇏", letter: "l"}
|
||||||
|
提: {shape: "㇀", letter: "i"}
|
||||||
|
撇: {shape: "㇓", letter: "s"}
|
||||||
|
撇折: {shape: "㇜", letter: "n"}
|
||||||
|
撇点: {shape: "㇛", letter: "m"}
|
||||||
|
斜钩: {shape: "㇂", letter: "y", sameLetterTo: "卧钩"}
|
||||||
|
横: {shape: "㇐", letter: "j"}
|
||||||
|
横折: {shape: "㇕", letter: "c"}
|
||||||
|
横折弯: {shape: "㇍", letter: "v", sameLetterTo: "横折折"}
|
||||||
|
横折折: {shape: "㇅", letter: "v", sameLetterTo: "横折弯"}
|
||||||
|
横折折折: {shape: "㇎", letter: "q"}
|
||||||
|
横折折折钩: {shape: "㇡", letter: "w", sameLetterTo: "横撇弯钩"}
|
||||||
|
横折折撇: {shape: "㇋", letter: "a"}
|
||||||
|
横折提: {shape: "㇊", letter: "p"}
|
||||||
|
横折钩: {shape: "㇆", letter: "r"}
|
||||||
|
横撇: {shape: "㇇", letter: "e", sameLetterTo: "横钩"}
|
||||||
|
横撇弯钩: {shape: "㇌", letter: "w", sameLetterTo: "横折折折钩"}
|
||||||
|
横斜钩: {shape: "⺄", letter: "o"}
|
||||||
|
横钩: {shape: "㇖", letter: "e", sameLetterTo: "横撇"}
|
||||||
|
点: {shape: "㇔", letter: "k"}
|
||||||
|
竖: {shape: "㇑", letter: "f"}
|
||||||
|
竖弯: {shape: "㇄", letter: "b"}
|
||||||
|
竖弯钩: {shape: "㇟", letter: "u"}
|
||||||
|
竖折折: {shape: "㇞", letter: "x", sameLetterTo: "竖折撇"}
|
||||||
|
竖折折钩: {shape: "㇉", letter: "z"}
|
||||||
|
竖折撇: {shape: "ㄣ", letter: "x", sameLetterTo: "竖折折"}
|
||||||
|
竖提: {shape: "㇙", letter: "h"}
|
||||||
|
竖钩: {shape: "㇚", letter: "g"}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
注:其中以下五对笔画没有进行区分,使用的是同样的字母表示:
|
||||||
|
**卧钩 = 斜钩**、**横折弯 = 横折折**、**横折折折钩 = 横撇弯钩**、**横撇 = 横钩**、**竖折折 = 竖折撇**
|
||||||
|
|
||||||
|
以下是一个例子:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.orderToWord(['横', '撇', '捺']);
|
||||||
|
// 等价于
|
||||||
|
cnchar.orderToWord('横 撇 捺');
|
||||||
|
// 返回 "丈大"
|
||||||
|
cnchar.orderToWord(['横', '撇', '捺'], 'array');
|
||||||
|
// 返回 ["丈","大"]
|
||||||
|
cnchar.orderToWord(['横', '撇', '捺'], 'start');
|
||||||
|
// 返回 "丈大太犬夯夸夺夼奁奄奈奋奔态奎耷套奢瓠鹩奪奮遼"
|
||||||
|
cnchar.orderToWord(['横', '撇', '捺'], 'start', 'simple');
|
||||||
|
// 返回 "丈大太犬夯夸夺夼奁奄奈奋奔态奎耷套奢瓠鹩"
|
||||||
|
```
|
||||||
|
|
||||||
|
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
||||||
|
|
||||||
|
#### 5.5 通过拼音查询原汉字: spellToWord
|
||||||
|
|
||||||
|
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.spellToWord(spell[,...args]);
|
||||||
|
```
|
||||||
|
|
||||||
|
例子:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.spellToWord('shàng'); // 返回 '上尚绱鞝'
|
||||||
|
cnchar.spellToWord('shàng', 'alltone'); // 返回 '上伤汤尚垧殇晌商绱觞赏墒熵裳傷湯殤鞝觴賞'
|
||||||
|
cnchar.spellToWord('shang4', 'alltone', 'trad'); // 返回 '傷湯殤鞝觴賞'
|
||||||
|
cnchar.spellToWord('lv2', 'simple'); // 返回 '驴闾榈'
|
||||||
|
```
|
||||||
|
|
||||||
|
注:
|
||||||
|
|
||||||
|
spell 表示拼音,可以使用音调字母或音调数标方式:
|
||||||
|
例:`shàng 等价于 shang4`
|
||||||
|
|
||||||
|
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
||||||
|
|
||||||
|
#### 5.6 通过笔画数查询原汉字: strokeToWord
|
||||||
|
|
||||||
|
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.strokeToWord(strokeCount[,...args]);
|
||||||
|
```
|
||||||
|
|
||||||
|
例子:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.strokeToWord(25); // 返回 '鬣馕囔戆攮纛饞躥顱籮蠻廳灣鑲鑰'
|
||||||
|
cnchar.strokeToWord(25, 'simple'); // 返回 '鬣馕囔戆攮纛'
|
||||||
|
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.7 查询拼音详细信息: spellInfo
|
||||||
|
|
||||||
|
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.spellInfo(spell);
|
||||||
|
```
|
||||||
|
|
||||||
|
例子:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.spellInfo('Shàng');
|
||||||
|
/*
|
||||||
|
// 返回值与含义如下
|
||||||
|
{
|
||||||
|
spell: 'shang', // 无音调拼音
|
||||||
|
initial: 'sh', // 声母
|
||||||
|
final: 'ang', // 韵母
|
||||||
|
tone: 4, // 音调
|
||||||
|
index: 3 // 音调位置
|
||||||
|
},
|
||||||
|
*/
|
||||||
|
```
|
||||||
|
|
||||||
|
除此之外,`spellInfo` 上含有 `initials` 和 `tones` 两个属性,分别表示,所有可用的声母和音调:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.spellInfo.initials;
|
||||||
|
// ['b', 'p', 'm', 'f', 'd', 't', 'n', 'l', 'g', 'k', 'h', 'j', 'q', 'x', 'zh', 'ch', 'sh', 'r', 'z', 'c', 's', 'y', 'w']
|
||||||
|
cnchar.spellInfo.tones;
|
||||||
|
// ['ā', 'á', 'ǎ', 'à', 'ō', 'ó', 'ǒ', 'ò', 'ē', 'é', 'ě', 'è', 'ī', 'í', 'ǐ', 'ì', 'ū', 'ú', 'ǔ', 'ù', 'ǖ', 'ǘ', 'ǚ', 'ǜ', '*', 'ń', 'ň', 'ǹ']
|
||||||
|
// n 的一声使用 * 代替
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.8 其他 api
|
||||||
|
|
||||||
|
##### 5.8.1 .use()
|
||||||
|
|
||||||
|
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.use(...libs);
|
||||||
|
```
|
||||||
|
|
||||||
|
这个启用在非浏览器环境(比如 nodejs 等)中是必须的,使用如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
// 请保证最先引入 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); // 参数顺序无关,三个参数可以任意选择
|
||||||
|
```
|
||||||
|
|
||||||
|
在浏览器环境中则无需调用:
|
||||||
|
|
||||||
|
```js
|
||||||
|
// 请保证最先引入 cnchar 基础库,其他几个库顺序无所谓
|
||||||
|
import cnchar from 'cnchar';
|
||||||
|
import 'cnchar-poly';
|
||||||
|
import 'cnchar-order';
|
||||||
|
import 'cnchar-trad';
|
||||||
|
```
|
||||||
|
|
||||||
|
##### 5.8.2 .type
|
||||||
|
|
||||||
|
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
||||||
|
|
||||||
|
```js
|
||||||
|
var spellArg = cnchar.type.spell;
|
||||||
|
var strokeArg = cnchar.type.stroke;
|
||||||
|
var orderToWordArg = cnchar.type.orderToWord;
|
||||||
|
var spellToWordArg = cnchar.type.spellToWord;
|
||||||
|
var strokeToWordArg = cnchar.type.strokeToWord;
|
||||||
|
```
|
||||||
|
|
||||||
|
spellArg 最多可用值: `['array', 'low', 'up', 'first', 'poly', 'tone', 'simple']`
|
||||||
|
|
||||||
|
strokeArg 最多可用值:`['letter', 'shape', 'count', 'name', 'detail', 'array', 'order', 'simple']`
|
||||||
|
|
||||||
|
orderToWordArg 最多可用值: `['match','matchorder','contain','start','array','simple']`
|
||||||
|
|
||||||
|
spellToWordArg 最多可用值: `['simple','trad','poly','alltone','array']`
|
||||||
|
|
||||||
|
strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
|
|
||||||
|
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
||||||
|
|
||||||
|
##### 5.8.3 .check
|
||||||
|
|
||||||
|
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
||||||
|
|
||||||
|
参数校验能够对 `spell` 和 `stroke` 传入的参数进行检查,在控制台显示 `无效·`,`忽略`和`冗余`的参数
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.check = false; // 关闭参数校验
|
||||||
|
```
|
||||||
|
|
||||||
|
##### 5.8.4 .version
|
||||||
|
|
||||||
|
获取当前版本:
|
||||||
|
|
||||||
|
```js
|
||||||
|
var version = cnchar.version; // string 类型
|
||||||
|
```
|
||||||
|
|
||||||
|
##### 5.8.5 .plugins
|
||||||
|
|
||||||
|
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
||||||
|
|
||||||
|
```js
|
||||||
|
var plugins = cnchar.plugins; // array 类型
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6 spell stroke 参数
|
||||||
|
|
||||||
|
#### 6.1 spell 参数
|
||||||
|
|
||||||
|
参数调用如下,所有 arg 参数都是可选的
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.spell(string,arg1,arg2,...);
|
||||||
|
string.spell(arg1,arg2,...)
|
||||||
|
```
|
||||||
|
|
||||||
|
arg 参数信息如下:
|
||||||
|
|
||||||
|
| 参数 | 作用 | 是否默认 | 依赖库 | 备注 |
|
||||||
|
| :----: | :----------------------: | :------: | :---------: | :-------: |
|
||||||
|
| array | 返回数组 | 否 | -- | -- |
|
||||||
|
| first | 返回拼音首字母 | 否 | -- | -- |
|
||||||
|
| up | 将结果全部大写 | 否 | -- | -- |
|
||||||
|
| low | 将结果全部小写 | 否 | -- | 会被 up 参数覆盖 |
|
||||||
|
| poly | 使用候选多音字 | 否 | -- | -- |
|
||||||
|
| tone | 启用音调 | 否 | -- | -- |
|
||||||
|
| simple | 是否禁用繁体字的拼音功能 | 否 | cnchar-trad | 使用 cnchar-trad 之后,默认对繁体字拼音进行转换,该参数用于禁用繁体字拼音 |
|
||||||
|
|
||||||
|
#### 6.2 stroke 参数
|
||||||
|
|
||||||
|
参数调用如下,所有 arg 参数都是可选的
|
||||||
|
|
||||||
|
```js
|
||||||
|
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 之后,默认对繁体字启用笔画功能,该参数用于禁用繁体字笔画功能 |
|
||||||
|
|
||||||
|
#### 6.3 orderToWord 参数
|
||||||
|
|
||||||
|
参数调用如下,所有 arg 参数都是可选的
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.orderToWord(orders,arg1,arg2,...);
|
||||||
|
```
|
||||||
|
|
||||||
|
arg 参数信息如下:
|
||||||
|
|
||||||
|
| 参数 | 作用 | 是否默认 | 依赖库 | 备注 |
|
||||||
|
| :---------: | :--------: | :------: | :---------: | :---: |
|
||||||
|
| match | 匹配含有笔序中所有笔画的汉字 | 否 | -- | -- |
|
||||||
|
| match-order | 匹配含有笔序中所有笔画的汉字前先后顺序一致 | 否 | -- | -- |
|
||||||
|
| contain | 匹配含有该笔序的汉字 | 否 | -- | -- |
|
||||||
|
| start | 匹配所有以该笔序开头的汉字 | 否 | -- | -- |
|
||||||
|
| array | 返回符合条件的数组,默认返回的是字符串 | 否 | -- | -- |
|
||||||
|
| simple | 禁用繁体字 | 否 | cnchar-trad | 该参数仅在引入了 `cnchar-trad` 后有效 |
|
||||||
|
|
||||||
|
关于匹配参数,优先级为 **match > match-order > contain > start > 默认**
|
||||||
|
|
||||||
|
不含有匹配参数时表示使用全匹配,即汉字笔画数与传入的 orders 完全一致
|
||||||
|
|
||||||
|
#### 6.4 spellToWord 参数
|
||||||
|
|
||||||
|
参数调用如下,所有 arg 参数都是可选的
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.spellToWord(spell,arg1,arg2,...);
|
||||||
|
```
|
||||||
|
|
||||||
|
spell 表示拼音,可以使用音调字母或音调数标方式:
|
||||||
|
例:`shàng 等价于 shang4`
|
||||||
|
|
||||||
|
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
||||||
|
|
||||||
|
arg 参数信息如下:
|
||||||
|
|
||||||
|
| 参数 | 作用 | 是否默认 | 依赖库 | 备注 |
|
||||||
|
| :-----: | :----: | :------: | :---: | :---: |
|
||||||
|
| simple | 仅匹配简体字 | 否 | -- | -- |
|
||||||
|
| trad | 仅匹配繁体字 | 否 | cnchar-trad | 该参数仅在引入了 `cnchar-trad` 后有效 |
|
||||||
|
| poly | 仅匹配多音字 | 否 | -- | -- |
|
||||||
|
| alltone | 匹配该拼音所有音调的汉字 | 否 | -- | 没有音调的拼音表示轻声 |
|
||||||
|
| array | 返回符合条件的数组,默认返回的是字符串 | 否 | -- | -- |
|
||||||
|
|
||||||
|
注:`simple`与`trad`参数若是都不存在,则当引入`cnchar-trad`时会同时匹配繁简体,没有引入`cnchar-trad`时则只匹配简体
|
||||||
|
|
||||||
|
|
||||||
|
#### 6.5 strokeToWord 参数
|
||||||
|
|
||||||
|
参数调用如下,所有 arg 参数都是可选的
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.strokeToWord(spell,arg1,arg2,...);
|
||||||
|
```
|
||||||
|
|
||||||
|
| 参数 | 作用 | 是否默认 | 依赖库 | 备注 |
|
||||||
|
| :-----: | :----: | :------: | :---: | :---: |
|
||||||
|
| simple | 仅匹配简体字 | 否 | -- | -- |
|
||||||
|
| trad | 仅匹配繁体字 | 否 | cnchar-trad | 该参数仅在引入了 `cnchar-trad` 后有效 |
|
||||||
|
| array | 返回符合条件的数组,默认返回的是字符串 | 否 | -- | -- |
|
||||||
|
|
||||||
|
注:`simple`与`trad`参数若是都不存在,则当引入`cnchar-trad`时会同时匹配繁简体,没有引入`cnchar-trad`时则只匹配简体
|
||||||
|
|
||||||
|
#### 6.6 使用实例大全:
|
||||||
|
|
||||||
|
##### 6.6.0 安装使用
|
||||||
|
|
||||||
|
npm 方式
|
||||||
|
|
||||||
|
```
|
||||||
|
npm i cnchar
|
||||||
|
```
|
||||||
|
|
||||||
|
```js
|
||||||
|
import cnchar from 'cnchar';
|
||||||
|
// do something
|
||||||
|
```
|
||||||
|
|
||||||
|
script 标签引用 方式
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"></script>
|
||||||
|
<script>
|
||||||
|
// do something
|
||||||
|
</script>
|
||||||
|
```
|
||||||
|
|
||||||
|
##### 6.6.1 cnchar 基础库功能
|
||||||
|
|
||||||
|
```js
|
||||||
|
//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]
|
||||||
|
|
||||||
|
//spellToWord 功能
|
||||||
|
cnchar.spellToWord('shàng'); // 返回 "上尚绱"
|
||||||
|
cnchar.spellToWord('lv2'); // 返回 "驴闾榈"
|
||||||
|
|
||||||
|
//strokeToWord 功能
|
||||||
|
cnchar.strokeToWord(2); // 返回 "丁七乃乜九了二人亻儿入八冂几凵刀刁力勹
|
||||||
|
|
||||||
|
//spellInfo 功能
|
||||||
|
cnchar.spellInfo('shàng');
|
||||||
|
// 返回 {spell: "shang", tone: 4, index: 3, initial: "sh", final: "ang"}
|
||||||
|
```
|
||||||
|
|
||||||
|
备注:
|
||||||
|
|
||||||
|
1. string.spell(...arg)方法等价于 `cnchar.spell(string,...args)`
|
||||||
|
2. string.stroke(...arg)方法等价于 `cnchar.stroke(string,...args)`
|
||||||
|
3. spell 方法 非中文字符会返回原字符
|
||||||
|
4. stroke 方法 非中文字符会笔画数会计为 0
|
||||||
|
5. stroke 方法 order 模式 非中文字符会返回 undefined
|
||||||
|
|
||||||
|
##### 6.6.2 cnchar-poly 库功能
|
||||||
|
|
||||||
|
该库用于准确识别多音词,同样支持 6.3.1 中的其他参数功能
|
||||||
|
|
||||||
|
```js
|
||||||
|
'长大了'.spell(); // 返回 'ZhangDaLe'
|
||||||
|
'长大了'.spell('array'); // 返回 ["Zhang", "Da", "Le"]
|
||||||
|
'长大了'.spell('poly'); // 返回 '(Zhang|Chang)(Da|Dai)(Le|Liao)'
|
||||||
|
```
|
||||||
|
|
||||||
|
##### 6.6.3 cnchar-order 库功能
|
||||||
|
|
||||||
|
该库用于查询汉字笔画顺序、笔画名称等,返回值为 数组
|
||||||
|
|
||||||
|
```js
|
||||||
|
'一个'.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]
|
||||||
|
```
|
||||||
|
|
||||||
|
根据笔画名称序列推出原汉字
|
||||||
|
|
||||||
|
```js
|
||||||
|
var orders = cnchar.orderToWord.orders; //查看支持的笔画名称
|
||||||
|
cnchar.orderToWord(['横', '撇', '捺']);
|
||||||
|
// 返回 "丈大"
|
||||||
|
cnchar.orderToWord(['横', '撇', '捺'], 'array');
|
||||||
|
// 返回 ["丈","大"]
|
||||||
|
cnchar.orderToWord(['横', '撇', '捺'], 'start');
|
||||||
|
// 返回 "丈大太犬夯夸夺夼奁奄奈奋奔态奎耷套奢瓠鹩奪奮遼"
|
||||||
|
cnchar.orderToWord(['横', '撇', '捺'], 'start', 'simple');
|
||||||
|
// 返回 "丈大太犬夯夸夺夼奁奄奈奋奔态奎耷套奢瓠鹩"
|
||||||
|
cnchar.orderToWord(['横', '撇', '捺'], 'match');
|
||||||
|
// 返回 "丈大仄兮友天太夫夭尺攵文木犬长丛仗仝叭..." // 省略后面的
|
||||||
|
cnchar.orderToWord(['横', '撇', '捺'], 'matchorder');
|
||||||
|
// 返回 "丈大仄友天太夫夭尺攵文木犬仗叭史央夯失..." // 省略后面的
|
||||||
|
cnchar.orderToWord(['横', '撇', '捺'], 'contain');
|
||||||
|
// 返回 "丈大天太夫夭尺攵文犬仗叭史央夯失疋矢乔..." // 省略后面的
|
||||||
|
```
|
||||||
|
|
||||||
|
##### 6.6.4 cnchar-trad 库功能
|
||||||
|
|
||||||
|
该库用于支持繁体字火星文转换及为拼音笔画数等基本功能提供繁体字支持
|
||||||
|
|
||||||
|
###### 6.6.4.1 convert 字体转换
|
||||||
|
|
||||||
|
```js
|
||||||
|
'一个人'.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('①个亾');
|
||||||
|
```
|
||||||
|
|
||||||
|
###### 6.6.4.2 spell 和 stroke 方法
|
||||||
|
|
||||||
|
该库增加了对于繁体字的拼音笔画功能扩展,其他基础用法与 基础库一致:
|
||||||
|
|
||||||
|
```js
|
||||||
|
//spell 功能
|
||||||
|
'長大'.spell(); // 返回 'ZhangDa'
|
||||||
|
'長大'.spell('simple'); // 返回 '長Da' // 禁用繁体字拼音功能
|
||||||
|
|
||||||
|
//stroke 功能
|
||||||
|
'長大'.stroke('array'); // 返回 [8, 3]
|
||||||
|
'長大'.stroke('array', 'simple'); // 返回 [0, 3] // 禁用繁体字笔画功能
|
||||||
|
'長大'.stroke('order', 'shape'); // 返回 [["㇐","㇑","㇐","㇐","㇐","㇙","㇓","㇏"],["㇐","㇓","㇏"]]
|
||||||
|
'長大'.stroke('order', 'shape', 'simple'); // 返回 [undefined, ["㇐","㇓","㇏"]]
|
||||||
|
```
|
||||||
|
|
||||||
|
### 7 应用例子
|
||||||
|
|
||||||
|
[汉字打字游戏](https://www.theajack.com/type/)
|
||||||
|
|
||||||
|
**致谢**
|
||||||
|
|
||||||
|
`cnchar-draw` 库功能基于 [hanzi-writer](https://github.com/chanind/hanzi-writer), 特此表示感谢!
|
|
@ -2,6 +2,7 @@ const gulp = require('gulp');
|
||||||
const rename = require('gulp-rename');
|
const rename = require('gulp-rename');
|
||||||
const fs = require('fs');
|
const fs = require('fs');
|
||||||
const babel = require('gulp-babel');
|
const babel = require('gulp-babel');
|
||||||
|
const toc = require('gulp-markdown-toc');
|
||||||
let version = require('../package.json').version;
|
let version = require('../package.json').version;
|
||||||
let files = [
|
let files = [
|
||||||
'../npm/order/package.json',
|
'../npm/order/package.json',
|
||||||
|
@ -53,18 +54,30 @@ function task () {
|
||||||
}
|
}
|
||||||
|
|
||||||
function copyToNPM () {
|
function copyToNPM () {
|
||||||
gulp.src(['src/main/*.json', 'src/main/index.d.ts', 'README.md', 'LICENSE'])
|
gulp.src('helper/README.md')
|
||||||
|
.pipe(toc())
|
||||||
|
.pipe(gulp.dest('.'))
|
||||||
|
.pipe(gulp.dest('npm/cnchar'))
|
||||||
|
.pipe(gulp.dest('npm/order'))
|
||||||
|
.pipe(gulp.dest('npm/poly'))
|
||||||
|
.pipe(gulp.dest('npm/trad'))
|
||||||
|
.pipe(gulp.dest('npm/draw'));
|
||||||
|
|
||||||
|
gulp.src(['src/main/*.json', 'src/main/index.d.ts', 'LICENSE'])
|
||||||
.pipe(gulp.dest('npm/cnchar'));
|
.pipe(gulp.dest('npm/cnchar'));
|
||||||
|
|
||||||
gulp.src(['src/plugin/order/*.json', 'README.md', 'LICENSE'])
|
gulp.src(['src/plugin/order/*.json', 'LICENSE'])
|
||||||
.pipe(gulp.dest('npm/order'));
|
.pipe(gulp.dest('npm/order'));
|
||||||
|
|
||||||
gulp.src(['src/plugin/poly/*.json', 'README.md', 'LICENSE'])
|
gulp.src(['src/plugin/poly/*.json', 'LICENSE'])
|
||||||
.pipe(gulp.dest('npm/poly'));
|
.pipe(gulp.dest('npm/poly'));
|
||||||
|
|
||||||
gulp.src(['src/plugin/trad/*.json', 'README.md', 'LICENSE'])
|
gulp.src(['src/plugin/trad/*.json', 'LICENSE'])
|
||||||
.pipe(gulp.dest('npm/trad'));
|
.pipe(gulp.dest('npm/trad'));
|
||||||
|
|
||||||
|
gulp.src(['src/plugin/draw/*.json', 'src/plugin/draw/index.d.ts', 'LICENSE'])
|
||||||
|
.pipe(gulp.dest('npm/draw'));
|
||||||
|
|
||||||
gulp.src(['src/main/index.d.ts', 'LICENSE'])
|
gulp.src(['src/main/index.d.ts', 'LICENSE'])
|
||||||
.pipe(gulp.dest('npm/all'))
|
.pipe(gulp.dest('npm/all'))
|
||||||
.pipe(gulp.dest('npm/hanzi-util'))
|
.pipe(gulp.dest('npm/hanzi-util'))
|
||||||
|
@ -87,13 +100,13 @@ function copyLatest () {
|
||||||
// });
|
// });
|
||||||
gulp.src(`npm/all/cnchar.all.min.js`)
|
gulp.src(`npm/all/cnchar.all.min.js`)
|
||||||
.pipe(rename(function (path) {
|
.pipe(rename(function (path) {
|
||||||
path.basename = path.basename.replace('cnchar.all.min.js', 'hanzi.util.min.js');
|
path.basename = path.basename.replace('cnchar.all.min', 'hanzi.util.min');
|
||||||
return path;
|
return path;
|
||||||
}))
|
}))
|
||||||
.pipe(gulp.dest('npm/hanzi-util'));
|
.pipe(gulp.dest('npm/hanzi-util'));
|
||||||
gulp.src(`npm/cnchar/cnchar.min.js`)
|
gulp.src(`npm/cnchar/cnchar.min.js`)
|
||||||
.pipe(rename(function (path) {
|
.pipe(rename(function (path) {
|
||||||
path.basename = path.basename.replace('cnchar.min.js', 'hanzi.util.base.min.js');
|
path.basename = path.basename.replace('cnchar.min', 'hanzi.base.min');
|
||||||
return path;
|
return path;
|
||||||
}))
|
}))
|
||||||
.pipe(gulp.dest('npm/hanzi-util-base'));
|
.pipe(gulp.dest('npm/hanzi-util-base'));
|
||||||
|
@ -114,7 +127,7 @@ function transEs6ByBabel () {
|
||||||
gulp.src('src/plugin/trad/*.js')
|
gulp.src('src/plugin/trad/*.js')
|
||||||
.pipe(babel({presets: ['@babel/env']}))
|
.pipe(babel({presets: ['@babel/env']}))
|
||||||
.pipe(gulp.dest('npm/trad'));
|
.pipe(gulp.dest('npm/trad'));
|
||||||
|
|
||||||
gulp.src('src/plugin/all/*.js')
|
gulp.src('src/plugin/all/*.js')
|
||||||
.pipe(babel({presets: ['@babel/env']}))
|
.pipe(babel({presets: ['@babel/env']}))
|
||||||
.pipe(gulp.dest('npm/all'));
|
.pipe(gulp.dest('npm/all'));
|
||||||
|
|
|
@ -60,4 +60,5 @@
|
||||||
### 2.1.0
|
### 2.1.0
|
||||||
1. 增加cnchar-draw插件,支持可视化绘制汉字笔画,多种模式可选
|
1. 增加cnchar-draw插件,支持可视化绘制汉字笔画,多种模式可选
|
||||||
2. 将cdn移至npm包中,改变cdn引用方式,删除dist目录
|
2. 将cdn移至npm包中,改变cdn引用方式,删除dist目录
|
||||||
3. 使用vuepress构建文档,工程化重构文档
|
3. 使用vuepress构建文档,工程化重构文档
|
||||||
|
4. 使用gulp-markdown-toc
|
File diff suppressed because one or more lines are too long
|
@ -1,3 +1,6 @@
|
||||||
|
import {Draw} from 'cnchar-draw';
|
||||||
|
// import {Draw} from 'cnchar-draw';
|
||||||
|
|
||||||
declare type spellArg = 'array' | 'low' | 'up' | 'first' | 'poly' | 'tone' | 'simple';
|
declare type spellArg = 'array' | 'low' | 'up' | 'first' | 'poly' | 'tone' | 'simple';
|
||||||
declare type strokeArg = 'letter' | 'shape' | 'count' | 'name' | 'detail' | 'array' | 'order' | 'simple';
|
declare type strokeArg = 'letter' | 'shape' | 'count' | 'name' | 'detail' | 'array' | 'order' | 'simple';
|
||||||
declare type orderToWordArg = 'match' | 'matchorder' | 'contain' | 'start' | 'simple' | 'array';
|
declare type orderToWordArg = 'match' | 'matchorder' | 'contain' | 'start' | 'simple' | 'array';
|
||||||
|
@ -17,6 +20,7 @@ declare interface spellInfoReturnStatic {
|
||||||
declare interface CnCharStatic {
|
declare interface CnCharStatic {
|
||||||
spell(sentence: string, ...args: Array<spellArg>): string | Array<any>;
|
spell(sentence: string, ...args: Array<spellArg>): string | Array<any>;
|
||||||
stroke(sentence: string, ...args: Array<strokeArg>): number | Array<any>;
|
stroke(sentence: string, ...args: Array<strokeArg>): number | Array<any>;
|
||||||
|
draw?: Draw;
|
||||||
use(...plugins: Array<Function>): void;
|
use(...plugins: Array<Function>): void;
|
||||||
orderToWord: {
|
orderToWord: {
|
||||||
(orders: string | Array<orderName>, ...args: Array<orderToWordArg>): string | Array<string>;
|
(orders: string | Array<orderName>, ...args: Array<orderToWordArg>): string | Array<string>;
|
||||||
|
|
|
@ -1,7 +1,14 @@
|
||||||
var cnchar = require('cnchar');
|
"use strict";
|
||||||
var order = require('cnchar-order');
|
|
||||||
var trad = require('cnchar-trad');
|
var cnchar = require('../../main');
|
||||||
var poly = require('cnchar-poly');
|
|
||||||
var draw = require('cnchar-draw');
|
var order = require('../order');
|
||||||
|
|
||||||
|
var trad = require('../trad');
|
||||||
|
|
||||||
|
var poly = require('../poly');
|
||||||
|
|
||||||
|
var draw = require('../draw');
|
||||||
|
|
||||||
cnchar.use(order, trad, poly, draw);
|
cnchar.use(order, trad, poly, draw);
|
||||||
module.exports = cnchar;
|
module.exports = cnchar;
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "cnchar-all",
|
"name": "cnchar-all",
|
||||||
"version": "2.0.9",
|
"version": "2.1.0",
|
||||||
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"unpkg": "cnchar.all.min.js",
|
"unpkg": "cnchar.all.min.js",
|
||||||
|
@ -27,10 +27,10 @@
|
||||||
},
|
},
|
||||||
"homepage": "https://www.theajack.com/cnchar/",
|
"homepage": "https://www.theajack.com/cnchar/",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"cnchar": "^2.0.9",
|
"cnchar": "^2.1.0",
|
||||||
"cnchar-order": "^2.0.9",
|
"cnchar-order": "^2.1.0",
|
||||||
"cnchar-poly": "^2.0.9",
|
"cnchar-poly": "^2.1.0",
|
||||||
"cnchar-trad": "^2.0.9",
|
"cnchar-trad": "^2.1.0",
|
||||||
"cnchar-draw": "^2.0.9"
|
"cnchar-draw": "^2.1.0"
|
||||||
}
|
}
|
||||||
}
|
}
|
|
@ -1,22 +1,76 @@
|
||||||
# [cnchar](https://github.com/theajack/cnchar)
|
# [cnchar](https://github.com/theajack/cnchar) <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/github/stars/theajack/cnchar.svg?style=social" alt="star"></a> <a href="https://theajack.gitee.io"><img src="https://img.shields.io/badge/author-theajack-blue.svg?style=social" alt="Author"></a>
|
||||||
|
|
||||||
#### [theajack](https://www.theajack.com/)
|
|
||||||
|
<p>
|
||||||
|
<a href="https://www.npmjs.com/package/cnchar"><img src="https://img.shields.io/npm/v/cnchar.svg" alt="Version"></a>
|
||||||
|
<a href="https://npmcharts.com/compare/cnchar?minimal=true"><img src="https://img.shields.io/npm/dm/cnchar.svg" alt="Downloads"></a>
|
||||||
|
<a href="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"><img src="https://img.shields.io/bundlephobia/minzip/cnchar.svg" alt="Size"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/cnchar.svg" alt="License"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/search?l=javascript"><img src="https://img.shields.io/github/languages/top/theajack/cnchar.svg" alt="TopLang"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/issues"><img src="https://img.shields.io/github/issues-closed/theajack/cnchar.svg" alt="issue"></a>
|
||||||
|
<!-- <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/librariesio/dependent-repos/npm/cnchar.svg" alt="Dependent"></a> -->
|
||||||
|
</p>
|
||||||
|
|
||||||
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
||||||
|
|
||||||
**<a href="#64-使用实例大全">快速上手</a> | [在线试用](https://www.theajack.com/cnchar/) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://www.theajack.com/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/8)**
|
**<a href="#66-使用实例大全">快速上手</a> | [在线试用/文档](https://theajack.gitee.io/cnchar) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://theajack.gitee.io/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/new)**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
[TOC]
|
<!-- toc -->
|
||||||
|
|
||||||
|
- [前言](#%E5%89%8D%E8%A8%80)
|
||||||
|
- [0.快速使用](#0%E5%BF%AB%E9%80%9F%E4%BD%BF%E7%94%A8)
|
||||||
|
- [1.功能](#1%E5%8A%9F%E8%83%BD)
|
||||||
|
- [2.概览](#2%E6%A6%82%E8%A7%88)
|
||||||
|
- [3 安装](#3-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.1 使用 npm 安装](#31-%E4%BD%BF%E7%94%A8-npm-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.2 使用 script 引入](#32-%E4%BD%BF%E7%94%A8-script-%E5%BC%95%E5%85%A5)
|
||||||
|
- [4 使用](#4-%E4%BD%BF%E7%94%A8)
|
||||||
|
* [4.1 webpack浏览器环境(有window对象)](#41-webpack%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83%E6%9C%89window%E5%AF%B9%E8%B1%A1)
|
||||||
|
* [4.2 nodejs 等非浏览器环境](#42-nodejs-%E7%AD%89%E9%9D%9E%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
* [4.3 原生浏览器环境](#43-%E5%8E%9F%E7%94%9F%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
- [5 API](#5-api)
|
||||||
|
* [5.1 拼音笔画基础 API: spell & stroke](#51-%E6%8B%BC%E9%9F%B3%E7%AC%94%E7%94%BB%E5%9F%BA%E7%A1%80-api-spell--stroke)
|
||||||
|
* [5.2 可视化绘制汉字: draw](#52-%E5%8F%AF%E8%A7%86%E5%8C%96%E7%BB%98%E5%88%B6%E6%B1%89%E5%AD%97-draw)
|
||||||
|
+ [5.2.1 使用](#521-%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [5.2.2 参数](#522-%E5%8F%82%E6%95%B0)
|
||||||
|
* [5.3 繁体、简体、火星文互转: convert](#53-%E7%B9%81%E4%BD%93%E7%AE%80%E4%BD%93%E7%81%AB%E6%98%9F%E6%96%87%E4%BA%92%E8%BD%AC-convert)
|
||||||
|
* [5.4 笔画序列推出原汉字: orderToWord](#54-%E7%AC%94%E7%94%BB%E5%BA%8F%E5%88%97%E6%8E%A8%E5%87%BA%E5%8E%9F%E6%B1%89%E5%AD%97-ordertoword)
|
||||||
|
* [5.5 通过拼音查询原汉字: spellToWord](#55-%E9%80%9A%E8%BF%87%E6%8B%BC%E9%9F%B3%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-spelltoword)
|
||||||
|
* [5.6 通过笔画数查询原汉字: strokeToWord](#56-%E9%80%9A%E8%BF%87%E7%AC%94%E7%94%BB%E6%95%B0%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-stroketoword)
|
||||||
|
* [5.7 查询拼音详细信息: spellInfo](#57-%E6%9F%A5%E8%AF%A2%E6%8B%BC%E9%9F%B3%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF-spellinfo)
|
||||||
|
* [5.8 其他 api](#58-%E5%85%B6%E4%BB%96-api)
|
||||||
|
+ [5.8.1 .use()](#581-use)
|
||||||
|
+ [5.8.2 .type](#582-type)
|
||||||
|
+ [5.8.3 .check](#583-check)
|
||||||
|
+ [5.8.4 .version](#584-version)
|
||||||
|
+ [5.8.5 .plugins](#585-plugins)
|
||||||
|
- [6 spell stroke 参数](#6-spell-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.1 spell 参数](#61-spell-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.2 stroke 参数](#62-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.3 orderToWord 参数](#63-ordertoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.4 spellToWord 参数](#64-spelltoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.5 strokeToWord 参数](#65-stroketoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.6 使用实例大全:](#66-%E4%BD%BF%E7%94%A8%E5%AE%9E%E4%BE%8B%E5%A4%A7%E5%85%A8)
|
||||||
|
+ [6.6.0 安装使用](#660-%E5%AE%89%E8%A3%85%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [6.6.1 cnchar 基础库功能](#661-cnchar-%E5%9F%BA%E7%A1%80%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.2 cnchar-poly 库功能](#662-cnchar-poly-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.3 cnchar-order 库功能](#663-cnchar-order-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.4 cnchar-trad 库功能](#664-cnchar-trad-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
- [6.6.4.1 convert 字体转换](#6641-convert-%E5%AD%97%E4%BD%93%E8%BD%AC%E6%8D%A2)
|
||||||
|
- [6.6.4.2 spell 和 stroke 方法](#6642-spell-%E5%92%8C-stroke-%E6%96%B9%E6%B3%95)
|
||||||
|
- [7 应用例子](#7-%E5%BA%94%E7%94%A8%E4%BE%8B%E5%AD%90)
|
||||||
|
|
||||||
|
<!-- tocstop -->
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### 前言
|
### 前言
|
||||||
|
|
||||||
感谢同学们对于 cnchar 的支持,由于 cnchar 词库来源于网络,虽然经过了本人的修改的扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 [反馈](https://github.com/theajack/cnchar/issues/8) 给我(或自行修改提交,经过审查无误过后会合到 cnchar 中)
|
感谢同学们对于 cnchar 的支持,由于 cnchar 词库来源于网络,虽然经过了本人的修改和扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 [反馈](https://github.com/theajack/cnchar/issues/new) 给我(或自行修改提交,经过审查无误过后会合到 cnchar 中)
|
||||||
|
|
||||||
[我要反馈错误或缺漏](https://github.com/theajack/cnchar/issues/8)
|
[我要反馈错误或缺漏](https://github.com/theajack/cnchar/issues/new)
|
||||||
|
|
||||||
### 0.快速使用
|
### 0.快速使用
|
||||||
|
|
||||||
|
@ -35,18 +89,14 @@ import cnchar from 'cnchar';
|
||||||
使用 script 标签使用:
|
使用 script 标签使用:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<!--
|
|
||||||
或通过版本号引用
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
-->
|
|
||||||
<script>
|
<script>
|
||||||
'汉字'.spell();
|
'汉字'.spell();
|
||||||
'汉字'.stroke();
|
'汉字'.stroke();
|
||||||
</script>
|
</script>
|
||||||
```
|
```
|
||||||
|
|
||||||
<a href="#64-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
<a href="#66-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
||||||
|
|
||||||
### 1.功能
|
### 1.功能
|
||||||
|
|
||||||
|
@ -54,15 +104,18 @@ import cnchar from 'cnchar';
|
||||||
2. 支持 **多音词**
|
2. 支持 **多音词**
|
||||||
3. 支持 **拼音音调**
|
3. 支持 **拼音音调**
|
||||||
4. 获取汉字 **笔画数** 、支持数组分割
|
4. 获取汉字 **笔画数** 、支持数组分割
|
||||||
5. 获取汉字 **笔画顺序** 、笔画详细名称、通过笔画顺序推出原汉字等
|
5. 获取汉字 **笔画顺序** 、笔画详细名称
|
||||||
6. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
6. 支持可视化 **绘制汉字笔画** 、多种绘制模式可选
|
||||||
7. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
7. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
||||||
8. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
8. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
||||||
9. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
9. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
||||||
10. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
10. 支持 **根据笔画顺序查询** 汉字
|
||||||
11. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
11. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
||||||
12. **多端可用**,可用于 原生浏览器环境、webpack 环境、nodejs 环境...,几乎支持所有 js 能运行的环境
|
12. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
||||||
13. 丰富的配置,按需取用
|
13. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
||||||
|
14. **多端可用**,可用于 **浏览器、nodejs、小程序/小游戏、ReactNative/Weex/Uniapp/Electron、webpack**...,支持所有 js 能运行的环境
|
||||||
|
15. **typescript支持**,支持在typescript中调用
|
||||||
|
16. 丰富的配置,按需取用
|
||||||
|
|
||||||
### 2.概览
|
### 2.概览
|
||||||
|
|
||||||
|
@ -74,6 +127,7 @@ import cnchar from 'cnchar';
|
||||||
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
||||||
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
||||||
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
||||||
|
| cnchar-draw | 绘制笔画库 | 指出可视化绘制汉字,有 normal,animation,stroke,test 四种模式可选,该库仅在浏览器环境下可用 |
|
||||||
|
|
||||||
### 3 安装
|
### 3 安装
|
||||||
|
|
||||||
|
@ -88,7 +142,7 @@ npm i cnchar
|
||||||
安装附加功能库:
|
安装附加功能库:
|
||||||
|
|
||||||
```
|
```
|
||||||
npm i cnchar-poly cnchar-order cnchar-trad
|
npm i cnchar-poly cnchar-order cnchar-trad cnchar-draw
|
||||||
```
|
```
|
||||||
|
|
||||||
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
||||||
|
@ -102,20 +156,23 @@ npm i cnchar-all
|
||||||
#### 3.2 使用 script 引入
|
#### 3.2 使用 script 引入
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
<!-- 或使用版本号引用 -->
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.{version}.min.js"></script>
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
或使用以下cdn,包含了以上五个库
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-all/cnchar.all.min.js"></script>
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
### 4 使用
|
### 4 使用
|
||||||
|
|
||||||
#### 4.1 webpack、babel 等浏览器环境
|
#### 4.1 webpack浏览器环境(有window对象)
|
||||||
|
|
||||||
npm 安装好几个库之后:
|
npm 安装好几个库之后:
|
||||||
|
|
||||||
|
@ -125,6 +182,8 @@ import cnchar from 'cnchar';
|
||||||
import 'cnchar-poly';
|
import 'cnchar-poly';
|
||||||
import 'cnchar-order';
|
import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
|
import 'cnchar-draw';
|
||||||
|
// 插件请按需取用
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -142,6 +201,8 @@ var cnchar = require('cnchar');
|
||||||
var poly = require('cnchar-poly');
|
var poly = require('cnchar-poly');
|
||||||
var order = require('cnchar-order');
|
var order = require('cnchar-order');
|
||||||
var trad = require('cnchar-trad');
|
var trad = require('cnchar-trad');
|
||||||
|
// 插件请按需取用
|
||||||
|
// cnchar-draw 在非浏览器环境下不可使用
|
||||||
cnchar.use(poly, order, trad);
|
cnchar.use(poly, order, trad);
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
|
@ -155,10 +216,11 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script>
|
<script>
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -167,6 +229,8 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
|
||||||
### 5 API
|
### 5 API
|
||||||
|
|
||||||
|
类型声明:[cnchar.d.ts](https://github.com/theajack/cnchar/blob/master/src/main/index.d.ts)
|
||||||
|
|
||||||
#### 5.1 拼音笔画基础 API: spell & stroke
|
#### 5.1 拼音笔画基础 API: spell & stroke
|
||||||
|
|
||||||
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
||||||
|
@ -187,7 +251,93 @@ string.stroke([...args])
|
||||||
|
|
||||||
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
||||||
|
|
||||||
#### 5.2 繁体、简体、火星文互转: convert
|
#### 5.2 可视化绘制汉字: draw
|
||||||
|
|
||||||
|
类型声明:[cnchar.draw.d.ts](https://github.com/theajack/cnchar/blob/master/src/plugin/draw/index.d.ts)
|
||||||
|
|
||||||
|
`cnchar-draw` 库用于支持在浏览器环境下可视化绘制汉字,所以该库仅在浏览器环境下可用。
|
||||||
|
|
||||||
|
##### 5.2.1 使用
|
||||||
|
|
||||||
|
使用方式如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.draw('你好', options); // options 为可选参数, 在5.2.2 种会详细介绍
|
||||||
|
```
|
||||||
|
|
||||||
|
运行结果如下:
|
||||||
|
|
||||||
|
![draw.jpg](https://cdn.jsdelivr.net/gh/theajack/cnchar/assets/readme/draw.jpg)
|
||||||
|
|
||||||
|
该库支持脱离cnchar 独立使用
|
||||||
|
|
||||||
|
```js
|
||||||
|
import draw from 'cnchar-draw';
|
||||||
|
draw('你好')
|
||||||
|
```
|
||||||
|
|
||||||
|
使用cdn引用时,会在window对向上暴露 `CncharDraw` 对象
|
||||||
|
|
||||||
|
##### 5.2.2 参数
|
||||||
|
|
||||||
|
draw 的参数比较繁多,首先需要理解的是,draw 分为四种绘制模式:
|
||||||
|
|
||||||
|
1. normal: 常规绘制
|
||||||
|
2. animation: 带有绘制动画,支持连续绘制、同时绘制、循环绘制
|
||||||
|
3. stroke: 按汉字笔顺单步绘制
|
||||||
|
4. test: 测试模式,用户可以在容器内绘制汉字,cnchar-draw会检测是否绘制正确
|
||||||
|
|
||||||
|
以下是 options 的所有可选参数及描述,使用详情请参考[在线文档](https://theajack.gitee.io/cnchar):
|
||||||
|
|
||||||
|
```ts
|
||||||
|
declare interface DrawOption {
|
||||||
|
el?: string | HTMLElement; // 绘制的容器,支持id和dom,若是不填,会在body后append一个dom作为容器
|
||||||
|
type?: DrawType; // 绘制模式,默认为normal
|
||||||
|
style?: { // 样式类
|
||||||
|
showOutline?: boolean;//: true,
|
||||||
|
showCharacter?: boolean;//: true,
|
||||||
|
currentColor?: string;//: '#b44', // 仅在stroke模式下有效
|
||||||
|
length?: number;//: 60,
|
||||||
|
padding?: number;//: 5, // 数值, 默认 20。 画布的汉字和边缘之间的填充
|
||||||
|
outlineColor?: string;//: '#ddd', // 十六进制字符, 默认 '#DDD'。
|
||||||
|
strokeColor?: string;//: '#555', // 十六进制字符, 默认 '#555'。绘制每个笔划的颜色。
|
||||||
|
radicalColor?: string;//: null, // 十六进制字符, 默认 null。 如果存在偏旁部首数据,则在笔划中绘制偏旁部首的颜色。 如果没有设置,激光将绘制与其他笔划相同的颜色。
|
||||||
|
strokeFadeDuration?: number; //400
|
||||||
|
},
|
||||||
|
line?: { // 背景线条类
|
||||||
|
lineStraight?: boolean;// : true,
|
||||||
|
lineCross?: boolean;// : true,
|
||||||
|
lineWidth?: number;// : 1,
|
||||||
|
lineColor?: string;// : '#ddd',
|
||||||
|
lineDash?: boolean;// : true,
|
||||||
|
border?: boolean;// : true,
|
||||||
|
borderWidth?: number;// : 1,
|
||||||
|
borderColor?: string;// : '#ccc',
|
||||||
|
borderDash?: boolean;// : false,
|
||||||
|
},
|
||||||
|
animation?: {
|
||||||
|
strokeAnimationSpeed?: number;// : 1, // 数值, 默认 1。 绘制每个笔划的速度必须大于0。增加此数字可以更快地绘制笔划,减少绘制笔划的速度更慢。
|
||||||
|
delayBetweenStrokes?: number;// : 1000, // 数值, 默认 1000。 动画进行中每个笔画之间的间隔时间(以毫秒为单位)。
|
||||||
|
delayBetweenLoops?: number;// : 200, // 数值, 默认 2000。 循环动画时每个动画循环之间的时间(以毫秒为单位)。
|
||||||
|
autoAnimate?: boolean;// : true,
|
||||||
|
animateComplete?: Function;// : () => {},
|
||||||
|
stepByStep?: boolean;// : true,
|
||||||
|
loopAnimate?: boolean;// : false,
|
||||||
|
},
|
||||||
|
test?: {
|
||||||
|
strokeHighlightSpeed?: number;// : 20, // 数值, 默认 20。 在测验中给出提示时突出显示每个笔划的速度必须大于0。增加此数字以突出显示更快,减少以突出显示更慢。
|
||||||
|
highlightColor?: number;// : '#aaf', // 十六进制字符, 默认 '#AAF'。 用于在测验中突出显示的颜色。
|
||||||
|
drawingColor?: number;// : '#333', // 十六进制字符, 默认 '#333'。 测验期间绘制的线条颜色。
|
||||||
|
drawingWidth?: number;// : 4, // 数值, 默认 4。 进行测验时绘制的线条宽度。
|
||||||
|
showHintAfterMisses?: number;// : 3, // 整数, 默认 3 中风高亮提示之前的未命中数被给予用户。 设置为 false 以禁用。 创建测验时也可以设置此项。
|
||||||
|
highlightOnComplete?: number;// : true, // 布尔值, 默认 true。 控制当用户完成绘制整个字符时,测验是否会短暂突出显示字符。 创建测验时也可以设置此项。
|
||||||
|
highlightCompleteColor?: number;// : null, // 十六进制字符, 默认 null。 在测验中突出显示字符时使用的颜色。 如果未设置,则将使用highlightColor。 仅当highlightOnComplete为true时才相关。
|
||||||
|
onTestStatus?(args: TestStatus):void;// : null, // ({index, status, data})=>{}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.3 繁体、简体、火星文互转: convert
|
||||||
|
|
||||||
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
||||||
|
|
||||||
|
@ -209,7 +359,7 @@ string.convertSparkToSimple();
|
||||||
string.convertSparkToTrad();
|
string.convertSparkToTrad();
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.3 笔画序列推出原汉字: orderToWord
|
#### 5.4 笔画序列推出原汉字: orderToWord
|
||||||
|
|
||||||
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
||||||
|
|
||||||
|
@ -284,7 +434,7 @@ cnchar.orderToWord(['横', '撇', '捺'], 'start', 'simple');
|
||||||
|
|
||||||
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
||||||
|
|
||||||
#### 5.4 通过拼音查询原汉字: spellToWord
|
#### 5.5 通过拼音查询原汉字: spellToWord
|
||||||
|
|
||||||
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -308,7 +458,7 @@ spell 表示拼音,可以使用音调字母或音调数标方式:
|
||||||
|
|
||||||
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
||||||
|
|
||||||
#### 5.5 通过笔画数查询原汉字: strokeToWord
|
#### 5.6 通过笔画数查询原汉字: strokeToWord
|
||||||
|
|
||||||
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -324,7 +474,7 @@ cnchar.strokeToWord(25, 'simple'); // 返回 '鬣馕囔戆攮纛'
|
||||||
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.6 查询拼音详细信息: spellInfo
|
#### 5.7 查询拼音详细信息: spellInfo
|
||||||
|
|
||||||
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
||||||
|
|
||||||
|
@ -358,9 +508,9 @@ cnchar.spellInfo.tones;
|
||||||
// n 的一声使用 * 代替
|
// n 的一声使用 * 代替
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.7 其他 api
|
#### 5.8 其他 api
|
||||||
|
|
||||||
##### 5.7.1 .use()
|
##### 5.8.1 .use()
|
||||||
|
|
||||||
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
||||||
|
|
||||||
|
@ -389,7 +539,7 @@ import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.2 .type
|
##### 5.8.2 .type
|
||||||
|
|
||||||
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
||||||
|
|
||||||
|
@ -413,7 +563,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
|
|
||||||
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
||||||
|
|
||||||
##### 5.7.3 .check
|
##### 5.8.3 .check
|
||||||
|
|
||||||
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
||||||
|
|
||||||
|
@ -423,7 +573,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
cnchar.check = false; // 关闭参数校验
|
cnchar.check = false; // 关闭参数校验
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.4 .version
|
##### 5.8.4 .version
|
||||||
|
|
||||||
获取当前版本:
|
获取当前版本:
|
||||||
|
|
||||||
|
@ -431,7 +581,7 @@ cnchar.check = false; // 关闭参数校验
|
||||||
var version = cnchar.version; // string 类型
|
var version = cnchar.version; // string 类型
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.5 .plugins
|
##### 5.8.5 .plugins
|
||||||
|
|
||||||
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
||||||
|
|
||||||
|
@ -567,7 +717,7 @@ import cnchar from 'cnchar';
|
||||||
script 标签引用 方式
|
script 标签引用 方式
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"></script>
|
||||||
<script>
|
<script>
|
||||||
// do something
|
// do something
|
||||||
</script>
|
</script>
|
||||||
|
@ -723,3 +873,7 @@ cnchar.convert.sparkToTrad('①个亾');
|
||||||
### 7 应用例子
|
### 7 应用例子
|
||||||
|
|
||||||
[汉字打字游戏](https://www.theajack.com/type/)
|
[汉字打字游戏](https://www.theajack.com/type/)
|
||||||
|
|
||||||
|
**致谢**
|
||||||
|
|
||||||
|
`cnchar-draw` 库功能基于 [hanzi-writer](https://github.com/chanind/hanzi-writer), 特此表示感谢!
|
||||||
|
|
File diff suppressed because one or more lines are too long
|
@ -1,3 +1,6 @@
|
||||||
|
import {Draw} from 'cnchar-draw';
|
||||||
|
// import {Draw} from 'cnchar-draw';
|
||||||
|
|
||||||
declare type spellArg = 'array' | 'low' | 'up' | 'first' | 'poly' | 'tone' | 'simple';
|
declare type spellArg = 'array' | 'low' | 'up' | 'first' | 'poly' | 'tone' | 'simple';
|
||||||
declare type strokeArg = 'letter' | 'shape' | 'count' | 'name' | 'detail' | 'array' | 'order' | 'simple';
|
declare type strokeArg = 'letter' | 'shape' | 'count' | 'name' | 'detail' | 'array' | 'order' | 'simple';
|
||||||
declare type orderToWordArg = 'match' | 'matchorder' | 'contain' | 'start' | 'simple' | 'array';
|
declare type orderToWordArg = 'match' | 'matchorder' | 'contain' | 'start' | 'simple' | 'array';
|
||||||
|
@ -17,6 +20,7 @@ declare interface spellInfoReturnStatic {
|
||||||
declare interface CnCharStatic {
|
declare interface CnCharStatic {
|
||||||
spell(sentence: string, ...args: Array<spellArg>): string | Array<any>;
|
spell(sentence: string, ...args: Array<spellArg>): string | Array<any>;
|
||||||
stroke(sentence: string, ...args: Array<strokeArg>): number | Array<any>;
|
stroke(sentence: string, ...args: Array<strokeArg>): number | Array<any>;
|
||||||
|
draw?: Draw;
|
||||||
use(...plugins: Array<Function>): void;
|
use(...plugins: Array<Function>): void;
|
||||||
orderToWord: {
|
orderToWord: {
|
||||||
(orders: string | Array<orderName>, ...args: Array<orderToWordArg>): string | Array<string>;
|
(orders: string | Array<orderName>, ...args: Array<orderToWordArg>): string | Array<string>;
|
||||||
|
|
|
@ -64,7 +64,11 @@ function use() {
|
||||||
|
|
||||||
plugins.forEach(function (f) {
|
plugins.forEach(function (f) {
|
||||||
if (typeof f === 'function') {
|
if (typeof f === 'function') {
|
||||||
f(cnchar);
|
if (typeof f.init === 'function') {
|
||||||
|
f.init(cnchar);
|
||||||
|
} else {
|
||||||
|
f(cnchar);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "cnchar",
|
"name": "cnchar",
|
||||||
"version": "2.0.9",
|
"version": "2.1.0",
|
||||||
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"scripts": {},
|
"scripts": {},
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
"use strict";
|
"use strict";
|
||||||
|
|
||||||
function _typeof(obj) { if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
|
function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
|
||||||
|
|
||||||
var tones = 'āáǎàōóǒòēéěèīíǐìūúǔùǖǘǚǜ*ńňǹ'; // * 表示n的一声
|
var tones = 'āáǎàōóǒòēéěèīíǐìūúǔùǖǘǚǜ*ńňǹ'; // * 表示n的一声
|
||||||
|
|
||||||
|
|
|
@ -1,3 +1,3 @@
|
||||||
"use strict";
|
"use strict";
|
||||||
|
|
||||||
module.exports = '2.0.9';
|
module.exports = '2.1.0';
|
|
@ -1,22 +1,76 @@
|
||||||
# [cnchar](https://github.com/theajack/cnchar)
|
# [cnchar](https://github.com/theajack/cnchar) <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/github/stars/theajack/cnchar.svg?style=social" alt="star"></a> <a href="https://theajack.gitee.io"><img src="https://img.shields.io/badge/author-theajack-blue.svg?style=social" alt="Author"></a>
|
||||||
|
|
||||||
#### [theajack](https://www.theajack.com/)
|
|
||||||
|
<p>
|
||||||
|
<a href="https://www.npmjs.com/package/cnchar"><img src="https://img.shields.io/npm/v/cnchar.svg" alt="Version"></a>
|
||||||
|
<a href="https://npmcharts.com/compare/cnchar?minimal=true"><img src="https://img.shields.io/npm/dm/cnchar.svg" alt="Downloads"></a>
|
||||||
|
<a href="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"><img src="https://img.shields.io/bundlephobia/minzip/cnchar.svg" alt="Size"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/cnchar.svg" alt="License"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/search?l=javascript"><img src="https://img.shields.io/github/languages/top/theajack/cnchar.svg" alt="TopLang"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/issues"><img src="https://img.shields.io/github/issues-closed/theajack/cnchar.svg" alt="issue"></a>
|
||||||
|
<!-- <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/librariesio/dependent-repos/npm/cnchar.svg" alt="Dependent"></a> -->
|
||||||
|
</p>
|
||||||
|
|
||||||
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
||||||
|
|
||||||
**<a href="#64-使用实例大全">快速上手</a> | [在线试用](https://www.theajack.com/cnchar/) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://www.theajack.com/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/8)**
|
**<a href="#66-使用实例大全">快速上手</a> | [在线试用/文档](https://theajack.gitee.io/cnchar) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://theajack.gitee.io/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/new)**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
[TOC]
|
<!-- toc -->
|
||||||
|
|
||||||
|
- [前言](#%E5%89%8D%E8%A8%80)
|
||||||
|
- [0.快速使用](#0%E5%BF%AB%E9%80%9F%E4%BD%BF%E7%94%A8)
|
||||||
|
- [1.功能](#1%E5%8A%9F%E8%83%BD)
|
||||||
|
- [2.概览](#2%E6%A6%82%E8%A7%88)
|
||||||
|
- [3 安装](#3-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.1 使用 npm 安装](#31-%E4%BD%BF%E7%94%A8-npm-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.2 使用 script 引入](#32-%E4%BD%BF%E7%94%A8-script-%E5%BC%95%E5%85%A5)
|
||||||
|
- [4 使用](#4-%E4%BD%BF%E7%94%A8)
|
||||||
|
* [4.1 webpack浏览器环境(有window对象)](#41-webpack%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83%E6%9C%89window%E5%AF%B9%E8%B1%A1)
|
||||||
|
* [4.2 nodejs 等非浏览器环境](#42-nodejs-%E7%AD%89%E9%9D%9E%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
* [4.3 原生浏览器环境](#43-%E5%8E%9F%E7%94%9F%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
- [5 API](#5-api)
|
||||||
|
* [5.1 拼音笔画基础 API: spell & stroke](#51-%E6%8B%BC%E9%9F%B3%E7%AC%94%E7%94%BB%E5%9F%BA%E7%A1%80-api-spell--stroke)
|
||||||
|
* [5.2 可视化绘制汉字: draw](#52-%E5%8F%AF%E8%A7%86%E5%8C%96%E7%BB%98%E5%88%B6%E6%B1%89%E5%AD%97-draw)
|
||||||
|
+ [5.2.1 使用](#521-%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [5.2.2 参数](#522-%E5%8F%82%E6%95%B0)
|
||||||
|
* [5.3 繁体、简体、火星文互转: convert](#53-%E7%B9%81%E4%BD%93%E7%AE%80%E4%BD%93%E7%81%AB%E6%98%9F%E6%96%87%E4%BA%92%E8%BD%AC-convert)
|
||||||
|
* [5.4 笔画序列推出原汉字: orderToWord](#54-%E7%AC%94%E7%94%BB%E5%BA%8F%E5%88%97%E6%8E%A8%E5%87%BA%E5%8E%9F%E6%B1%89%E5%AD%97-ordertoword)
|
||||||
|
* [5.5 通过拼音查询原汉字: spellToWord](#55-%E9%80%9A%E8%BF%87%E6%8B%BC%E9%9F%B3%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-spelltoword)
|
||||||
|
* [5.6 通过笔画数查询原汉字: strokeToWord](#56-%E9%80%9A%E8%BF%87%E7%AC%94%E7%94%BB%E6%95%B0%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-stroketoword)
|
||||||
|
* [5.7 查询拼音详细信息: spellInfo](#57-%E6%9F%A5%E8%AF%A2%E6%8B%BC%E9%9F%B3%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF-spellinfo)
|
||||||
|
* [5.8 其他 api](#58-%E5%85%B6%E4%BB%96-api)
|
||||||
|
+ [5.8.1 .use()](#581-use)
|
||||||
|
+ [5.8.2 .type](#582-type)
|
||||||
|
+ [5.8.3 .check](#583-check)
|
||||||
|
+ [5.8.4 .version](#584-version)
|
||||||
|
+ [5.8.5 .plugins](#585-plugins)
|
||||||
|
- [6 spell stroke 参数](#6-spell-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.1 spell 参数](#61-spell-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.2 stroke 参数](#62-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.3 orderToWord 参数](#63-ordertoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.4 spellToWord 参数](#64-spelltoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.5 strokeToWord 参数](#65-stroketoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.6 使用实例大全:](#66-%E4%BD%BF%E7%94%A8%E5%AE%9E%E4%BE%8B%E5%A4%A7%E5%85%A8)
|
||||||
|
+ [6.6.0 安装使用](#660-%E5%AE%89%E8%A3%85%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [6.6.1 cnchar 基础库功能](#661-cnchar-%E5%9F%BA%E7%A1%80%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.2 cnchar-poly 库功能](#662-cnchar-poly-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.3 cnchar-order 库功能](#663-cnchar-order-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.4 cnchar-trad 库功能](#664-cnchar-trad-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
- [6.6.4.1 convert 字体转换](#6641-convert-%E5%AD%97%E4%BD%93%E8%BD%AC%E6%8D%A2)
|
||||||
|
- [6.6.4.2 spell 和 stroke 方法](#6642-spell-%E5%92%8C-stroke-%E6%96%B9%E6%B3%95)
|
||||||
|
- [7 应用例子](#7-%E5%BA%94%E7%94%A8%E4%BE%8B%E5%AD%90)
|
||||||
|
|
||||||
|
<!-- tocstop -->
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### 前言
|
### 前言
|
||||||
|
|
||||||
感谢同学们对于 cnchar 的支持,由于 cnchar 词库来源于网络,虽然经过了本人的修改的扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 [反馈](https://github.com/theajack/cnchar/issues/8) 给我(或自行修改提交,经过审查无误过后会合到 cnchar 中)
|
感谢同学们对于 cnchar 的支持,由于 cnchar 词库来源于网络,虽然经过了本人的修改和扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 [反馈](https://github.com/theajack/cnchar/issues/new) 给我(或自行修改提交,经过审查无误过后会合到 cnchar 中)
|
||||||
|
|
||||||
[我要反馈错误或缺漏](https://github.com/theajack/cnchar/issues/8)
|
[我要反馈错误或缺漏](https://github.com/theajack/cnchar/issues/new)
|
||||||
|
|
||||||
### 0.快速使用
|
### 0.快速使用
|
||||||
|
|
||||||
|
@ -35,18 +89,14 @@ import cnchar from 'cnchar';
|
||||||
使用 script 标签使用:
|
使用 script 标签使用:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<!--
|
|
||||||
或通过版本号引用
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
-->
|
|
||||||
<script>
|
<script>
|
||||||
'汉字'.spell();
|
'汉字'.spell();
|
||||||
'汉字'.stroke();
|
'汉字'.stroke();
|
||||||
</script>
|
</script>
|
||||||
```
|
```
|
||||||
|
|
||||||
<a href="#64-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
<a href="#66-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
||||||
|
|
||||||
### 1.功能
|
### 1.功能
|
||||||
|
|
||||||
|
@ -54,15 +104,18 @@ import cnchar from 'cnchar';
|
||||||
2. 支持 **多音词**
|
2. 支持 **多音词**
|
||||||
3. 支持 **拼音音调**
|
3. 支持 **拼音音调**
|
||||||
4. 获取汉字 **笔画数** 、支持数组分割
|
4. 获取汉字 **笔画数** 、支持数组分割
|
||||||
5. 获取汉字 **笔画顺序** 、笔画详细名称、通过笔画顺序推出原汉字等
|
5. 获取汉字 **笔画顺序** 、笔画详细名称
|
||||||
6. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
6. 支持可视化 **绘制汉字笔画** 、多种绘制模式可选
|
||||||
7. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
7. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
||||||
8. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
8. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
||||||
9. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
9. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
||||||
10. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
10. 支持 **根据笔画顺序查询** 汉字
|
||||||
11. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
11. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
||||||
12. **多端可用**,可用于 原生浏览器环境、webpack 环境、nodejs 环境...,几乎支持所有 js 能运行的环境
|
12. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
||||||
13. 丰富的配置,按需取用
|
13. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
||||||
|
14. **多端可用**,可用于 **浏览器、nodejs、小程序/小游戏、ReactNative/Weex/Uniapp/Electron、webpack**...,支持所有 js 能运行的环境
|
||||||
|
15. **typescript支持**,支持在typescript中调用
|
||||||
|
16. 丰富的配置,按需取用
|
||||||
|
|
||||||
### 2.概览
|
### 2.概览
|
||||||
|
|
||||||
|
@ -74,6 +127,7 @@ import cnchar from 'cnchar';
|
||||||
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
||||||
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
||||||
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
||||||
|
| cnchar-draw | 绘制笔画库 | 指出可视化绘制汉字,有 normal,animation,stroke,test 四种模式可选,该库仅在浏览器环境下可用 |
|
||||||
|
|
||||||
### 3 安装
|
### 3 安装
|
||||||
|
|
||||||
|
@ -88,7 +142,7 @@ npm i cnchar
|
||||||
安装附加功能库:
|
安装附加功能库:
|
||||||
|
|
||||||
```
|
```
|
||||||
npm i cnchar-poly cnchar-order cnchar-trad
|
npm i cnchar-poly cnchar-order cnchar-trad cnchar-draw
|
||||||
```
|
```
|
||||||
|
|
||||||
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
||||||
|
@ -102,20 +156,23 @@ npm i cnchar-all
|
||||||
#### 3.2 使用 script 引入
|
#### 3.2 使用 script 引入
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
<!-- 或使用版本号引用 -->
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.{version}.min.js"></script>
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
或使用以下cdn,包含了以上五个库
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-all/cnchar.all.min.js"></script>
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
### 4 使用
|
### 4 使用
|
||||||
|
|
||||||
#### 4.1 webpack、babel 等浏览器环境
|
#### 4.1 webpack浏览器环境(有window对象)
|
||||||
|
|
||||||
npm 安装好几个库之后:
|
npm 安装好几个库之后:
|
||||||
|
|
||||||
|
@ -125,6 +182,8 @@ import cnchar from 'cnchar';
|
||||||
import 'cnchar-poly';
|
import 'cnchar-poly';
|
||||||
import 'cnchar-order';
|
import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
|
import 'cnchar-draw';
|
||||||
|
// 插件请按需取用
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -142,6 +201,8 @@ var cnchar = require('cnchar');
|
||||||
var poly = require('cnchar-poly');
|
var poly = require('cnchar-poly');
|
||||||
var order = require('cnchar-order');
|
var order = require('cnchar-order');
|
||||||
var trad = require('cnchar-trad');
|
var trad = require('cnchar-trad');
|
||||||
|
// 插件请按需取用
|
||||||
|
// cnchar-draw 在非浏览器环境下不可使用
|
||||||
cnchar.use(poly, order, trad);
|
cnchar.use(poly, order, trad);
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
|
@ -155,10 +216,11 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script>
|
<script>
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -167,6 +229,8 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
|
||||||
### 5 API
|
### 5 API
|
||||||
|
|
||||||
|
类型声明:[cnchar.d.ts](https://github.com/theajack/cnchar/blob/master/src/main/index.d.ts)
|
||||||
|
|
||||||
#### 5.1 拼音笔画基础 API: spell & stroke
|
#### 5.1 拼音笔画基础 API: spell & stroke
|
||||||
|
|
||||||
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
||||||
|
@ -187,7 +251,93 @@ string.stroke([...args])
|
||||||
|
|
||||||
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
||||||
|
|
||||||
#### 5.2 繁体、简体、火星文互转: convert
|
#### 5.2 可视化绘制汉字: draw
|
||||||
|
|
||||||
|
类型声明:[cnchar.draw.d.ts](https://github.com/theajack/cnchar/blob/master/src/plugin/draw/index.d.ts)
|
||||||
|
|
||||||
|
`cnchar-draw` 库用于支持在浏览器环境下可视化绘制汉字,所以该库仅在浏览器环境下可用。
|
||||||
|
|
||||||
|
##### 5.2.1 使用
|
||||||
|
|
||||||
|
使用方式如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.draw('你好', options); // options 为可选参数, 在5.2.2 种会详细介绍
|
||||||
|
```
|
||||||
|
|
||||||
|
运行结果如下:
|
||||||
|
|
||||||
|
![draw.jpg](https://cdn.jsdelivr.net/gh/theajack/cnchar/assets/readme/draw.jpg)
|
||||||
|
|
||||||
|
该库支持脱离cnchar 独立使用
|
||||||
|
|
||||||
|
```js
|
||||||
|
import draw from 'cnchar-draw';
|
||||||
|
draw('你好')
|
||||||
|
```
|
||||||
|
|
||||||
|
使用cdn引用时,会在window对向上暴露 `CncharDraw` 对象
|
||||||
|
|
||||||
|
##### 5.2.2 参数
|
||||||
|
|
||||||
|
draw 的参数比较繁多,首先需要理解的是,draw 分为四种绘制模式:
|
||||||
|
|
||||||
|
1. normal: 常规绘制
|
||||||
|
2. animation: 带有绘制动画,支持连续绘制、同时绘制、循环绘制
|
||||||
|
3. stroke: 按汉字笔顺单步绘制
|
||||||
|
4. test: 测试模式,用户可以在容器内绘制汉字,cnchar-draw会检测是否绘制正确
|
||||||
|
|
||||||
|
以下是 options 的所有可选参数及描述,使用详情请参考[在线文档](https://theajack.gitee.io/cnchar):
|
||||||
|
|
||||||
|
```ts
|
||||||
|
declare interface DrawOption {
|
||||||
|
el?: string | HTMLElement; // 绘制的容器,支持id和dom,若是不填,会在body后append一个dom作为容器
|
||||||
|
type?: DrawType; // 绘制模式,默认为normal
|
||||||
|
style?: { // 样式类
|
||||||
|
showOutline?: boolean;//: true,
|
||||||
|
showCharacter?: boolean;//: true,
|
||||||
|
currentColor?: string;//: '#b44', // 仅在stroke模式下有效
|
||||||
|
length?: number;//: 60,
|
||||||
|
padding?: number;//: 5, // 数值, 默认 20。 画布的汉字和边缘之间的填充
|
||||||
|
outlineColor?: string;//: '#ddd', // 十六进制字符, 默认 '#DDD'。
|
||||||
|
strokeColor?: string;//: '#555', // 十六进制字符, 默认 '#555'。绘制每个笔划的颜色。
|
||||||
|
radicalColor?: string;//: null, // 十六进制字符, 默认 null。 如果存在偏旁部首数据,则在笔划中绘制偏旁部首的颜色。 如果没有设置,激光将绘制与其他笔划相同的颜色。
|
||||||
|
strokeFadeDuration?: number; //400
|
||||||
|
},
|
||||||
|
line?: { // 背景线条类
|
||||||
|
lineStraight?: boolean;// : true,
|
||||||
|
lineCross?: boolean;// : true,
|
||||||
|
lineWidth?: number;// : 1,
|
||||||
|
lineColor?: string;// : '#ddd',
|
||||||
|
lineDash?: boolean;// : true,
|
||||||
|
border?: boolean;// : true,
|
||||||
|
borderWidth?: number;// : 1,
|
||||||
|
borderColor?: string;// : '#ccc',
|
||||||
|
borderDash?: boolean;// : false,
|
||||||
|
},
|
||||||
|
animation?: {
|
||||||
|
strokeAnimationSpeed?: number;// : 1, // 数值, 默认 1。 绘制每个笔划的速度必须大于0。增加此数字可以更快地绘制笔划,减少绘制笔划的速度更慢。
|
||||||
|
delayBetweenStrokes?: number;// : 1000, // 数值, 默认 1000。 动画进行中每个笔画之间的间隔时间(以毫秒为单位)。
|
||||||
|
delayBetweenLoops?: number;// : 200, // 数值, 默认 2000。 循环动画时每个动画循环之间的时间(以毫秒为单位)。
|
||||||
|
autoAnimate?: boolean;// : true,
|
||||||
|
animateComplete?: Function;// : () => {},
|
||||||
|
stepByStep?: boolean;// : true,
|
||||||
|
loopAnimate?: boolean;// : false,
|
||||||
|
},
|
||||||
|
test?: {
|
||||||
|
strokeHighlightSpeed?: number;// : 20, // 数值, 默认 20。 在测验中给出提示时突出显示每个笔划的速度必须大于0。增加此数字以突出显示更快,减少以突出显示更慢。
|
||||||
|
highlightColor?: number;// : '#aaf', // 十六进制字符, 默认 '#AAF'。 用于在测验中突出显示的颜色。
|
||||||
|
drawingColor?: number;// : '#333', // 十六进制字符, 默认 '#333'。 测验期间绘制的线条颜色。
|
||||||
|
drawingWidth?: number;// : 4, // 数值, 默认 4。 进行测验时绘制的线条宽度。
|
||||||
|
showHintAfterMisses?: number;// : 3, // 整数, 默认 3 中风高亮提示之前的未命中数被给予用户。 设置为 false 以禁用。 创建测验时也可以设置此项。
|
||||||
|
highlightOnComplete?: number;// : true, // 布尔值, 默认 true。 控制当用户完成绘制整个字符时,测验是否会短暂突出显示字符。 创建测验时也可以设置此项。
|
||||||
|
highlightCompleteColor?: number;// : null, // 十六进制字符, 默认 null。 在测验中突出显示字符时使用的颜色。 如果未设置,则将使用highlightColor。 仅当highlightOnComplete为true时才相关。
|
||||||
|
onTestStatus?(args: TestStatus):void;// : null, // ({index, status, data})=>{}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.3 繁体、简体、火星文互转: convert
|
||||||
|
|
||||||
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
||||||
|
|
||||||
|
@ -209,7 +359,7 @@ string.convertSparkToSimple();
|
||||||
string.convertSparkToTrad();
|
string.convertSparkToTrad();
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.3 笔画序列推出原汉字: orderToWord
|
#### 5.4 笔画序列推出原汉字: orderToWord
|
||||||
|
|
||||||
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
||||||
|
|
||||||
|
@ -284,7 +434,7 @@ cnchar.orderToWord(['横', '撇', '捺'], 'start', 'simple');
|
||||||
|
|
||||||
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
||||||
|
|
||||||
#### 5.4 通过拼音查询原汉字: spellToWord
|
#### 5.5 通过拼音查询原汉字: spellToWord
|
||||||
|
|
||||||
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -308,7 +458,7 @@ spell 表示拼音,可以使用音调字母或音调数标方式:
|
||||||
|
|
||||||
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
||||||
|
|
||||||
#### 5.5 通过笔画数查询原汉字: strokeToWord
|
#### 5.6 通过笔画数查询原汉字: strokeToWord
|
||||||
|
|
||||||
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -324,7 +474,7 @@ cnchar.strokeToWord(25, 'simple'); // 返回 '鬣馕囔戆攮纛'
|
||||||
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.6 查询拼音详细信息: spellInfo
|
#### 5.7 查询拼音详细信息: spellInfo
|
||||||
|
|
||||||
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
||||||
|
|
||||||
|
@ -358,9 +508,9 @@ cnchar.spellInfo.tones;
|
||||||
// n 的一声使用 * 代替
|
// n 的一声使用 * 代替
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.7 其他 api
|
#### 5.8 其他 api
|
||||||
|
|
||||||
##### 5.7.1 .use()
|
##### 5.8.1 .use()
|
||||||
|
|
||||||
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
||||||
|
|
||||||
|
@ -389,7 +539,7 @@ import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.2 .type
|
##### 5.8.2 .type
|
||||||
|
|
||||||
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
||||||
|
|
||||||
|
@ -413,7 +563,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
|
|
||||||
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
||||||
|
|
||||||
##### 5.7.3 .check
|
##### 5.8.3 .check
|
||||||
|
|
||||||
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
||||||
|
|
||||||
|
@ -423,7 +573,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
cnchar.check = false; // 关闭参数校验
|
cnchar.check = false; // 关闭参数校验
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.4 .version
|
##### 5.8.4 .version
|
||||||
|
|
||||||
获取当前版本:
|
获取当前版本:
|
||||||
|
|
||||||
|
@ -431,7 +581,7 @@ cnchar.check = false; // 关闭参数校验
|
||||||
var version = cnchar.version; // string 类型
|
var version = cnchar.version; // string 类型
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.5 .plugins
|
##### 5.8.5 .plugins
|
||||||
|
|
||||||
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
||||||
|
|
||||||
|
@ -567,7 +717,7 @@ import cnchar from 'cnchar';
|
||||||
script 标签引用 方式
|
script 标签引用 方式
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"></script>
|
||||||
<script>
|
<script>
|
||||||
// do something
|
// do something
|
||||||
</script>
|
</script>
|
||||||
|
@ -723,3 +873,7 @@ cnchar.convert.sparkToTrad('①个亾');
|
||||||
### 7 应用例子
|
### 7 应用例子
|
||||||
|
|
||||||
[汉字打字游戏](https://www.theajack.com/type/)
|
[汉字打字游戏](https://www.theajack.com/type/)
|
||||||
|
|
||||||
|
**致谢**
|
||||||
|
|
||||||
|
`cnchar-draw` 库功能基于 [hanzi-writer](https://github.com/chanind/hanzi-writer), 特此表示感谢!
|
||||||
|
|
File diff suppressed because one or more lines are too long
|
@ -0,0 +1,90 @@
|
||||||
|
declare type DrawType = 'normal' | 'animation' | 'stroke' | 'test';
|
||||||
|
declare type TestStatusType = 'mistake' | 'correct' | 'complete';
|
||||||
|
declare class Writer {
|
||||||
|
constructor() {};
|
||||||
|
option: object;
|
||||||
|
el: HTMLElement;
|
||||||
|
type: DrawType;
|
||||||
|
text: Array<string>;
|
||||||
|
writer: Array<object>;
|
||||||
|
animateStart():void;
|
||||||
|
}
|
||||||
|
|
||||||
|
declare interface TestStatus {
|
||||||
|
index: number,
|
||||||
|
status: TestStatusType,
|
||||||
|
data: {
|
||||||
|
character: string;
|
||||||
|
totalMistakes: number;// 到目前为止在测验期间犯的总错误。
|
||||||
|
strokeNum?: number;// 当前笔画数。
|
||||||
|
mistakesOnStroke?: number;// 到目前为止用户绘制此笔划所犯的错误数。
|
||||||
|
strokesRemaining?: number;// 测验完成前剩余的笔画数。
|
||||||
|
drawnPath?: {
|
||||||
|
pathString: string;
|
||||||
|
points: Array<{x:number;y:number}>
|
||||||
|
};// 对象包含用户绘制的 pathString ,用于评分的分数。
|
||||||
|
}
|
||||||
|
}
|
||||||
|
declare interface DrawOption {
|
||||||
|
el?: string | HTMLElement; // 绘制的容器,支持id和dom,若是不填,会在body后append一个dom作为容器
|
||||||
|
type?: DrawType; // 绘制模式,默认为normal
|
||||||
|
style?: { // 样式类
|
||||||
|
showOutline?: boolean;//: true,
|
||||||
|
showCharacter?: boolean;//: true,
|
||||||
|
currentColor?: string;//: '#b44', // 仅在stroke模式下有效
|
||||||
|
length?: number;//: 60,
|
||||||
|
padding?: number;//: 5, // 数值, 默认 20。 画布的汉字和边缘之间的填充
|
||||||
|
outlineColor?: string;//: '#ddd', // 十六进制字符, 默认 '#DDD'。
|
||||||
|
strokeColor?: string;//: '#555', // 十六进制字符, 默认 '#555'。绘制每个笔划的颜色。
|
||||||
|
radicalColor?: string;//: null, // 十六进制字符, 默认 null。 如果存在偏旁部首数据,则在笔划中绘制偏旁部首的颜色。 如果没有设置,激光将绘制与其他笔划相同的颜色。
|
||||||
|
strokeFadeDuration?: number; //400
|
||||||
|
},
|
||||||
|
line?: { // 背景线条类
|
||||||
|
lineStraight?: boolean;// : true,
|
||||||
|
lineCross?: boolean;// : true,
|
||||||
|
lineWidth?: number;// : 1,
|
||||||
|
lineColor?: string;// : '#ddd',
|
||||||
|
lineDash?: boolean;// : true,
|
||||||
|
border?: boolean;// : true,
|
||||||
|
borderWidth?: number;// : 1,
|
||||||
|
borderColor?: string;// : '#ccc',
|
||||||
|
borderDash?: boolean;// : false,
|
||||||
|
},
|
||||||
|
animation?: {
|
||||||
|
strokeAnimationSpeed?: number;// : 1, // 数值, 默认 1。 绘制每个笔划的速度必须大于0。增加此数字可以更快地绘制笔划,减少绘制笔划的速度更慢。
|
||||||
|
delayBetweenStrokes?: number;// : 1000, // 数值, 默认 1000。 动画进行中每个笔画之间的间隔时间(以毫秒为单位)。
|
||||||
|
delayBetweenLoops?: number;// : 200, // 数值, 默认 2000。 循环动画时每个动画循环之间的时间(以毫秒为单位)。
|
||||||
|
autoAnimate?: boolean;// : true,
|
||||||
|
animateComplete?: Function;// : () => {},
|
||||||
|
stepByStep?: boolean;// : true,
|
||||||
|
loopAnimate?: boolean;// : false,
|
||||||
|
},
|
||||||
|
test?: {
|
||||||
|
strokeHighlightSpeed?: number;// : 20, // 数值, 默认 20。 在测验中给出提示时突出显示每个笔划的速度必须大于0。增加此数字以突出显示更快,减少以突出显示更慢。
|
||||||
|
highlightColor?: number;// : '#aaf', // 十六进制字符, 默认 '#AAF'。 用于在测验中突出显示的颜色。
|
||||||
|
drawingColor?: number;// : '#333', // 十六进制字符, 默认 '#333'。 测验期间绘制的线条颜色。
|
||||||
|
drawingWidth?: number;// : 4, // 数值, 默认 4。 进行测验时绘制的线条宽度。
|
||||||
|
showHintAfterMisses?: number;// : 3, // 整数, 默认 3 中风高亮提示之前的未命中数被给予用户。 设置为 false 以禁用。 创建测验时也可以设置此项。
|
||||||
|
highlightOnComplete?: number;// : true, // 布尔值, 默认 true。 控制当用户完成绘制整个字符时,测验是否会短暂突出显示字符。 创建测验时也可以设置此项。
|
||||||
|
highlightCompleteColor?: number;// : null, // 十六进制字符, 默认 null。 在测验中突出显示字符时使用的颜色。 如果未设置,则将使用highlightColor。 仅当highlightOnComplete为true时才相关。
|
||||||
|
onTestStatus?(args: TestStatus):void;// : null, // ({index, status, data})=>{}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
export declare interface Draw {
|
||||||
|
(text:string, option?:DrawOption):Writer;
|
||||||
|
TYPE: {
|
||||||
|
ANIMATION: 'animation',
|
||||||
|
NORMAL: 'normal',
|
||||||
|
STROKE: 'stroke',
|
||||||
|
TEST: 'test'
|
||||||
|
},
|
||||||
|
TEST_STATUS: {
|
||||||
|
MISTAKE: 'mistake',
|
||||||
|
CORRECT: 'correct',
|
||||||
|
COMPLETE: 'complete'
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
declare const draw: Draw;
|
||||||
|
|
||||||
|
export default draw;
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "cnchar-draw",
|
"name": "cnchar-draw",
|
||||||
"version": "2.0.9",
|
"version": "2.1.0",
|
||||||
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"unpkg": "cnchar.draw.min.js",
|
"unpkg": "cnchar.draw.min.js",
|
||||||
|
|
File diff suppressed because one or more lines are too long
|
@ -1,3 +1,6 @@
|
||||||
|
import {Draw} from 'cnchar-draw';
|
||||||
|
// import {Draw} from 'cnchar-draw';
|
||||||
|
|
||||||
declare type spellArg = 'array' | 'low' | 'up' | 'first' | 'poly' | 'tone' | 'simple';
|
declare type spellArg = 'array' | 'low' | 'up' | 'first' | 'poly' | 'tone' | 'simple';
|
||||||
declare type strokeArg = 'letter' | 'shape' | 'count' | 'name' | 'detail' | 'array' | 'order' | 'simple';
|
declare type strokeArg = 'letter' | 'shape' | 'count' | 'name' | 'detail' | 'array' | 'order' | 'simple';
|
||||||
declare type orderToWordArg = 'match' | 'matchorder' | 'contain' | 'start' | 'simple' | 'array';
|
declare type orderToWordArg = 'match' | 'matchorder' | 'contain' | 'start' | 'simple' | 'array';
|
||||||
|
@ -17,6 +20,7 @@ declare interface spellInfoReturnStatic {
|
||||||
declare interface CnCharStatic {
|
declare interface CnCharStatic {
|
||||||
spell(sentence: string, ...args: Array<spellArg>): string | Array<any>;
|
spell(sentence: string, ...args: Array<spellArg>): string | Array<any>;
|
||||||
stroke(sentence: string, ...args: Array<strokeArg>): number | Array<any>;
|
stroke(sentence: string, ...args: Array<strokeArg>): number | Array<any>;
|
||||||
|
draw?: Draw;
|
||||||
use(...plugins: Array<Function>): void;
|
use(...plugins: Array<Function>): void;
|
||||||
orderToWord: {
|
orderToWord: {
|
||||||
(orders: string | Array<orderName>, ...args: Array<orderToWordArg>): string | Array<string>;
|
(orders: string | Array<orderName>, ...args: Array<orderToWordArg>): string | Array<string>;
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "hanzi-util-base",
|
"name": "hanzi-util-base",
|
||||||
"version": "2.0.9",
|
"version": "2.1.0",
|
||||||
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"unpkg": "hanzi.base.min.js",
|
"unpkg": "hanzi.base.min.js",
|
||||||
|
@ -27,6 +27,6 @@
|
||||||
},
|
},
|
||||||
"homepage": "https://www.theajack.com/cnchar/",
|
"homepage": "https://www.theajack.com/cnchar/",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"cnchar": "^2.0.9"
|
"cnchar": "^2.1.0"
|
||||||
}
|
}
|
||||||
}
|
}
|
File diff suppressed because one or more lines are too long
|
@ -1,3 +1,6 @@
|
||||||
|
import {Draw} from 'cnchar-draw';
|
||||||
|
// import {Draw} from 'cnchar-draw';
|
||||||
|
|
||||||
declare type spellArg = 'array' | 'low' | 'up' | 'first' | 'poly' | 'tone' | 'simple';
|
declare type spellArg = 'array' | 'low' | 'up' | 'first' | 'poly' | 'tone' | 'simple';
|
||||||
declare type strokeArg = 'letter' | 'shape' | 'count' | 'name' | 'detail' | 'array' | 'order' | 'simple';
|
declare type strokeArg = 'letter' | 'shape' | 'count' | 'name' | 'detail' | 'array' | 'order' | 'simple';
|
||||||
declare type orderToWordArg = 'match' | 'matchorder' | 'contain' | 'start' | 'simple' | 'array';
|
declare type orderToWordArg = 'match' | 'matchorder' | 'contain' | 'start' | 'simple' | 'array';
|
||||||
|
@ -17,6 +20,7 @@ declare interface spellInfoReturnStatic {
|
||||||
declare interface CnCharStatic {
|
declare interface CnCharStatic {
|
||||||
spell(sentence: string, ...args: Array<spellArg>): string | Array<any>;
|
spell(sentence: string, ...args: Array<spellArg>): string | Array<any>;
|
||||||
stroke(sentence: string, ...args: Array<strokeArg>): number | Array<any>;
|
stroke(sentence: string, ...args: Array<strokeArg>): number | Array<any>;
|
||||||
|
draw?: Draw;
|
||||||
use(...plugins: Array<Function>): void;
|
use(...plugins: Array<Function>): void;
|
||||||
orderToWord: {
|
orderToWord: {
|
||||||
(orders: string | Array<orderName>, ...args: Array<orderToWordArg>): string | Array<string>;
|
(orders: string | Array<orderName>, ...args: Array<orderToWordArg>): string | Array<string>;
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "hanzi-util",
|
"name": "hanzi-util",
|
||||||
"version": "2.0.9",
|
"version": "2.1.0",
|
||||||
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"unpkg": "hanzi.util.min.js",
|
"unpkg": "hanzi.util.min.js",
|
||||||
|
@ -27,6 +27,6 @@
|
||||||
},
|
},
|
||||||
"homepage": "https://www.theajack.com/cnchar/",
|
"homepage": "https://www.theajack.com/cnchar/",
|
||||||
"dependencies": {
|
"dependencies": {
|
||||||
"cnchar-all": "^2.0.9"
|
"cnchar-all": "^2.1.0"
|
||||||
}
|
}
|
||||||
}
|
}
|
|
@ -1,22 +1,76 @@
|
||||||
# [cnchar](https://github.com/theajack/cnchar)
|
# [cnchar](https://github.com/theajack/cnchar) <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/github/stars/theajack/cnchar.svg?style=social" alt="star"></a> <a href="https://theajack.gitee.io"><img src="https://img.shields.io/badge/author-theajack-blue.svg?style=social" alt="Author"></a>
|
||||||
|
|
||||||
#### [theajack](https://www.theajack.com/)
|
|
||||||
|
<p>
|
||||||
|
<a href="https://www.npmjs.com/package/cnchar"><img src="https://img.shields.io/npm/v/cnchar.svg" alt="Version"></a>
|
||||||
|
<a href="https://npmcharts.com/compare/cnchar?minimal=true"><img src="https://img.shields.io/npm/dm/cnchar.svg" alt="Downloads"></a>
|
||||||
|
<a href="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"><img src="https://img.shields.io/bundlephobia/minzip/cnchar.svg" alt="Size"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/cnchar.svg" alt="License"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/search?l=javascript"><img src="https://img.shields.io/github/languages/top/theajack/cnchar.svg" alt="TopLang"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/issues"><img src="https://img.shields.io/github/issues-closed/theajack/cnchar.svg" alt="issue"></a>
|
||||||
|
<!-- <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/librariesio/dependent-repos/npm/cnchar.svg" alt="Dependent"></a> -->
|
||||||
|
</p>
|
||||||
|
|
||||||
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
||||||
|
|
||||||
**<a href="#64-使用实例大全">快速上手</a> | [在线试用](https://www.theajack.com/cnchar/) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://www.theajack.com/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/8)**
|
**<a href="#66-使用实例大全">快速上手</a> | [在线试用/文档](https://theajack.gitee.io/cnchar) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://theajack.gitee.io/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/new)**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
[TOC]
|
<!-- toc -->
|
||||||
|
|
||||||
|
- [前言](#%E5%89%8D%E8%A8%80)
|
||||||
|
- [0.快速使用](#0%E5%BF%AB%E9%80%9F%E4%BD%BF%E7%94%A8)
|
||||||
|
- [1.功能](#1%E5%8A%9F%E8%83%BD)
|
||||||
|
- [2.概览](#2%E6%A6%82%E8%A7%88)
|
||||||
|
- [3 安装](#3-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.1 使用 npm 安装](#31-%E4%BD%BF%E7%94%A8-npm-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.2 使用 script 引入](#32-%E4%BD%BF%E7%94%A8-script-%E5%BC%95%E5%85%A5)
|
||||||
|
- [4 使用](#4-%E4%BD%BF%E7%94%A8)
|
||||||
|
* [4.1 webpack浏览器环境(有window对象)](#41-webpack%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83%E6%9C%89window%E5%AF%B9%E8%B1%A1)
|
||||||
|
* [4.2 nodejs 等非浏览器环境](#42-nodejs-%E7%AD%89%E9%9D%9E%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
* [4.3 原生浏览器环境](#43-%E5%8E%9F%E7%94%9F%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
- [5 API](#5-api)
|
||||||
|
* [5.1 拼音笔画基础 API: spell & stroke](#51-%E6%8B%BC%E9%9F%B3%E7%AC%94%E7%94%BB%E5%9F%BA%E7%A1%80-api-spell--stroke)
|
||||||
|
* [5.2 可视化绘制汉字: draw](#52-%E5%8F%AF%E8%A7%86%E5%8C%96%E7%BB%98%E5%88%B6%E6%B1%89%E5%AD%97-draw)
|
||||||
|
+ [5.2.1 使用](#521-%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [5.2.2 参数](#522-%E5%8F%82%E6%95%B0)
|
||||||
|
* [5.3 繁体、简体、火星文互转: convert](#53-%E7%B9%81%E4%BD%93%E7%AE%80%E4%BD%93%E7%81%AB%E6%98%9F%E6%96%87%E4%BA%92%E8%BD%AC-convert)
|
||||||
|
* [5.4 笔画序列推出原汉字: orderToWord](#54-%E7%AC%94%E7%94%BB%E5%BA%8F%E5%88%97%E6%8E%A8%E5%87%BA%E5%8E%9F%E6%B1%89%E5%AD%97-ordertoword)
|
||||||
|
* [5.5 通过拼音查询原汉字: spellToWord](#55-%E9%80%9A%E8%BF%87%E6%8B%BC%E9%9F%B3%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-spelltoword)
|
||||||
|
* [5.6 通过笔画数查询原汉字: strokeToWord](#56-%E9%80%9A%E8%BF%87%E7%AC%94%E7%94%BB%E6%95%B0%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-stroketoword)
|
||||||
|
* [5.7 查询拼音详细信息: spellInfo](#57-%E6%9F%A5%E8%AF%A2%E6%8B%BC%E9%9F%B3%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF-spellinfo)
|
||||||
|
* [5.8 其他 api](#58-%E5%85%B6%E4%BB%96-api)
|
||||||
|
+ [5.8.1 .use()](#581-use)
|
||||||
|
+ [5.8.2 .type](#582-type)
|
||||||
|
+ [5.8.3 .check](#583-check)
|
||||||
|
+ [5.8.4 .version](#584-version)
|
||||||
|
+ [5.8.5 .plugins](#585-plugins)
|
||||||
|
- [6 spell stroke 参数](#6-spell-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.1 spell 参数](#61-spell-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.2 stroke 参数](#62-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.3 orderToWord 参数](#63-ordertoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.4 spellToWord 参数](#64-spelltoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.5 strokeToWord 参数](#65-stroketoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.6 使用实例大全:](#66-%E4%BD%BF%E7%94%A8%E5%AE%9E%E4%BE%8B%E5%A4%A7%E5%85%A8)
|
||||||
|
+ [6.6.0 安装使用](#660-%E5%AE%89%E8%A3%85%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [6.6.1 cnchar 基础库功能](#661-cnchar-%E5%9F%BA%E7%A1%80%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.2 cnchar-poly 库功能](#662-cnchar-poly-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.3 cnchar-order 库功能](#663-cnchar-order-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.4 cnchar-trad 库功能](#664-cnchar-trad-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
- [6.6.4.1 convert 字体转换](#6641-convert-%E5%AD%97%E4%BD%93%E8%BD%AC%E6%8D%A2)
|
||||||
|
- [6.6.4.2 spell 和 stroke 方法](#6642-spell-%E5%92%8C-stroke-%E6%96%B9%E6%B3%95)
|
||||||
|
- [7 应用例子](#7-%E5%BA%94%E7%94%A8%E4%BE%8B%E5%AD%90)
|
||||||
|
|
||||||
|
<!-- tocstop -->
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### 前言
|
### 前言
|
||||||
|
|
||||||
感谢同学们对于 cnchar 的支持,由于 cnchar 词库来源于网络,虽然经过了本人的修改的扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 [反馈](https://github.com/theajack/cnchar/issues/8) 给我(或自行修改提交,经过审查无误过后会合到 cnchar 中)
|
感谢同学们对于 cnchar 的支持,由于 cnchar 词库来源于网络,虽然经过了本人的修改和扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 [反馈](https://github.com/theajack/cnchar/issues/new) 给我(或自行修改提交,经过审查无误过后会合到 cnchar 中)
|
||||||
|
|
||||||
[我要反馈错误或缺漏](https://github.com/theajack/cnchar/issues/8)
|
[我要反馈错误或缺漏](https://github.com/theajack/cnchar/issues/new)
|
||||||
|
|
||||||
### 0.快速使用
|
### 0.快速使用
|
||||||
|
|
||||||
|
@ -35,18 +89,14 @@ import cnchar from 'cnchar';
|
||||||
使用 script 标签使用:
|
使用 script 标签使用:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<!--
|
|
||||||
或通过版本号引用
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
-->
|
|
||||||
<script>
|
<script>
|
||||||
'汉字'.spell();
|
'汉字'.spell();
|
||||||
'汉字'.stroke();
|
'汉字'.stroke();
|
||||||
</script>
|
</script>
|
||||||
```
|
```
|
||||||
|
|
||||||
<a href="#64-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
<a href="#66-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
||||||
|
|
||||||
### 1.功能
|
### 1.功能
|
||||||
|
|
||||||
|
@ -54,15 +104,18 @@ import cnchar from 'cnchar';
|
||||||
2. 支持 **多音词**
|
2. 支持 **多音词**
|
||||||
3. 支持 **拼音音调**
|
3. 支持 **拼音音调**
|
||||||
4. 获取汉字 **笔画数** 、支持数组分割
|
4. 获取汉字 **笔画数** 、支持数组分割
|
||||||
5. 获取汉字 **笔画顺序** 、笔画详细名称、通过笔画顺序推出原汉字等
|
5. 获取汉字 **笔画顺序** 、笔画详细名称
|
||||||
6. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
6. 支持可视化 **绘制汉字笔画** 、多种绘制模式可选
|
||||||
7. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
7. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
||||||
8. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
8. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
||||||
9. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
9. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
||||||
10. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
10. 支持 **根据笔画顺序查询** 汉字
|
||||||
11. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
11. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
||||||
12. **多端可用**,可用于 原生浏览器环境、webpack 环境、nodejs 环境...,几乎支持所有 js 能运行的环境
|
12. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
||||||
13. 丰富的配置,按需取用
|
13. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
||||||
|
14. **多端可用**,可用于 **浏览器、nodejs、小程序/小游戏、ReactNative/Weex/Uniapp/Electron、webpack**...,支持所有 js 能运行的环境
|
||||||
|
15. **typescript支持**,支持在typescript中调用
|
||||||
|
16. 丰富的配置,按需取用
|
||||||
|
|
||||||
### 2.概览
|
### 2.概览
|
||||||
|
|
||||||
|
@ -74,6 +127,7 @@ import cnchar from 'cnchar';
|
||||||
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
||||||
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
||||||
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
||||||
|
| cnchar-draw | 绘制笔画库 | 指出可视化绘制汉字,有 normal,animation,stroke,test 四种模式可选,该库仅在浏览器环境下可用 |
|
||||||
|
|
||||||
### 3 安装
|
### 3 安装
|
||||||
|
|
||||||
|
@ -88,7 +142,7 @@ npm i cnchar
|
||||||
安装附加功能库:
|
安装附加功能库:
|
||||||
|
|
||||||
```
|
```
|
||||||
npm i cnchar-poly cnchar-order cnchar-trad
|
npm i cnchar-poly cnchar-order cnchar-trad cnchar-draw
|
||||||
```
|
```
|
||||||
|
|
||||||
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
||||||
|
@ -102,20 +156,23 @@ npm i cnchar-all
|
||||||
#### 3.2 使用 script 引入
|
#### 3.2 使用 script 引入
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
<!-- 或使用版本号引用 -->
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.{version}.min.js"></script>
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
或使用以下cdn,包含了以上五个库
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-all/cnchar.all.min.js"></script>
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
### 4 使用
|
### 4 使用
|
||||||
|
|
||||||
#### 4.1 webpack、babel 等浏览器环境
|
#### 4.1 webpack浏览器环境(有window对象)
|
||||||
|
|
||||||
npm 安装好几个库之后:
|
npm 安装好几个库之后:
|
||||||
|
|
||||||
|
@ -125,6 +182,8 @@ import cnchar from 'cnchar';
|
||||||
import 'cnchar-poly';
|
import 'cnchar-poly';
|
||||||
import 'cnchar-order';
|
import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
|
import 'cnchar-draw';
|
||||||
|
// 插件请按需取用
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -142,6 +201,8 @@ var cnchar = require('cnchar');
|
||||||
var poly = require('cnchar-poly');
|
var poly = require('cnchar-poly');
|
||||||
var order = require('cnchar-order');
|
var order = require('cnchar-order');
|
||||||
var trad = require('cnchar-trad');
|
var trad = require('cnchar-trad');
|
||||||
|
// 插件请按需取用
|
||||||
|
// cnchar-draw 在非浏览器环境下不可使用
|
||||||
cnchar.use(poly, order, trad);
|
cnchar.use(poly, order, trad);
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
|
@ -155,10 +216,11 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script>
|
<script>
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -167,6 +229,8 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
|
||||||
### 5 API
|
### 5 API
|
||||||
|
|
||||||
|
类型声明:[cnchar.d.ts](https://github.com/theajack/cnchar/blob/master/src/main/index.d.ts)
|
||||||
|
|
||||||
#### 5.1 拼音笔画基础 API: spell & stroke
|
#### 5.1 拼音笔画基础 API: spell & stroke
|
||||||
|
|
||||||
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
||||||
|
@ -187,7 +251,93 @@ string.stroke([...args])
|
||||||
|
|
||||||
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
||||||
|
|
||||||
#### 5.2 繁体、简体、火星文互转: convert
|
#### 5.2 可视化绘制汉字: draw
|
||||||
|
|
||||||
|
类型声明:[cnchar.draw.d.ts](https://github.com/theajack/cnchar/blob/master/src/plugin/draw/index.d.ts)
|
||||||
|
|
||||||
|
`cnchar-draw` 库用于支持在浏览器环境下可视化绘制汉字,所以该库仅在浏览器环境下可用。
|
||||||
|
|
||||||
|
##### 5.2.1 使用
|
||||||
|
|
||||||
|
使用方式如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.draw('你好', options); // options 为可选参数, 在5.2.2 种会详细介绍
|
||||||
|
```
|
||||||
|
|
||||||
|
运行结果如下:
|
||||||
|
|
||||||
|
![draw.jpg](https://cdn.jsdelivr.net/gh/theajack/cnchar/assets/readme/draw.jpg)
|
||||||
|
|
||||||
|
该库支持脱离cnchar 独立使用
|
||||||
|
|
||||||
|
```js
|
||||||
|
import draw from 'cnchar-draw';
|
||||||
|
draw('你好')
|
||||||
|
```
|
||||||
|
|
||||||
|
使用cdn引用时,会在window对向上暴露 `CncharDraw` 对象
|
||||||
|
|
||||||
|
##### 5.2.2 参数
|
||||||
|
|
||||||
|
draw 的参数比较繁多,首先需要理解的是,draw 分为四种绘制模式:
|
||||||
|
|
||||||
|
1. normal: 常规绘制
|
||||||
|
2. animation: 带有绘制动画,支持连续绘制、同时绘制、循环绘制
|
||||||
|
3. stroke: 按汉字笔顺单步绘制
|
||||||
|
4. test: 测试模式,用户可以在容器内绘制汉字,cnchar-draw会检测是否绘制正确
|
||||||
|
|
||||||
|
以下是 options 的所有可选参数及描述,使用详情请参考[在线文档](https://theajack.gitee.io/cnchar):
|
||||||
|
|
||||||
|
```ts
|
||||||
|
declare interface DrawOption {
|
||||||
|
el?: string | HTMLElement; // 绘制的容器,支持id和dom,若是不填,会在body后append一个dom作为容器
|
||||||
|
type?: DrawType; // 绘制模式,默认为normal
|
||||||
|
style?: { // 样式类
|
||||||
|
showOutline?: boolean;//: true,
|
||||||
|
showCharacter?: boolean;//: true,
|
||||||
|
currentColor?: string;//: '#b44', // 仅在stroke模式下有效
|
||||||
|
length?: number;//: 60,
|
||||||
|
padding?: number;//: 5, // 数值, 默认 20。 画布的汉字和边缘之间的填充
|
||||||
|
outlineColor?: string;//: '#ddd', // 十六进制字符, 默认 '#DDD'。
|
||||||
|
strokeColor?: string;//: '#555', // 十六进制字符, 默认 '#555'。绘制每个笔划的颜色。
|
||||||
|
radicalColor?: string;//: null, // 十六进制字符, 默认 null。 如果存在偏旁部首数据,则在笔划中绘制偏旁部首的颜色。 如果没有设置,激光将绘制与其他笔划相同的颜色。
|
||||||
|
strokeFadeDuration?: number; //400
|
||||||
|
},
|
||||||
|
line?: { // 背景线条类
|
||||||
|
lineStraight?: boolean;// : true,
|
||||||
|
lineCross?: boolean;// : true,
|
||||||
|
lineWidth?: number;// : 1,
|
||||||
|
lineColor?: string;// : '#ddd',
|
||||||
|
lineDash?: boolean;// : true,
|
||||||
|
border?: boolean;// : true,
|
||||||
|
borderWidth?: number;// : 1,
|
||||||
|
borderColor?: string;// : '#ccc',
|
||||||
|
borderDash?: boolean;// : false,
|
||||||
|
},
|
||||||
|
animation?: {
|
||||||
|
strokeAnimationSpeed?: number;// : 1, // 数值, 默认 1。 绘制每个笔划的速度必须大于0。增加此数字可以更快地绘制笔划,减少绘制笔划的速度更慢。
|
||||||
|
delayBetweenStrokes?: number;// : 1000, // 数值, 默认 1000。 动画进行中每个笔画之间的间隔时间(以毫秒为单位)。
|
||||||
|
delayBetweenLoops?: number;// : 200, // 数值, 默认 2000。 循环动画时每个动画循环之间的时间(以毫秒为单位)。
|
||||||
|
autoAnimate?: boolean;// : true,
|
||||||
|
animateComplete?: Function;// : () => {},
|
||||||
|
stepByStep?: boolean;// : true,
|
||||||
|
loopAnimate?: boolean;// : false,
|
||||||
|
},
|
||||||
|
test?: {
|
||||||
|
strokeHighlightSpeed?: number;// : 20, // 数值, 默认 20。 在测验中给出提示时突出显示每个笔划的速度必须大于0。增加此数字以突出显示更快,减少以突出显示更慢。
|
||||||
|
highlightColor?: number;// : '#aaf', // 十六进制字符, 默认 '#AAF'。 用于在测验中突出显示的颜色。
|
||||||
|
drawingColor?: number;// : '#333', // 十六进制字符, 默认 '#333'。 测验期间绘制的线条颜色。
|
||||||
|
drawingWidth?: number;// : 4, // 数值, 默认 4。 进行测验时绘制的线条宽度。
|
||||||
|
showHintAfterMisses?: number;// : 3, // 整数, 默认 3 中风高亮提示之前的未命中数被给予用户。 设置为 false 以禁用。 创建测验时也可以设置此项。
|
||||||
|
highlightOnComplete?: number;// : true, // 布尔值, 默认 true。 控制当用户完成绘制整个字符时,测验是否会短暂突出显示字符。 创建测验时也可以设置此项。
|
||||||
|
highlightCompleteColor?: number;// : null, // 十六进制字符, 默认 null。 在测验中突出显示字符时使用的颜色。 如果未设置,则将使用highlightColor。 仅当highlightOnComplete为true时才相关。
|
||||||
|
onTestStatus?(args: TestStatus):void;// : null, // ({index, status, data})=>{}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.3 繁体、简体、火星文互转: convert
|
||||||
|
|
||||||
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
||||||
|
|
||||||
|
@ -209,7 +359,7 @@ string.convertSparkToSimple();
|
||||||
string.convertSparkToTrad();
|
string.convertSparkToTrad();
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.3 笔画序列推出原汉字: orderToWord
|
#### 5.4 笔画序列推出原汉字: orderToWord
|
||||||
|
|
||||||
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
||||||
|
|
||||||
|
@ -284,7 +434,7 @@ cnchar.orderToWord(['横', '撇', '捺'], 'start', 'simple');
|
||||||
|
|
||||||
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
||||||
|
|
||||||
#### 5.4 通过拼音查询原汉字: spellToWord
|
#### 5.5 通过拼音查询原汉字: spellToWord
|
||||||
|
|
||||||
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -308,7 +458,7 @@ spell 表示拼音,可以使用音调字母或音调数标方式:
|
||||||
|
|
||||||
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
||||||
|
|
||||||
#### 5.5 通过笔画数查询原汉字: strokeToWord
|
#### 5.6 通过笔画数查询原汉字: strokeToWord
|
||||||
|
|
||||||
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -324,7 +474,7 @@ cnchar.strokeToWord(25, 'simple'); // 返回 '鬣馕囔戆攮纛'
|
||||||
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.6 查询拼音详细信息: spellInfo
|
#### 5.7 查询拼音详细信息: spellInfo
|
||||||
|
|
||||||
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
||||||
|
|
||||||
|
@ -358,9 +508,9 @@ cnchar.spellInfo.tones;
|
||||||
// n 的一声使用 * 代替
|
// n 的一声使用 * 代替
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.7 其他 api
|
#### 5.8 其他 api
|
||||||
|
|
||||||
##### 5.7.1 .use()
|
##### 5.8.1 .use()
|
||||||
|
|
||||||
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
||||||
|
|
||||||
|
@ -389,7 +539,7 @@ import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.2 .type
|
##### 5.8.2 .type
|
||||||
|
|
||||||
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
||||||
|
|
||||||
|
@ -413,7 +563,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
|
|
||||||
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
||||||
|
|
||||||
##### 5.7.3 .check
|
##### 5.8.3 .check
|
||||||
|
|
||||||
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
||||||
|
|
||||||
|
@ -423,7 +573,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
cnchar.check = false; // 关闭参数校验
|
cnchar.check = false; // 关闭参数校验
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.4 .version
|
##### 5.8.4 .version
|
||||||
|
|
||||||
获取当前版本:
|
获取当前版本:
|
||||||
|
|
||||||
|
@ -431,7 +581,7 @@ cnchar.check = false; // 关闭参数校验
|
||||||
var version = cnchar.version; // string 类型
|
var version = cnchar.version; // string 类型
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.5 .plugins
|
##### 5.8.5 .plugins
|
||||||
|
|
||||||
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
||||||
|
|
||||||
|
@ -567,7 +717,7 @@ import cnchar from 'cnchar';
|
||||||
script 标签引用 方式
|
script 标签引用 方式
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"></script>
|
||||||
<script>
|
<script>
|
||||||
// do something
|
// do something
|
||||||
</script>
|
</script>
|
||||||
|
@ -723,3 +873,7 @@ cnchar.convert.sparkToTrad('①个亾');
|
||||||
### 7 应用例子
|
### 7 应用例子
|
||||||
|
|
||||||
[汉字打字游戏](https://www.theajack.com/type/)
|
[汉字打字游戏](https://www.theajack.com/type/)
|
||||||
|
|
||||||
|
**致谢**
|
||||||
|
|
||||||
|
`cnchar-draw` 库功能基于 [hanzi-writer](https://github.com/chanind/hanzi-writer), 特此表示感谢!
|
||||||
|
|
File diff suppressed because one or more lines are too long
|
@ -1,6 +1,6 @@
|
||||||
"use strict";
|
"use strict";
|
||||||
|
|
||||||
function _typeof(obj) { if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
|
function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
|
||||||
|
|
||||||
var orders = require('./stroke-order-jian.json');
|
var orders = require('./stroke-order-jian.json');
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "cnchar-order",
|
"name": "cnchar-order",
|
||||||
"version": "2.0.9",
|
"version": "2.1.0",
|
||||||
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"unpkg": "cnchar.order.min.js",
|
"unpkg": "cnchar.order.min.js",
|
||||||
|
|
|
@ -1,22 +1,76 @@
|
||||||
# [cnchar](https://github.com/theajack/cnchar)
|
# [cnchar](https://github.com/theajack/cnchar) <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/github/stars/theajack/cnchar.svg?style=social" alt="star"></a> <a href="https://theajack.gitee.io"><img src="https://img.shields.io/badge/author-theajack-blue.svg?style=social" alt="Author"></a>
|
||||||
|
|
||||||
#### [theajack](https://www.theajack.com/)
|
|
||||||
|
<p>
|
||||||
|
<a href="https://www.npmjs.com/package/cnchar"><img src="https://img.shields.io/npm/v/cnchar.svg" alt="Version"></a>
|
||||||
|
<a href="https://npmcharts.com/compare/cnchar?minimal=true"><img src="https://img.shields.io/npm/dm/cnchar.svg" alt="Downloads"></a>
|
||||||
|
<a href="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"><img src="https://img.shields.io/bundlephobia/minzip/cnchar.svg" alt="Size"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/cnchar.svg" alt="License"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/search?l=javascript"><img src="https://img.shields.io/github/languages/top/theajack/cnchar.svg" alt="TopLang"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/issues"><img src="https://img.shields.io/github/issues-closed/theajack/cnchar.svg" alt="issue"></a>
|
||||||
|
<!-- <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/librariesio/dependent-repos/npm/cnchar.svg" alt="Dependent"></a> -->
|
||||||
|
</p>
|
||||||
|
|
||||||
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
||||||
|
|
||||||
**<a href="#64-使用实例大全">快速上手</a> | [在线试用](https://www.theajack.com/cnchar/) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://www.theajack.com/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/8)**
|
**<a href="#66-使用实例大全">快速上手</a> | [在线试用/文档](https://theajack.gitee.io/cnchar) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://theajack.gitee.io/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/new)**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
[TOC]
|
<!-- toc -->
|
||||||
|
|
||||||
|
- [前言](#%E5%89%8D%E8%A8%80)
|
||||||
|
- [0.快速使用](#0%E5%BF%AB%E9%80%9F%E4%BD%BF%E7%94%A8)
|
||||||
|
- [1.功能](#1%E5%8A%9F%E8%83%BD)
|
||||||
|
- [2.概览](#2%E6%A6%82%E8%A7%88)
|
||||||
|
- [3 安装](#3-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.1 使用 npm 安装](#31-%E4%BD%BF%E7%94%A8-npm-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.2 使用 script 引入](#32-%E4%BD%BF%E7%94%A8-script-%E5%BC%95%E5%85%A5)
|
||||||
|
- [4 使用](#4-%E4%BD%BF%E7%94%A8)
|
||||||
|
* [4.1 webpack浏览器环境(有window对象)](#41-webpack%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83%E6%9C%89window%E5%AF%B9%E8%B1%A1)
|
||||||
|
* [4.2 nodejs 等非浏览器环境](#42-nodejs-%E7%AD%89%E9%9D%9E%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
* [4.3 原生浏览器环境](#43-%E5%8E%9F%E7%94%9F%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
- [5 API](#5-api)
|
||||||
|
* [5.1 拼音笔画基础 API: spell & stroke](#51-%E6%8B%BC%E9%9F%B3%E7%AC%94%E7%94%BB%E5%9F%BA%E7%A1%80-api-spell--stroke)
|
||||||
|
* [5.2 可视化绘制汉字: draw](#52-%E5%8F%AF%E8%A7%86%E5%8C%96%E7%BB%98%E5%88%B6%E6%B1%89%E5%AD%97-draw)
|
||||||
|
+ [5.2.1 使用](#521-%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [5.2.2 参数](#522-%E5%8F%82%E6%95%B0)
|
||||||
|
* [5.3 繁体、简体、火星文互转: convert](#53-%E7%B9%81%E4%BD%93%E7%AE%80%E4%BD%93%E7%81%AB%E6%98%9F%E6%96%87%E4%BA%92%E8%BD%AC-convert)
|
||||||
|
* [5.4 笔画序列推出原汉字: orderToWord](#54-%E7%AC%94%E7%94%BB%E5%BA%8F%E5%88%97%E6%8E%A8%E5%87%BA%E5%8E%9F%E6%B1%89%E5%AD%97-ordertoword)
|
||||||
|
* [5.5 通过拼音查询原汉字: spellToWord](#55-%E9%80%9A%E8%BF%87%E6%8B%BC%E9%9F%B3%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-spelltoword)
|
||||||
|
* [5.6 通过笔画数查询原汉字: strokeToWord](#56-%E9%80%9A%E8%BF%87%E7%AC%94%E7%94%BB%E6%95%B0%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-stroketoword)
|
||||||
|
* [5.7 查询拼音详细信息: spellInfo](#57-%E6%9F%A5%E8%AF%A2%E6%8B%BC%E9%9F%B3%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF-spellinfo)
|
||||||
|
* [5.8 其他 api](#58-%E5%85%B6%E4%BB%96-api)
|
||||||
|
+ [5.8.1 .use()](#581-use)
|
||||||
|
+ [5.8.2 .type](#582-type)
|
||||||
|
+ [5.8.3 .check](#583-check)
|
||||||
|
+ [5.8.4 .version](#584-version)
|
||||||
|
+ [5.8.5 .plugins](#585-plugins)
|
||||||
|
- [6 spell stroke 参数](#6-spell-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.1 spell 参数](#61-spell-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.2 stroke 参数](#62-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.3 orderToWord 参数](#63-ordertoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.4 spellToWord 参数](#64-spelltoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.5 strokeToWord 参数](#65-stroketoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.6 使用实例大全:](#66-%E4%BD%BF%E7%94%A8%E5%AE%9E%E4%BE%8B%E5%A4%A7%E5%85%A8)
|
||||||
|
+ [6.6.0 安装使用](#660-%E5%AE%89%E8%A3%85%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [6.6.1 cnchar 基础库功能](#661-cnchar-%E5%9F%BA%E7%A1%80%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.2 cnchar-poly 库功能](#662-cnchar-poly-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.3 cnchar-order 库功能](#663-cnchar-order-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.4 cnchar-trad 库功能](#664-cnchar-trad-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
- [6.6.4.1 convert 字体转换](#6641-convert-%E5%AD%97%E4%BD%93%E8%BD%AC%E6%8D%A2)
|
||||||
|
- [6.6.4.2 spell 和 stroke 方法](#6642-spell-%E5%92%8C-stroke-%E6%96%B9%E6%B3%95)
|
||||||
|
- [7 应用例子](#7-%E5%BA%94%E7%94%A8%E4%BE%8B%E5%AD%90)
|
||||||
|
|
||||||
|
<!-- tocstop -->
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### 前言
|
### 前言
|
||||||
|
|
||||||
感谢同学们对于 cnchar 的支持,由于 cnchar 词库来源于网络,虽然经过了本人的修改的扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 [反馈](https://github.com/theajack/cnchar/issues/8) 给我(或自行修改提交,经过审查无误过后会合到 cnchar 中)
|
感谢同学们对于 cnchar 的支持,由于 cnchar 词库来源于网络,虽然经过了本人的修改和扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 [反馈](https://github.com/theajack/cnchar/issues/new) 给我(或自行修改提交,经过审查无误过后会合到 cnchar 中)
|
||||||
|
|
||||||
[我要反馈错误或缺漏](https://github.com/theajack/cnchar/issues/8)
|
[我要反馈错误或缺漏](https://github.com/theajack/cnchar/issues/new)
|
||||||
|
|
||||||
### 0.快速使用
|
### 0.快速使用
|
||||||
|
|
||||||
|
@ -35,18 +89,14 @@ import cnchar from 'cnchar';
|
||||||
使用 script 标签使用:
|
使用 script 标签使用:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<!--
|
|
||||||
或通过版本号引用
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
-->
|
|
||||||
<script>
|
<script>
|
||||||
'汉字'.spell();
|
'汉字'.spell();
|
||||||
'汉字'.stroke();
|
'汉字'.stroke();
|
||||||
</script>
|
</script>
|
||||||
```
|
```
|
||||||
|
|
||||||
<a href="#64-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
<a href="#66-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
||||||
|
|
||||||
### 1.功能
|
### 1.功能
|
||||||
|
|
||||||
|
@ -54,15 +104,18 @@ import cnchar from 'cnchar';
|
||||||
2. 支持 **多音词**
|
2. 支持 **多音词**
|
||||||
3. 支持 **拼音音调**
|
3. 支持 **拼音音调**
|
||||||
4. 获取汉字 **笔画数** 、支持数组分割
|
4. 获取汉字 **笔画数** 、支持数组分割
|
||||||
5. 获取汉字 **笔画顺序** 、笔画详细名称、通过笔画顺序推出原汉字等
|
5. 获取汉字 **笔画顺序** 、笔画详细名称
|
||||||
6. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
6. 支持可视化 **绘制汉字笔画** 、多种绘制模式可选
|
||||||
7. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
7. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
||||||
8. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
8. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
||||||
9. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
9. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
||||||
10. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
10. 支持 **根据笔画顺序查询** 汉字
|
||||||
11. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
11. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
||||||
12. **多端可用**,可用于 原生浏览器环境、webpack 环境、nodejs 环境...,几乎支持所有 js 能运行的环境
|
12. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
||||||
13. 丰富的配置,按需取用
|
13. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
||||||
|
14. **多端可用**,可用于 **浏览器、nodejs、小程序/小游戏、ReactNative/Weex/Uniapp/Electron、webpack**...,支持所有 js 能运行的环境
|
||||||
|
15. **typescript支持**,支持在typescript中调用
|
||||||
|
16. 丰富的配置,按需取用
|
||||||
|
|
||||||
### 2.概览
|
### 2.概览
|
||||||
|
|
||||||
|
@ -74,6 +127,7 @@ import cnchar from 'cnchar';
|
||||||
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
||||||
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
||||||
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
||||||
|
| cnchar-draw | 绘制笔画库 | 指出可视化绘制汉字,有 normal,animation,stroke,test 四种模式可选,该库仅在浏览器环境下可用 |
|
||||||
|
|
||||||
### 3 安装
|
### 3 安装
|
||||||
|
|
||||||
|
@ -88,7 +142,7 @@ npm i cnchar
|
||||||
安装附加功能库:
|
安装附加功能库:
|
||||||
|
|
||||||
```
|
```
|
||||||
npm i cnchar-poly cnchar-order cnchar-trad
|
npm i cnchar-poly cnchar-order cnchar-trad cnchar-draw
|
||||||
```
|
```
|
||||||
|
|
||||||
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
||||||
|
@ -102,20 +156,23 @@ npm i cnchar-all
|
||||||
#### 3.2 使用 script 引入
|
#### 3.2 使用 script 引入
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
<!-- 或使用版本号引用 -->
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.{version}.min.js"></script>
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
或使用以下cdn,包含了以上五个库
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-all/cnchar.all.min.js"></script>
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
### 4 使用
|
### 4 使用
|
||||||
|
|
||||||
#### 4.1 webpack、babel 等浏览器环境
|
#### 4.1 webpack浏览器环境(有window对象)
|
||||||
|
|
||||||
npm 安装好几个库之后:
|
npm 安装好几个库之后:
|
||||||
|
|
||||||
|
@ -125,6 +182,8 @@ import cnchar from 'cnchar';
|
||||||
import 'cnchar-poly';
|
import 'cnchar-poly';
|
||||||
import 'cnchar-order';
|
import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
|
import 'cnchar-draw';
|
||||||
|
// 插件请按需取用
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -142,6 +201,8 @@ var cnchar = require('cnchar');
|
||||||
var poly = require('cnchar-poly');
|
var poly = require('cnchar-poly');
|
||||||
var order = require('cnchar-order');
|
var order = require('cnchar-order');
|
||||||
var trad = require('cnchar-trad');
|
var trad = require('cnchar-trad');
|
||||||
|
// 插件请按需取用
|
||||||
|
// cnchar-draw 在非浏览器环境下不可使用
|
||||||
cnchar.use(poly, order, trad);
|
cnchar.use(poly, order, trad);
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
|
@ -155,10 +216,11 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script>
|
<script>
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -167,6 +229,8 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
|
||||||
### 5 API
|
### 5 API
|
||||||
|
|
||||||
|
类型声明:[cnchar.d.ts](https://github.com/theajack/cnchar/blob/master/src/main/index.d.ts)
|
||||||
|
|
||||||
#### 5.1 拼音笔画基础 API: spell & stroke
|
#### 5.1 拼音笔画基础 API: spell & stroke
|
||||||
|
|
||||||
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
||||||
|
@ -187,7 +251,93 @@ string.stroke([...args])
|
||||||
|
|
||||||
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
||||||
|
|
||||||
#### 5.2 繁体、简体、火星文互转: convert
|
#### 5.2 可视化绘制汉字: draw
|
||||||
|
|
||||||
|
类型声明:[cnchar.draw.d.ts](https://github.com/theajack/cnchar/blob/master/src/plugin/draw/index.d.ts)
|
||||||
|
|
||||||
|
`cnchar-draw` 库用于支持在浏览器环境下可视化绘制汉字,所以该库仅在浏览器环境下可用。
|
||||||
|
|
||||||
|
##### 5.2.1 使用
|
||||||
|
|
||||||
|
使用方式如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.draw('你好', options); // options 为可选参数, 在5.2.2 种会详细介绍
|
||||||
|
```
|
||||||
|
|
||||||
|
运行结果如下:
|
||||||
|
|
||||||
|
![draw.jpg](https://cdn.jsdelivr.net/gh/theajack/cnchar/assets/readme/draw.jpg)
|
||||||
|
|
||||||
|
该库支持脱离cnchar 独立使用
|
||||||
|
|
||||||
|
```js
|
||||||
|
import draw from 'cnchar-draw';
|
||||||
|
draw('你好')
|
||||||
|
```
|
||||||
|
|
||||||
|
使用cdn引用时,会在window对向上暴露 `CncharDraw` 对象
|
||||||
|
|
||||||
|
##### 5.2.2 参数
|
||||||
|
|
||||||
|
draw 的参数比较繁多,首先需要理解的是,draw 分为四种绘制模式:
|
||||||
|
|
||||||
|
1. normal: 常规绘制
|
||||||
|
2. animation: 带有绘制动画,支持连续绘制、同时绘制、循环绘制
|
||||||
|
3. stroke: 按汉字笔顺单步绘制
|
||||||
|
4. test: 测试模式,用户可以在容器内绘制汉字,cnchar-draw会检测是否绘制正确
|
||||||
|
|
||||||
|
以下是 options 的所有可选参数及描述,使用详情请参考[在线文档](https://theajack.gitee.io/cnchar):
|
||||||
|
|
||||||
|
```ts
|
||||||
|
declare interface DrawOption {
|
||||||
|
el?: string | HTMLElement; // 绘制的容器,支持id和dom,若是不填,会在body后append一个dom作为容器
|
||||||
|
type?: DrawType; // 绘制模式,默认为normal
|
||||||
|
style?: { // 样式类
|
||||||
|
showOutline?: boolean;//: true,
|
||||||
|
showCharacter?: boolean;//: true,
|
||||||
|
currentColor?: string;//: '#b44', // 仅在stroke模式下有效
|
||||||
|
length?: number;//: 60,
|
||||||
|
padding?: number;//: 5, // 数值, 默认 20。 画布的汉字和边缘之间的填充
|
||||||
|
outlineColor?: string;//: '#ddd', // 十六进制字符, 默认 '#DDD'。
|
||||||
|
strokeColor?: string;//: '#555', // 十六进制字符, 默认 '#555'。绘制每个笔划的颜色。
|
||||||
|
radicalColor?: string;//: null, // 十六进制字符, 默认 null。 如果存在偏旁部首数据,则在笔划中绘制偏旁部首的颜色。 如果没有设置,激光将绘制与其他笔划相同的颜色。
|
||||||
|
strokeFadeDuration?: number; //400
|
||||||
|
},
|
||||||
|
line?: { // 背景线条类
|
||||||
|
lineStraight?: boolean;// : true,
|
||||||
|
lineCross?: boolean;// : true,
|
||||||
|
lineWidth?: number;// : 1,
|
||||||
|
lineColor?: string;// : '#ddd',
|
||||||
|
lineDash?: boolean;// : true,
|
||||||
|
border?: boolean;// : true,
|
||||||
|
borderWidth?: number;// : 1,
|
||||||
|
borderColor?: string;// : '#ccc',
|
||||||
|
borderDash?: boolean;// : false,
|
||||||
|
},
|
||||||
|
animation?: {
|
||||||
|
strokeAnimationSpeed?: number;// : 1, // 数值, 默认 1。 绘制每个笔划的速度必须大于0。增加此数字可以更快地绘制笔划,减少绘制笔划的速度更慢。
|
||||||
|
delayBetweenStrokes?: number;// : 1000, // 数值, 默认 1000。 动画进行中每个笔画之间的间隔时间(以毫秒为单位)。
|
||||||
|
delayBetweenLoops?: number;// : 200, // 数值, 默认 2000。 循环动画时每个动画循环之间的时间(以毫秒为单位)。
|
||||||
|
autoAnimate?: boolean;// : true,
|
||||||
|
animateComplete?: Function;// : () => {},
|
||||||
|
stepByStep?: boolean;// : true,
|
||||||
|
loopAnimate?: boolean;// : false,
|
||||||
|
},
|
||||||
|
test?: {
|
||||||
|
strokeHighlightSpeed?: number;// : 20, // 数值, 默认 20。 在测验中给出提示时突出显示每个笔划的速度必须大于0。增加此数字以突出显示更快,减少以突出显示更慢。
|
||||||
|
highlightColor?: number;// : '#aaf', // 十六进制字符, 默认 '#AAF'。 用于在测验中突出显示的颜色。
|
||||||
|
drawingColor?: number;// : '#333', // 十六进制字符, 默认 '#333'。 测验期间绘制的线条颜色。
|
||||||
|
drawingWidth?: number;// : 4, // 数值, 默认 4。 进行测验时绘制的线条宽度。
|
||||||
|
showHintAfterMisses?: number;// : 3, // 整数, 默认 3 中风高亮提示之前的未命中数被给予用户。 设置为 false 以禁用。 创建测验时也可以设置此项。
|
||||||
|
highlightOnComplete?: number;// : true, // 布尔值, 默认 true。 控制当用户完成绘制整个字符时,测验是否会短暂突出显示字符。 创建测验时也可以设置此项。
|
||||||
|
highlightCompleteColor?: number;// : null, // 十六进制字符, 默认 null。 在测验中突出显示字符时使用的颜色。 如果未设置,则将使用highlightColor。 仅当highlightOnComplete为true时才相关。
|
||||||
|
onTestStatus?(args: TestStatus):void;// : null, // ({index, status, data})=>{}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.3 繁体、简体、火星文互转: convert
|
||||||
|
|
||||||
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
||||||
|
|
||||||
|
@ -209,7 +359,7 @@ string.convertSparkToSimple();
|
||||||
string.convertSparkToTrad();
|
string.convertSparkToTrad();
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.3 笔画序列推出原汉字: orderToWord
|
#### 5.4 笔画序列推出原汉字: orderToWord
|
||||||
|
|
||||||
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
||||||
|
|
||||||
|
@ -284,7 +434,7 @@ cnchar.orderToWord(['横', '撇', '捺'], 'start', 'simple');
|
||||||
|
|
||||||
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
||||||
|
|
||||||
#### 5.4 通过拼音查询原汉字: spellToWord
|
#### 5.5 通过拼音查询原汉字: spellToWord
|
||||||
|
|
||||||
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -308,7 +458,7 @@ spell 表示拼音,可以使用音调字母或音调数标方式:
|
||||||
|
|
||||||
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
||||||
|
|
||||||
#### 5.5 通过笔画数查询原汉字: strokeToWord
|
#### 5.6 通过笔画数查询原汉字: strokeToWord
|
||||||
|
|
||||||
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -324,7 +474,7 @@ cnchar.strokeToWord(25, 'simple'); // 返回 '鬣馕囔戆攮纛'
|
||||||
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.6 查询拼音详细信息: spellInfo
|
#### 5.7 查询拼音详细信息: spellInfo
|
||||||
|
|
||||||
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
||||||
|
|
||||||
|
@ -358,9 +508,9 @@ cnchar.spellInfo.tones;
|
||||||
// n 的一声使用 * 代替
|
// n 的一声使用 * 代替
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.7 其他 api
|
#### 5.8 其他 api
|
||||||
|
|
||||||
##### 5.7.1 .use()
|
##### 5.8.1 .use()
|
||||||
|
|
||||||
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
||||||
|
|
||||||
|
@ -389,7 +539,7 @@ import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.2 .type
|
##### 5.8.2 .type
|
||||||
|
|
||||||
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
||||||
|
|
||||||
|
@ -413,7 +563,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
|
|
||||||
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
||||||
|
|
||||||
##### 5.7.3 .check
|
##### 5.8.3 .check
|
||||||
|
|
||||||
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
||||||
|
|
||||||
|
@ -423,7 +573,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
cnchar.check = false; // 关闭参数校验
|
cnchar.check = false; // 关闭参数校验
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.4 .version
|
##### 5.8.4 .version
|
||||||
|
|
||||||
获取当前版本:
|
获取当前版本:
|
||||||
|
|
||||||
|
@ -431,7 +581,7 @@ cnchar.check = false; // 关闭参数校验
|
||||||
var version = cnchar.version; // string 类型
|
var version = cnchar.version; // string 类型
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.5 .plugins
|
##### 5.8.5 .plugins
|
||||||
|
|
||||||
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
||||||
|
|
||||||
|
@ -567,7 +717,7 @@ import cnchar from 'cnchar';
|
||||||
script 标签引用 方式
|
script 标签引用 方式
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"></script>
|
||||||
<script>
|
<script>
|
||||||
// do something
|
// do something
|
||||||
</script>
|
</script>
|
||||||
|
@ -723,3 +873,7 @@ cnchar.convert.sparkToTrad('①个亾');
|
||||||
### 7 应用例子
|
### 7 应用例子
|
||||||
|
|
||||||
[汉字打字游戏](https://www.theajack.com/type/)
|
[汉字打字游戏](https://www.theajack.com/type/)
|
||||||
|
|
||||||
|
**致谢**
|
||||||
|
|
||||||
|
`cnchar-draw` 库功能基于 [hanzi-writer](https://github.com/chanind/hanzi-writer), 特此表示感谢!
|
||||||
|
|
File diff suppressed because one or more lines are too long
|
@ -1,14 +1,18 @@
|
||||||
"use strict";
|
"use strict";
|
||||||
|
|
||||||
function _typeof(obj) { if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
|
function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
|
||||||
|
|
||||||
function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _nonIterableSpread(); }
|
function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
|
||||||
|
|
||||||
function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance"); }
|
function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
|
||||||
|
|
||||||
function _iterableToArray(iter) { if (Symbol.iterator in Object(iter) || Object.prototype.toString.call(iter) === "[object Arguments]") return Array.from(iter); }
|
function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
|
||||||
|
|
||||||
function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) { for (var i = 0, arr2 = new Array(arr.length); i < arr.length; i++) { arr2[i] = arr[i]; } return arr2; } }
|
function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && Symbol.iterator in Object(iter)) return Array.from(iter); }
|
||||||
|
|
||||||
|
function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
|
||||||
|
|
||||||
|
function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
|
||||||
|
|
||||||
var polyPhrases = require('./polyphone-phrase-simple.json');
|
var polyPhrases = require('./polyphone-phrase-simple.json');
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "cnchar-poly",
|
"name": "cnchar-poly",
|
||||||
"version": "2.0.9",
|
"version": "2.1.0",
|
||||||
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"unpkg": "cnchar.poly.min.js",
|
"unpkg": "cnchar.poly.min.js",
|
||||||
|
|
|
@ -1,22 +1,76 @@
|
||||||
# [cnchar](https://github.com/theajack/cnchar)
|
# [cnchar](https://github.com/theajack/cnchar) <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/github/stars/theajack/cnchar.svg?style=social" alt="star"></a> <a href="https://theajack.gitee.io"><img src="https://img.shields.io/badge/author-theajack-blue.svg?style=social" alt="Author"></a>
|
||||||
|
|
||||||
#### [theajack](https://www.theajack.com/)
|
|
||||||
|
<p>
|
||||||
|
<a href="https://www.npmjs.com/package/cnchar"><img src="https://img.shields.io/npm/v/cnchar.svg" alt="Version"></a>
|
||||||
|
<a href="https://npmcharts.com/compare/cnchar?minimal=true"><img src="https://img.shields.io/npm/dm/cnchar.svg" alt="Downloads"></a>
|
||||||
|
<a href="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"><img src="https://img.shields.io/bundlephobia/minzip/cnchar.svg" alt="Size"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/blob/master/LICENSE"><img src="https://img.shields.io/npm/l/cnchar.svg" alt="License"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/search?l=javascript"><img src="https://img.shields.io/github/languages/top/theajack/cnchar.svg" alt="TopLang"></a>
|
||||||
|
<a href="https://github.com/theajack/cnchar/issues"><img src="https://img.shields.io/github/issues-closed/theajack/cnchar.svg" alt="issue"></a>
|
||||||
|
<!-- <a href="https://www.github.com/theajack/cnchar"><img src="https://img.shields.io/librariesio/dependent-repos/npm/cnchar.svg" alt="Dependent"></a> -->
|
||||||
|
</p>
|
||||||
|
|
||||||
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
### 🚀 好用小巧、功能全面的汉字拼音笔画 js 库
|
||||||
|
|
||||||
**<a href="#64-使用实例大全">快速上手</a> | [在线试用](https://www.theajack.com/cnchar/) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://www.theajack.com/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/8)**
|
**<a href="#66-使用实例大全">快速上手</a> | [在线试用/文档](https://theajack.gitee.io/cnchar) | [更新日志](https://github.com/theajack/cnchar/blob/master/helper/version.md) | [应用:打字游戏](https://theajack.gitee.io/type/) | [反馈错误/缺漏](https://github.com/theajack/cnchar/issues/new)**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
[TOC]
|
<!-- toc -->
|
||||||
|
|
||||||
|
- [前言](#%E5%89%8D%E8%A8%80)
|
||||||
|
- [0.快速使用](#0%E5%BF%AB%E9%80%9F%E4%BD%BF%E7%94%A8)
|
||||||
|
- [1.功能](#1%E5%8A%9F%E8%83%BD)
|
||||||
|
- [2.概览](#2%E6%A6%82%E8%A7%88)
|
||||||
|
- [3 安装](#3-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.1 使用 npm 安装](#31-%E4%BD%BF%E7%94%A8-npm-%E5%AE%89%E8%A3%85)
|
||||||
|
* [3.2 使用 script 引入](#32-%E4%BD%BF%E7%94%A8-script-%E5%BC%95%E5%85%A5)
|
||||||
|
- [4 使用](#4-%E4%BD%BF%E7%94%A8)
|
||||||
|
* [4.1 webpack浏览器环境(有window对象)](#41-webpack%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83%E6%9C%89window%E5%AF%B9%E8%B1%A1)
|
||||||
|
* [4.2 nodejs 等非浏览器环境](#42-nodejs-%E7%AD%89%E9%9D%9E%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
* [4.3 原生浏览器环境](#43-%E5%8E%9F%E7%94%9F%E6%B5%8F%E8%A7%88%E5%99%A8%E7%8E%AF%E5%A2%83)
|
||||||
|
- [5 API](#5-api)
|
||||||
|
* [5.1 拼音笔画基础 API: spell & stroke](#51-%E6%8B%BC%E9%9F%B3%E7%AC%94%E7%94%BB%E5%9F%BA%E7%A1%80-api-spell--stroke)
|
||||||
|
* [5.2 可视化绘制汉字: draw](#52-%E5%8F%AF%E8%A7%86%E5%8C%96%E7%BB%98%E5%88%B6%E6%B1%89%E5%AD%97-draw)
|
||||||
|
+ [5.2.1 使用](#521-%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [5.2.2 参数](#522-%E5%8F%82%E6%95%B0)
|
||||||
|
* [5.3 繁体、简体、火星文互转: convert](#53-%E7%B9%81%E4%BD%93%E7%AE%80%E4%BD%93%E7%81%AB%E6%98%9F%E6%96%87%E4%BA%92%E8%BD%AC-convert)
|
||||||
|
* [5.4 笔画序列推出原汉字: orderToWord](#54-%E7%AC%94%E7%94%BB%E5%BA%8F%E5%88%97%E6%8E%A8%E5%87%BA%E5%8E%9F%E6%B1%89%E5%AD%97-ordertoword)
|
||||||
|
* [5.5 通过拼音查询原汉字: spellToWord](#55-%E9%80%9A%E8%BF%87%E6%8B%BC%E9%9F%B3%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-spelltoword)
|
||||||
|
* [5.6 通过笔画数查询原汉字: strokeToWord](#56-%E9%80%9A%E8%BF%87%E7%AC%94%E7%94%BB%E6%95%B0%E6%9F%A5%E8%AF%A2%E5%8E%9F%E6%B1%89%E5%AD%97-stroketoword)
|
||||||
|
* [5.7 查询拼音详细信息: spellInfo](#57-%E6%9F%A5%E8%AF%A2%E6%8B%BC%E9%9F%B3%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF-spellinfo)
|
||||||
|
* [5.8 其他 api](#58-%E5%85%B6%E4%BB%96-api)
|
||||||
|
+ [5.8.1 .use()](#581-use)
|
||||||
|
+ [5.8.2 .type](#582-type)
|
||||||
|
+ [5.8.3 .check](#583-check)
|
||||||
|
+ [5.8.4 .version](#584-version)
|
||||||
|
+ [5.8.5 .plugins](#585-plugins)
|
||||||
|
- [6 spell stroke 参数](#6-spell-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.1 spell 参数](#61-spell-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.2 stroke 参数](#62-stroke-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.3 orderToWord 参数](#63-ordertoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.4 spellToWord 参数](#64-spelltoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.5 strokeToWord 参数](#65-stroketoword-%E5%8F%82%E6%95%B0)
|
||||||
|
* [6.6 使用实例大全:](#66-%E4%BD%BF%E7%94%A8%E5%AE%9E%E4%BE%8B%E5%A4%A7%E5%85%A8)
|
||||||
|
+ [6.6.0 安装使用](#660-%E5%AE%89%E8%A3%85%E4%BD%BF%E7%94%A8)
|
||||||
|
+ [6.6.1 cnchar 基础库功能](#661-cnchar-%E5%9F%BA%E7%A1%80%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.2 cnchar-poly 库功能](#662-cnchar-poly-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.3 cnchar-order 库功能](#663-cnchar-order-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
+ [6.6.4 cnchar-trad 库功能](#664-cnchar-trad-%E5%BA%93%E5%8A%9F%E8%83%BD)
|
||||||
|
- [6.6.4.1 convert 字体转换](#6641-convert-%E5%AD%97%E4%BD%93%E8%BD%AC%E6%8D%A2)
|
||||||
|
- [6.6.4.2 spell 和 stroke 方法](#6642-spell-%E5%92%8C-stroke-%E6%96%B9%E6%B3%95)
|
||||||
|
- [7 应用例子](#7-%E5%BA%94%E7%94%A8%E4%BE%8B%E5%AD%90)
|
||||||
|
|
||||||
|
<!-- tocstop -->
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### 前言
|
### 前言
|
||||||
|
|
||||||
感谢同学们对于 cnchar 的支持,由于 cnchar 词库来源于网络,虽然经过了本人的修改的扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 [反馈](https://github.com/theajack/cnchar/issues/8) 给我(或自行修改提交,经过审查无误过后会合到 cnchar 中)
|
感谢同学们对于 cnchar 的支持,由于 cnchar 词库来源于网络,虽然经过了本人的修改和扩充,但是还是难免有错误与缺漏之处,希望大家可以将使用中发现的错误与缺漏之处 [反馈](https://github.com/theajack/cnchar/issues/new) 给我(或自行修改提交,经过审查无误过后会合到 cnchar 中)
|
||||||
|
|
||||||
[我要反馈错误或缺漏](https://github.com/theajack/cnchar/issues/8)
|
[我要反馈错误或缺漏](https://github.com/theajack/cnchar/issues/new)
|
||||||
|
|
||||||
### 0.快速使用
|
### 0.快速使用
|
||||||
|
|
||||||
|
@ -35,18 +89,14 @@ import cnchar from 'cnchar';
|
||||||
使用 script 标签使用:
|
使用 script 标签使用:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<!--
|
|
||||||
或通过版本号引用
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
-->
|
|
||||||
<script>
|
<script>
|
||||||
'汉字'.spell();
|
'汉字'.spell();
|
||||||
'汉字'.stroke();
|
'汉字'.stroke();
|
||||||
</script>
|
</script>
|
||||||
```
|
```
|
||||||
|
|
||||||
<a href="#64-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
<a href="#66-使用实例大全">更多详细使用示例</a> | <a href="#6-spell-stroke-参数">参数详细介绍</a>
|
||||||
|
|
||||||
### 1.功能
|
### 1.功能
|
||||||
|
|
||||||
|
@ -54,15 +104,18 @@ import cnchar from 'cnchar';
|
||||||
2. 支持 **多音词**
|
2. 支持 **多音词**
|
||||||
3. 支持 **拼音音调**
|
3. 支持 **拼音音调**
|
||||||
4. 获取汉字 **笔画数** 、支持数组分割
|
4. 获取汉字 **笔画数** 、支持数组分割
|
||||||
5. 获取汉字 **笔画顺序** 、笔画详细名称、通过笔画顺序推出原汉字等
|
5. 获取汉字 **笔画顺序** 、笔画详细名称
|
||||||
6. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
6. 支持可视化 **绘制汉字笔画** 、多种绘制模式可选
|
||||||
7. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
7. 支持 **简体字** 、 **繁体字** 、 **火星文** 互转
|
||||||
8. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
8. 支持 **查找** 某拼音的所有 **汉字** ,繁体字,多音字
|
||||||
9. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
9. 支持 **查找** 指定笔画数的所有 **汉字** ,繁体字
|
||||||
10. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
10. 支持 **根据笔画顺序查询** 汉字
|
||||||
11. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
11. 支持 **查询拼音的信息**,包含声母、韵母、音调、音调位置的等
|
||||||
12. **多端可用**,可用于 原生浏览器环境、webpack 环境、nodejs 环境...,几乎支持所有 js 能运行的环境
|
12. 支持 **繁体字** 拼音、笔画数及以上所有功能,实现和简体字一样的功能
|
||||||
13. 丰富的配置,按需取用
|
13. **体积小**,min 版本仅 46 kb,zip 版本 34 kb (含有大量汉字拼音字典)
|
||||||
|
14. **多端可用**,可用于 **浏览器、nodejs、小程序/小游戏、ReactNative/Weex/Uniapp/Electron、webpack**...,支持所有 js 能运行的环境
|
||||||
|
15. **typescript支持**,支持在typescript中调用
|
||||||
|
16. 丰富的配置,按需取用
|
||||||
|
|
||||||
### 2.概览
|
### 2.概览
|
||||||
|
|
||||||
|
@ -74,6 +127,7 @@ import cnchar from 'cnchar';
|
||||||
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
| cnchar-poly | 多音词库 | 含有识别多音词功能 |
|
||||||
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
| cnchar-order | 笔画顺序库 | 含有识别笔画顺序、笔画名称、笔画形状等功能 |
|
||||||
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
| cnchar-trad | 繁体字库 | 支持繁体、火星、简体互转,支持繁体拼音笔画多音字全功能 |
|
||||||
|
| cnchar-draw | 绘制笔画库 | 指出可视化绘制汉字,有 normal,animation,stroke,test 四种模式可选,该库仅在浏览器环境下可用 |
|
||||||
|
|
||||||
### 3 安装
|
### 3 安装
|
||||||
|
|
||||||
|
@ -88,7 +142,7 @@ npm i cnchar
|
||||||
安装附加功能库:
|
安装附加功能库:
|
||||||
|
|
||||||
```
|
```
|
||||||
npm i cnchar-poly cnchar-order cnchar-trad
|
npm i cnchar-poly cnchar-order cnchar-trad cnchar-draw
|
||||||
```
|
```
|
||||||
|
|
||||||
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
当然您也可以按需安装其中的几个,但是 `cnchar` 这个基础库是必须安装的
|
||||||
|
@ -102,20 +156,23 @@ npm i cnchar-all
|
||||||
#### 3.2 使用 script 引入
|
#### 3.2 使用 script 引入
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
<!-- 或使用版本号引用 -->
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.{version}.min.js"></script>
|
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.{version}.min.js"></script>
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
或使用以下cdn,包含了以上五个库
|
||||||
|
|
||||||
|
```html
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-all/cnchar.all.min.js"></script>
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
### 4 使用
|
### 4 使用
|
||||||
|
|
||||||
#### 4.1 webpack、babel 等浏览器环境
|
#### 4.1 webpack浏览器环境(有window对象)
|
||||||
|
|
||||||
npm 安装好几个库之后:
|
npm 安装好几个库之后:
|
||||||
|
|
||||||
|
@ -125,6 +182,8 @@ import cnchar from 'cnchar';
|
||||||
import 'cnchar-poly';
|
import 'cnchar-poly';
|
||||||
import 'cnchar-order';
|
import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
|
import 'cnchar-draw';
|
||||||
|
// 插件请按需取用
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -142,6 +201,8 @@ var cnchar = require('cnchar');
|
||||||
var poly = require('cnchar-poly');
|
var poly = require('cnchar-poly');
|
||||||
var order = require('cnchar-order');
|
var order = require('cnchar-order');
|
||||||
var trad = require('cnchar-trad');
|
var trad = require('cnchar-trad');
|
||||||
|
// 插件请按需取用
|
||||||
|
// cnchar-draw 在非浏览器环境下不可使用
|
||||||
cnchar.use(poly, order, trad);
|
cnchar.use(poly, order, trad);
|
||||||
|
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
|
@ -155,10 +216,11 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
原生浏览器环境就需要使用 script 标签引入 js 文件:
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.poly.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.order.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.trad.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
|
||||||
|
<script src="https://cdn.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
|
||||||
<script>
|
<script>
|
||||||
console.log('汉字'.spell()); // prototype 方式调用
|
console.log('汉字'.spell()); // prototype 方式调用
|
||||||
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
@ -167,6 +229,8 @@ console.log(cnchar.spell('汉字')); // cnchar api 调用
|
||||||
|
|
||||||
### 5 API
|
### 5 API
|
||||||
|
|
||||||
|
类型声明:[cnchar.d.ts](https://github.com/theajack/cnchar/blob/master/src/main/index.d.ts)
|
||||||
|
|
||||||
#### 5.1 拼音笔画基础 API: spell & stroke
|
#### 5.1 拼音笔画基础 API: spell & stroke
|
||||||
|
|
||||||
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
为了尽可能使 api 使用简单,该库设计了两个主要的非常简洁的 api,并保证调用方式一致:
|
||||||
|
@ -187,7 +251,93 @@ string.stroke([...args])
|
||||||
|
|
||||||
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
关键在于可选参数的配置,参数配置将在<a href="#user-content-6-spell-stroke-参数">第六章</a>单独介绍
|
||||||
|
|
||||||
#### 5.2 繁体、简体、火星文互转: convert
|
#### 5.2 可视化绘制汉字: draw
|
||||||
|
|
||||||
|
类型声明:[cnchar.draw.d.ts](https://github.com/theajack/cnchar/blob/master/src/plugin/draw/index.d.ts)
|
||||||
|
|
||||||
|
`cnchar-draw` 库用于支持在浏览器环境下可视化绘制汉字,所以该库仅在浏览器环境下可用。
|
||||||
|
|
||||||
|
##### 5.2.1 使用
|
||||||
|
|
||||||
|
使用方式如下:
|
||||||
|
|
||||||
|
```js
|
||||||
|
cnchar.draw('你好', options); // options 为可选参数, 在5.2.2 种会详细介绍
|
||||||
|
```
|
||||||
|
|
||||||
|
运行结果如下:
|
||||||
|
|
||||||
|
![draw.jpg](https://cdn.jsdelivr.net/gh/theajack/cnchar/assets/readme/draw.jpg)
|
||||||
|
|
||||||
|
该库支持脱离cnchar 独立使用
|
||||||
|
|
||||||
|
```js
|
||||||
|
import draw from 'cnchar-draw';
|
||||||
|
draw('你好')
|
||||||
|
```
|
||||||
|
|
||||||
|
使用cdn引用时,会在window对向上暴露 `CncharDraw` 对象
|
||||||
|
|
||||||
|
##### 5.2.2 参数
|
||||||
|
|
||||||
|
draw 的参数比较繁多,首先需要理解的是,draw 分为四种绘制模式:
|
||||||
|
|
||||||
|
1. normal: 常规绘制
|
||||||
|
2. animation: 带有绘制动画,支持连续绘制、同时绘制、循环绘制
|
||||||
|
3. stroke: 按汉字笔顺单步绘制
|
||||||
|
4. test: 测试模式,用户可以在容器内绘制汉字,cnchar-draw会检测是否绘制正确
|
||||||
|
|
||||||
|
以下是 options 的所有可选参数及描述,使用详情请参考[在线文档](https://theajack.gitee.io/cnchar):
|
||||||
|
|
||||||
|
```ts
|
||||||
|
declare interface DrawOption {
|
||||||
|
el?: string | HTMLElement; // 绘制的容器,支持id和dom,若是不填,会在body后append一个dom作为容器
|
||||||
|
type?: DrawType; // 绘制模式,默认为normal
|
||||||
|
style?: { // 样式类
|
||||||
|
showOutline?: boolean;//: true,
|
||||||
|
showCharacter?: boolean;//: true,
|
||||||
|
currentColor?: string;//: '#b44', // 仅在stroke模式下有效
|
||||||
|
length?: number;//: 60,
|
||||||
|
padding?: number;//: 5, // 数值, 默认 20。 画布的汉字和边缘之间的填充
|
||||||
|
outlineColor?: string;//: '#ddd', // 十六进制字符, 默认 '#DDD'。
|
||||||
|
strokeColor?: string;//: '#555', // 十六进制字符, 默认 '#555'。绘制每个笔划的颜色。
|
||||||
|
radicalColor?: string;//: null, // 十六进制字符, 默认 null。 如果存在偏旁部首数据,则在笔划中绘制偏旁部首的颜色。 如果没有设置,激光将绘制与其他笔划相同的颜色。
|
||||||
|
strokeFadeDuration?: number; //400
|
||||||
|
},
|
||||||
|
line?: { // 背景线条类
|
||||||
|
lineStraight?: boolean;// : true,
|
||||||
|
lineCross?: boolean;// : true,
|
||||||
|
lineWidth?: number;// : 1,
|
||||||
|
lineColor?: string;// : '#ddd',
|
||||||
|
lineDash?: boolean;// : true,
|
||||||
|
border?: boolean;// : true,
|
||||||
|
borderWidth?: number;// : 1,
|
||||||
|
borderColor?: string;// : '#ccc',
|
||||||
|
borderDash?: boolean;// : false,
|
||||||
|
},
|
||||||
|
animation?: {
|
||||||
|
strokeAnimationSpeed?: number;// : 1, // 数值, 默认 1。 绘制每个笔划的速度必须大于0。增加此数字可以更快地绘制笔划,减少绘制笔划的速度更慢。
|
||||||
|
delayBetweenStrokes?: number;// : 1000, // 数值, 默认 1000。 动画进行中每个笔画之间的间隔时间(以毫秒为单位)。
|
||||||
|
delayBetweenLoops?: number;// : 200, // 数值, 默认 2000。 循环动画时每个动画循环之间的时间(以毫秒为单位)。
|
||||||
|
autoAnimate?: boolean;// : true,
|
||||||
|
animateComplete?: Function;// : () => {},
|
||||||
|
stepByStep?: boolean;// : true,
|
||||||
|
loopAnimate?: boolean;// : false,
|
||||||
|
},
|
||||||
|
test?: {
|
||||||
|
strokeHighlightSpeed?: number;// : 20, // 数值, 默认 20。 在测验中给出提示时突出显示每个笔划的速度必须大于0。增加此数字以突出显示更快,减少以突出显示更慢。
|
||||||
|
highlightColor?: number;// : '#aaf', // 十六进制字符, 默认 '#AAF'。 用于在测验中突出显示的颜色。
|
||||||
|
drawingColor?: number;// : '#333', // 十六进制字符, 默认 '#333'。 测验期间绘制的线条颜色。
|
||||||
|
drawingWidth?: number;// : 4, // 数值, 默认 4。 进行测验时绘制的线条宽度。
|
||||||
|
showHintAfterMisses?: number;// : 3, // 整数, 默认 3 中风高亮提示之前的未命中数被给予用户。 设置为 false 以禁用。 创建测验时也可以设置此项。
|
||||||
|
highlightOnComplete?: number;// : true, // 布尔值, 默认 true。 控制当用户完成绘制整个字符时,测验是否会短暂突出显示字符。 创建测验时也可以设置此项。
|
||||||
|
highlightCompleteColor?: number;// : null, // 十六进制字符, 默认 null。 在测验中突出显示字符时使用的颜色。 如果未设置,则将使用highlightColor。 仅当highlightOnComplete为true时才相关。
|
||||||
|
onTestStatus?(args: TestStatus):void;// : null, // ({index, status, data})=>{}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 5.3 繁体、简体、火星文互转: convert
|
||||||
|
|
||||||
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
当引入 `cnchar-trad` 之后,cnchar 就具备了繁体、简体、火星文互转功能,使用 `cnchar.convert` 对象上的方法,你就可以使用这个功能
|
||||||
|
|
||||||
|
@ -209,7 +359,7 @@ string.convertSparkToSimple();
|
||||||
string.convertSparkToTrad();
|
string.convertSparkToTrad();
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.3 笔画序列推出原汉字: orderToWord
|
#### 5.4 笔画序列推出原汉字: orderToWord
|
||||||
|
|
||||||
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
当引入 `cnchar-order` 功能库(版本 2.0.2 及以上)之后,cnchar 就支持了根据笔画名称序列推出原汉字的功能,使用方式如下:
|
||||||
|
|
||||||
|
@ -284,7 +434,7 @@ cnchar.orderToWord(['横', '撇', '捺'], 'start', 'simple');
|
||||||
|
|
||||||
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
如果输入的笔画不在 `cnchar.orderToWord.orders` 内,则该方法会打印一个错误提示哪些笔画有误,并返回一个空数组。
|
||||||
|
|
||||||
#### 5.4 通过拼音查询原汉字: spellToWord
|
#### 5.5 通过拼音查询原汉字: spellToWord
|
||||||
|
|
||||||
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
`spellToWord` 方法用于根据拼音查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -308,7 +458,7 @@ spell 表示拼音,可以使用音调字母或音调数标方式:
|
||||||
|
|
||||||
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
ü 可以使用 v 表示,例:`lü 等价于 lv`
|
||||||
|
|
||||||
#### 5.5 通过笔画数查询原汉字: strokeToWord
|
#### 5.6 通过笔画数查询原汉字: strokeToWord
|
||||||
|
|
||||||
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
`strokeToWord` 方法用于根据笔画数查询符合要求的汉字,用法如下:
|
||||||
|
|
||||||
|
@ -324,7 +474,7 @@ cnchar.strokeToWord(25, 'simple'); // 返回 '鬣馕囔戆攮纛'
|
||||||
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
cnchar.strokeToWord(1, 'array'); // 返回 ['一', '乙']
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.6 查询拼音详细信息: spellInfo
|
#### 5.7 查询拼音详细信息: spellInfo
|
||||||
|
|
||||||
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
`spellInfo` 方法用于查询拼音的详细信息,用法如下:
|
||||||
|
|
||||||
|
@ -358,9 +508,9 @@ cnchar.spellInfo.tones;
|
||||||
// n 的一声使用 * 代替
|
// n 的一声使用 * 代替
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.7 其他 api
|
#### 5.8 其他 api
|
||||||
|
|
||||||
##### 5.7.1 .use()
|
##### 5.8.1 .use()
|
||||||
|
|
||||||
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
这个 api 的功能是显式启用 `poly`、`order`、`trad` 三个功能库
|
||||||
|
|
||||||
|
@ -389,7 +539,7 @@ import 'cnchar-order';
|
||||||
import 'cnchar-trad';
|
import 'cnchar-trad';
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.2 .type
|
##### 5.8.2 .type
|
||||||
|
|
||||||
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
type 对象用户获取当前可用的 `spell` 、 `stroke` 、 `orderToWord` 、`spellToWord`、`strokeToWord` 参数类型:
|
||||||
|
|
||||||
|
@ -413,7 +563,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
|
|
||||||
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
具体用法<a href="#user-content-6-spell-stroke-参数">第六章</a>讲到
|
||||||
|
|
||||||
##### 5.7.3 .check
|
##### 5.8.3 .check
|
||||||
|
|
||||||
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
该值是一个 布尔类型,用于控制是否开启参数校验,默认值为 true
|
||||||
|
|
||||||
|
@ -423,7 +573,7 @@ strokeToWordArg 最多可用值: `['simple','trad','array']`
|
||||||
cnchar.check = false; // 关闭参数校验
|
cnchar.check = false; // 关闭参数校验
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.4 .version
|
##### 5.8.4 .version
|
||||||
|
|
||||||
获取当前版本:
|
获取当前版本:
|
||||||
|
|
||||||
|
@ -431,7 +581,7 @@ cnchar.check = false; // 关闭参数校验
|
||||||
var version = cnchar.version; // string 类型
|
var version = cnchar.version; // string 类型
|
||||||
```
|
```
|
||||||
|
|
||||||
##### 5.7.5 .plugins
|
##### 5.8.5 .plugins
|
||||||
|
|
||||||
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
当前使用的功能库列表,最多的情况为 `["order", "trad", "poly"]`
|
||||||
|
|
||||||
|
@ -567,7 +717,7 @@ import cnchar from 'cnchar';
|
||||||
script 标签引用 方式
|
script 标签引用 方式
|
||||||
|
|
||||||
```html
|
```html
|
||||||
<script src="https://www.theajack.com/cnchar/dist/cnchar.latest.min.js"></script>
|
<script src="https://cdn.jsdelivr.net/gh/theajack/cnchar/dist/cnchar.latest.min.js"></script>
|
||||||
<script>
|
<script>
|
||||||
// do something
|
// do something
|
||||||
</script>
|
</script>
|
||||||
|
@ -723,3 +873,7 @@ cnchar.convert.sparkToTrad('①个亾');
|
||||||
### 7 应用例子
|
### 7 应用例子
|
||||||
|
|
||||||
[汉字打字游戏](https://www.theajack.com/type/)
|
[汉字打字游戏](https://www.theajack.com/type/)
|
||||||
|
|
||||||
|
**致谢**
|
||||||
|
|
||||||
|
`cnchar-draw` 库功能基于 [hanzi-writer](https://github.com/chanind/hanzi-writer), 特此表示感谢!
|
||||||
|
|
File diff suppressed because one or more lines are too long
|
@ -1,18 +1,24 @@
|
||||||
"use strict";
|
"use strict";
|
||||||
|
|
||||||
function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _nonIterableSpread(); }
|
function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
|
||||||
|
|
||||||
function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance"); }
|
function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
|
||||||
|
|
||||||
function _iterableToArray(iter) { if (Symbol.iterator in Object(iter) || Object.prototype.toString.call(iter) === "[object Arguments]") return Array.from(iter); }
|
function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(n); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
|
||||||
|
|
||||||
function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) { for (var i = 0, arr2 = new Array(arr.length); i < arr.length; i++) { arr2[i] = arr[i]; } return arr2; } }
|
function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && Symbol.iterator in Object(iter)) return Array.from(iter); }
|
||||||
|
|
||||||
function _typeof(obj) { if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
|
function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
|
||||||
|
|
||||||
|
function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; }
|
||||||
|
|
||||||
|
function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
|
||||||
|
|
||||||
var countDict = require('./stroke-count-fan.json');
|
var countDict = require('./stroke-count-fan.json');
|
||||||
|
|
||||||
var orderDict = require('./stroke-order-fan.json');
|
var orderDict = require('./stroke-order-fan.json'); // 简-烦 一对多
|
||||||
|
// https://blog.csdn.net/e15273/article/details/79954700
|
||||||
|
|
||||||
|
|
||||||
var convert = require('./converter');
|
var convert = require('./converter');
|
||||||
|
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
{
|
{
|
||||||
"name": "cnchar-trad",
|
"name": "cnchar-trad",
|
||||||
"version": "2.0.9",
|
"version": "2.1.0",
|
||||||
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
"description": "好用小巧、功能全面的汉字拼音笔画js库,支持多音字、繁体字、火星文",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"unpkg": "cnchar.trad.min.js",
|
"unpkg": "cnchar.trad.min.js",
|
||||||
|
|
|
@ -30,7 +30,7 @@
|
||||||
"build:npm": "node ./helper/build-npm.js",
|
"build:npm": "node ./helper/build-npm.js",
|
||||||
"start": "webpack-dev-server --open --config webpack-config/dev.js",
|
"start": "webpack-dev-server --open --config webpack-config/dev.js",
|
||||||
"dev": "webpack-dev-server --open --config webpack-config/dev.js",
|
"dev": "webpack-dev-server --open --config webpack-config/dev.js",
|
||||||
"publish": "npm publish npm/cnchar && npm publish npm/order && npm publish npm/poly && npm publish npm/trad && npm publish npm/cnchar-all && npm publish npm/hanzi-util-base && npm publish npm/hanzi-util",
|
"publish": "npm publish npm/cnchar && npm publish npm/order && npm publish npm/poly && npm publish npm/trad && npm publish npm/draw && npm publish npm/all && npm publish npm/hanzi-util-base && npm publish npm/hanzi-util",
|
||||||
"lint": "eslint src --ext js",
|
"lint": "eslint src --ext js",
|
||||||
"test": "node test",
|
"test": "node test",
|
||||||
"dev:docs": "vuepress dev docs",
|
"dev:docs": "vuepress dev docs",
|
||||||
|
@ -76,5 +76,8 @@
|
||||||
"hooks": {
|
"hooks": {
|
||||||
"commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
|
"commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
|
||||||
}
|
}
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"gulp-markdown-toc": "^1.1.0"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
@ -15,10 +15,8 @@ console.log(cnchar.strokeToWord(1));
|
||||||
console.log('美好的地方'.spell('tone'));
|
console.log('美好的地方'.spell('tone'));
|
||||||
|
|
||||||
cncharDraw('你好', {
|
cncharDraw('你好', {
|
||||||
type: cncharDraw.TYPE.STROKE,
|
type: cncharDraw.TYPE.NORMAL,
|
||||||
style: {
|
style: {
|
||||||
radicalColor: '#337ab7',
|
|
||||||
padding: 10,
|
|
||||||
},
|
},
|
||||||
animation: {
|
animation: {
|
||||||
animateComplete () {
|
animateComplete () {
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
import {Draw} from '../plugin/draw/index';
|
import {Draw} from 'cnchar-draw';
|
||||||
// import {Draw} from 'cnchar-draw';
|
// import {Draw} from 'cnchar-draw';
|
||||||
|
|
||||||
declare type spellArg = 'array' | 'low' | 'up' | 'first' | 'poly' | 'tone' | 'simple';
|
declare type spellArg = 'array' | 'low' | 'up' | 'first' | 'poly' | 'tone' | 'simple';
|
||||||
|
|
|
@ -1 +1 @@
|
||||||
module.exports = '2.0.9';
|
module.exports = '2.1.0';
|
|
@ -1,5 +1,3 @@
|
||||||
import {Drawer} from "element-ui";
|
|
||||||
|
|
||||||
declare type DrawType = 'normal' | 'animation' | 'stroke' | 'test';
|
declare type DrawType = 'normal' | 'animation' | 'stroke' | 'test';
|
||||||
declare type TestStatusType = 'mistake' | 'correct' | 'complete';
|
declare type TestStatusType = 'mistake' | 'correct' | 'complete';
|
||||||
declare class Writer {
|
declare class Writer {
|
||||||
|
@ -28,8 +26,9 @@ declare interface TestStatus {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
declare interface DrawOption {
|
declare interface DrawOption {
|
||||||
type?: DrawType,
|
el?: string | HTMLElement; // 绘制的容器,支持id和dom,若是不填,会在body后append一个dom作为容器
|
||||||
style?:{
|
type?: DrawType; // 绘制模式,默认为normal
|
||||||
|
style?: { // 样式类
|
||||||
showOutline?: boolean;//: true,
|
showOutline?: boolean;//: true,
|
||||||
showCharacter?: boolean;//: true,
|
showCharacter?: boolean;//: true,
|
||||||
currentColor?: string;//: '#b44', // 仅在stroke模式下有效
|
currentColor?: string;//: '#b44', // 仅在stroke模式下有效
|
||||||
|
@ -40,7 +39,7 @@ declare interface DrawOption {
|
||||||
radicalColor?: string;//: null, // 十六进制字符, 默认 null。 如果存在偏旁部首数据,则在笔划中绘制偏旁部首的颜色。 如果没有设置,激光将绘制与其他笔划相同的颜色。
|
radicalColor?: string;//: null, // 十六进制字符, 默认 null。 如果存在偏旁部首数据,则在笔划中绘制偏旁部首的颜色。 如果没有设置,激光将绘制与其他笔划相同的颜色。
|
||||||
strokeFadeDuration?: number; //400
|
strokeFadeDuration?: number; //400
|
||||||
},
|
},
|
||||||
line?:{
|
line?: { // 背景线条类
|
||||||
lineStraight?: boolean;// : true,
|
lineStraight?: boolean;// : true,
|
||||||
lineCross?: boolean;// : true,
|
lineCross?: boolean;// : true,
|
||||||
lineWidth?: number;// : 1,
|
lineWidth?: number;// : 1,
|
||||||
|
@ -51,7 +50,7 @@ declare interface DrawOption {
|
||||||
borderColor?: string;// : '#ccc',
|
borderColor?: string;// : '#ccc',
|
||||||
borderDash?: boolean;// : false,
|
borderDash?: boolean;// : false,
|
||||||
},
|
},
|
||||||
animation?:{
|
animation?: {
|
||||||
strokeAnimationSpeed?: number;// : 1, // 数值, 默认 1。 绘制每个笔划的速度必须大于0。增加此数字可以更快地绘制笔划,减少绘制笔划的速度更慢。
|
strokeAnimationSpeed?: number;// : 1, // 数值, 默认 1。 绘制每个笔划的速度必须大于0。增加此数字可以更快地绘制笔划,减少绘制笔划的速度更慢。
|
||||||
delayBetweenStrokes?: number;// : 1000, // 数值, 默认 1000。 动画进行中每个笔画之间的间隔时间(以毫秒为单位)。
|
delayBetweenStrokes?: number;// : 1000, // 数值, 默认 1000。 动画进行中每个笔画之间的间隔时间(以毫秒为单位)。
|
||||||
delayBetweenLoops?: number;// : 200, // 数值, 默认 2000。 循环动画时每个动画循环之间的时间(以毫秒为单位)。
|
delayBetweenLoops?: number;// : 200, // 数值, 默认 2000。 循环动画时每个动画循环之间的时间(以毫秒为单位)。
|
||||||
|
|
|
@ -3,28 +3,11 @@ const {TYPE, merge, TEST_STATUS} = require('./default-option');
|
||||||
const {pickCnChar} = require('./util');
|
const {pickCnChar} = require('./util');
|
||||||
const {buildLinesStr} = require('./line');
|
const {buildLinesStr} = require('./line');
|
||||||
const {stroke} = require('./stroke');
|
const {stroke} = require('./stroke');
|
||||||
// window.w = HanziWriter.create('character-target-div', '你', {
|
|
||||||
// width: 100,
|
|
||||||
// height: 100,
|
|
||||||
// padding: 5,
|
|
||||||
// showOutline: true,
|
|
||||||
// showCharacter: true,
|
|
||||||
// strokeAnimationSpeed: 10
|
|
||||||
// });
|
|
||||||
// HanziWriter.loadCharacterData('是').then(function (charData) {
|
|
||||||
// console.log(charData);
|
|
||||||
// });
|
|
||||||
let svg = (() => {
|
let svg = (() => {
|
||||||
return document.createElementNS('http://www.w3.org/2000/svg', 'svg');
|
return document.createElementNS('http://www.w3.org/2000/svg', 'svg');
|
||||||
})();
|
})();
|
||||||
|
|
||||||
{/* <svg xmlns="http://www.w3.org/2000/svg" width="100" height="100" id="grid-background-target">
|
|
||||||
<line x1="0" y1="0" x2="100" y2="100" stroke="#DDD" />
|
|
||||||
<line x1="100" y1="0" x2="0" y2="100" stroke="#DDD" />
|
|
||||||
<line x1="50" y1="0" x2="50" y2="100" stroke="#DDD" />
|
|
||||||
<line x1="0" y1="50" x2="100" y2="50" stroke="#DDD" />
|
|
||||||
</svg> */}
|
|
||||||
window.HanziWriter = HanziWriter;
|
|
||||||
class Writer {
|
class Writer {
|
||||||
constructor ({
|
constructor ({
|
||||||
el = 'cnchar-draw',
|
el = 'cnchar-draw',
|
||||||
|
|
Loading…
Reference in New Issue