1. npm安装

cnchar包含了一个基本库和多个插件库，用于实现不同的功能，您可以按需安装其中的功能库，但是 cnchar 这个基础库是必须安装的

（注：draw、idiom、xhy、radical、words、explain、voice可以独立使用）

安装主库 (opens new window)：

npm i cnchar

按需安装功能库：

npm i cnchar-poly cnchar-order cnchar-trad cnchar-draw cnchar-idiom cnchar-xhy cnchar-radical cnchar-words cnchar-explain cnchar-voice cnchar-random cnchar-code cnchar-input cnchar-info cnchar-name

浏览器环境中功能库可以直接使用：

import cnchar from 'cnchar';
// 以下功能库请按需使用
import 'cnchar-poly';
import 'cnchar-order';
import 'cnchar-trad';
import 'cnchar-draw';
import 'cnchar-idiom';
import 'cnchar-xhy';
import 'cnchar-radical';
import 'cnchar-words';
import 'cnchar-explain';
import 'cnchar-voice';
import 'cnchar-random';
import 'cnchar-input';
import 'cnchar-code';
import 'cnchar-info';
import 'cnchar-name';

非浏览器环境中功能库需要使用use方法加载，且不支持 cnchar-draw、cnchar-voice 库：

// 请保证最先引入 cnchar 基础库，其他几个库顺序无所谓
import cnchar from 'cnchar';
import 'cnchar-poly';
// ... 其他插件请参考第二章 2. 功能及插件概览
// 插件请按需取用 console.log('汉字'.spell()); // prototype 方式调用
console.log(cnchar.spell('汉字')); // cnchar api 调用

commonjs 模块

// 请保证最先引入 cnchar 基础库，其他几个库顺序无所谓
var cnchar = require('cnchar');
var poly = require('cnchar-poly');
// ... 其他插件请参考第二章 2. 功能及插件概览
// 插件请按需取用
// 注：cnchar-draw，cnchar-voice 在非浏览器环境下不可使用
cnchar.use(poly); console.log('汉字'.spell()); // prototype 方式调用
console.log(cnchar.spell('汉字')); // cnchar api 调用

2. CDN引用

使用 script 标签使用：

<script src="https://fastly.jsdelivr.net/npm/cnchar/cnchar.min.js"></script>
<!--以下功能库请按需使用-->
<script src="https://fastly.jsdelivr.net/npm/cnchar-poly/cnchar.poly.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-order/cnchar.order.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-trad/cnchar.trad.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-draw/cnchar.draw.min.js"></script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-idiom/cnchar.idiom.min.js"> </script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-radical/cnchar.radical.min.js"> </script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-xhy/cnchar.xhy.min.js"> </script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-words/cnchar.words.min.js"> </script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-explain/cnchar.explain.min.js"> </script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-voice/cnchar.voice.min.js"> </script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-random/cnchar.random.min.js"> </script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-input/cnchar.input.min.js"> </script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-code/cnchar.code.min.js"> </script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-info/cnchar.info.min.js"> </script>
<script src="https://fastly.jsdelivr.net/npm/cnchar-name/cnchar.name.min.js"> </script>

3. cnchar-all

如果您需要使用cnchar及其插件的所有功能，可以通过安装cnchar-all来使用完整功能，这个库引用了上面的所有库

npm i cnchar-all

commonjs 模块

import cnchar from 'cnchar-all';

cdn方式

<script src="https://fastly.jsdelivr.net/npm/cnchar-all/cnchar.all.min.js"></script>

4. 简单使用

cnchar 具有两个最核心的方法spell 和 stroke，分别用于获取汉字的拼音和笔画数：

spell/stroke

运行结果

隐藏结果

Powered by JSBox

这只是一个最简单的使用，这两个方法具有很多参数可选，具体请参阅 cnchar 部分