更新记录
2.0.1(2026-11-01)
- fix: 兼容uniappx 鸿蒙svg image
2.0.0(2026-08-14)
新增
lime-hanzi-writer组件,适配 uni-app / uni-app x(uvue + vue 双端)- 笔顺书写动画:播放、逐笔动画、循环播放、暂停 / 继续
- 田字格背景(
showGrid/gridColor) - 逐笔高亮(
highlightStroke) - 笔顺测验(
quiz):支持测验提示、跳过笔画、错误回调等 - 自定义颜色(笔画 / 部首 / 高亮 / 轮廓 / 田字格)与尺寸(
size/width/height) - 本地汉字数据(
charDataMap/setLocalCharData)与动态切换(setCharacter) - 插件根
index.ts统一导出公开静态 API(setLocalCharData/setCharDataVersion等)
使用网络加载汉字数据时,组件会请求
https://cdn.jsdelivr.net/npm/hanzi-writer-data@{version}/{character}.json,小程序平台需在小程序后台配置该域名白名单;如需无网络请求,请使用本地数据。
平台兼容性
uni-app(4.44)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | - | 5.0 | √ | √ |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | - | - | - | - | - | - | - | - | - | - | - |
uni-app x(5.31)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | √ | 5.0 | √ | √ | √ |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | × | × | √ |
name: lime-hanzi-writer 汉字笔顺 description: 汉字笔顺书写动画与测验组件,支持田字格、逐笔高亮、手写笔刷、笔顺测验,兼容 uni-app / uni-app x tags:
- hanzi
- hanzi-writer
- 汉字
- 笔顺
- 书写
- 测验
- canvas componentTag: l-hanzi-writer plugin: lime-hanzi-writer category: 业务组件 dependencies:
- lime-shared
- lime-use
- lime-cnchar
-
lime-tts
lime-hanzi-writer 汉字笔顺
一款汉字笔顺书写动画与测验组件,支持田字格、逐笔高亮、手写笔刷和笔顺测验,兼容 uni-app / uni-app x。
插件依赖:lime-shared、lime-use。 演示页额外依赖 lime-cnchar(取笔画名)与 lime-tts(朗读)。
组件只负责「写出这个字」,不内置词典(组词、释义不在包内)。组词用 lime-cnchar 已构建好的
cnchar-words.js,接法见下文「组词(词语)」。
安装方法
- 在 uni-app 插件市场中搜索并导入
lime-hanzi-writer - 首次导入后可能需要重新编译项目
- 在页面中使用
l-hanzi-writer组件
代码演示
基础用法
显示一个汉字,带笔画书写动画。
<l-hanzi-writer character="永" :size="200" />
播放 / 暂停笔顺动画
通过 ref 调用方法控制动画。
<l-hanzi-writer ref="writerRef" character="永" :size="200" @ready="play" />
<button @click="play">播放</button>
<button @click="writerRef.pauseAnimation()">暂停</button>
<button @click="writerRef.resumeAnimation()">继续</button>
const writerRef = ref(null)
const play = () => writerRef.value?.animateCharacter()
数据就绪时机(ready)
组件需要先拿到 canvas 上下文和该字的笔顺数据(本地命中则同步,走网络则要等请求),两者都完成后才抛出 ready。
<l-hanzi-writer ref="writerRef" character="永" :size="200" @ready="onReady" />
// 推荐:数据真正就绪后再播动画,不需要 setTimeout 猜时机
const onReady = () => writerRef.value?.animateCharacter()
// 脚本式调用也可以 await
await writerRef.value?.ready()
await writerRef.value?.setCharacter('学')
setCharacter成功后也会再次抛ready,切字后可以重新await ready()。
显示田字格
外边框(实线)与内部辅助线(虚线)的线宽可分别控制。
<l-hanzi-writer
character="永"
:size="200"
:show-grid="true"
grid-color="#DDDDDD"
:grid-border-width="3"
:grid-line-width="2"
/>
自定义颜色
<l-hanzi-writer
character="永"
:size="200"
stroke-color="#333"
highlight-color="#1FA1D9"
outline-color="#DDDDDD"
grid-color="#DDDDDD"
/>
部首颜色默认跟随笔画色;也可以单独指定:
<!-- 部首固定为红色;不传则跟随 stroke-color -->
<l-hanzi-writer character="永" :size="200" radical-color="#E54D42" />
手写笔刷
测验书写支持 5 种笔刷,只影响观感,不影响判对判错。
<!-- 钢笔笔锋 -->
<l-hanzi-writer character="永" :size="240" drawing-brush="fountain" :drawing-width="12" />
<!-- 粉笔 -->
<l-hanzi-writer character="永" :size="240" drawing-brush="chalk" :drawing-width="12" />
| 笔刷 | 观感 |
|---|---|
pen |
钢笔,定宽圆头,最稳定的默认值 |
fountain |
笔锋,起笔钝入、行笔随速度变粗细、收笔出锋 |
chalk |
粉笔,断续颗粒 + 边缘粉屑 |
crayon |
蜡笔,蜡质实体 + 毛边 |
marker |
马克笔,凿形笔头 + 半透明荧光 |
drawingWidth使用 1024 逻辑坐标系:300px 画布上4约 1.2px,想要明显手写感建议8 ~ 14。
运行时也可以调整(不重建实例):颜色走 updateColor;笔刷、粗细是 prop,改值即生效。
writerRef.value?.updateColor('drawingColor', '#C0392B', { duration: 0 })
drawingBrush.value = 'chalk'
drawingWidth.value = 14
笔顺测验
通过 quiz 方法进入测验模式,用户按正确笔顺书写。
<l-hanzi-writer ref="writerRef" character="永" :size="240"
@mistake="onMistake" @correctStroke="onCorrectStroke" @complete="onComplete" />
<button @click="startQuiz">开始测验</button>
const startQuiz = () => {
writerRef.value?.quiz({
onComplete: (summary) => console.log('测验完成,总错误数:', summary.totalMistakes)
})
}
写错的一笔会先染成 drawing-error-color 并抖动一下再淡出。连续写错达到 show-hint-after-misses 次后高亮提示正确写法:
<!-- 第一次写错就提示 -->
<l-hanzi-writer character="永" :size="240" :show-hint-after-misses="1" />
写歪了不用退出重来,undoStroke() 可以退回上一笔(不计错):
<l-hanzi-writer ref="writerRef" character="永" :size="240" />
<button @click="writerRef.undoStroke()">撤销一笔</button>
对低龄用户或触屏精度差的设备,判卷可以放宽:
<l-hanzi-writer character="永" :size="240" :leniency="1.6" :average-distance-threshold="450" />
动态切换汉字
<l-hanzi-writer ref="writerRef" :character="char" :size="200" />
<button @click="switchChar">切换</button>
const char = ref('永')
const switchChar = () => { char.value = '学' }
// 或者 writerRef.value?.setCharacter('学')
组词(词语)
组件只负责「把字写出来」,不内置词典。想做「这个字能组哪些词」的识字卡片,词表要自己提供;本节说明词从哪儿来、以及怎么接到组件上。
词从哪儿找
| 来源 | 词条 | 授权 | 获取方式 |
|---|---|---|---|
cnchar-words |
19,914 | MIT | 推荐:lime-cnchar 已构建出 ESM 产物 cnchar-words.js,直接 import 即可(见下节) |
jieba dict.txt |
349,046 词(带词频、词性) | MIT | fxsjy/jieba → jieba/dict.txt;要按词频排序、覆盖更全时用它自建索引 |
| chinese-xinhua | 约 26 万词(带释义、例句) | 见仓库说明 | pwxcoo/chinese-xinhua → data/word.json(27MB,建议放 CDN 按需取) |
cnchar-words的 npm 包不能直接用在 uni-app x:它和 cnchar 一样只发 UMD,没有 ESM 产物。所以 lime-cnchar 从 cnchar 3.2.6 的 TS 源码把它额外打了一份cnchar-words.js(273KB,词典已内联,完全离线)。 它的词表偏书面、常用字覆盖不全(鹦、鹉、哥、煮、眨等查不到,可用下面的addWords补)。要正式上线且要求词更全,建议用 jieba 自建:按词频取每个字的前 8~12 个词,压缩后约 200~300KB。
接入方式
接入只有三行:import 核心、import 组词插件、use 一下。
import cnchar from '@/uni_modules/lime-cnchar/cnchar.js'
import cncharWords from '@/uni_modules/lime-cnchar/cnchar-words.js'
cnchar.use(cncharWords)
cnchar.words('永') // ['永别','永不','永存','永恒','永久','永久性','永世','永远']
cnchar.words('学') // ['爱科学','爱学习','办学','博学','不科学','才学', ...]
字卡页面的基本形状:
<view class="word-list">
<view v-for="w in words" :key="w" class="word-chip" @tap="playWord(w)">
<text class="word-chip-text">{{ w }}</text>
</view>
</view>
<l-hanzi-writer ref="writerRef" :character="char" :size="220" />
const char = ref('学')
const words = ref<string[]>(cnchar.words(char.value))
注意三点:
- 返回的是词中含该字的全部词条(不限首字),顺序为词典序、不按词频;
- 结果里混有 3 字词和少量专名(
武汉市、爱科学),展示前建议自己截断或过滤,例如words.value = cnchar.words(c).filter(w => w.length <= 3).slice(0, 8); - 词典里没有的词用
addWords补,传空格分隔的字符串(传数组会被无分隔拼接,词会粘在一起):cncharWords.addWords('鹦鹉学舌 我们的学校')。
点词后逐字演示
复用同一个实例逐字写(内存不增长,推荐):
const playWord = async (word: string) => {
const chars = word.split('')
for (let i = 0; i < chars.length; i++) {
await writerRef.value?.setCharacter(chars[i])
await new Promise<void>((resolve) => {
writerRef.value?.animateCharacter({ onComplete: () => resolve() })
})
}
}
若想让整个词一次全显示,也可以一词多实例(每个字一个):
<view class="word-row">
<l-hanzi-writer v-for="(c, i) in wordChars" :key="i" :character="c" :size="88" :show-grid="true" />
</view>
// wordChars = 当前词按字拆开,例如 '鹦鹉' → ['鹦','鹉']
const wordChars = ref<string[]>(['鹦', '鹉'])
拼音与朗读
cnchar.spell('鹦鹉') // 'YingWu' —— 整词拼音,无需额外库
cnchar.spell('银行', 'poly') // 多音字要 cnchar-poly 才能定音,否则只返回候选
import { useTTS } from '@/uni_modules/lime-tts'
useTTS().speak('永远')
词表也可以按需加载
词表大了不要一次 import 全量 JSON:按字分片(如 static/hanzi-words/永.json 只放这个字的词),进入字卡时再 uni.request 取,思路与 createCharDataLoader 的按字加载一致。
使用本地字符数据
通过 char-data-map 传入本地数据,命中即用,未命中的字仍会回落网络。数据格式参考 hanzi-writer-data。
<l-hanzi-writer character="永" :size="200" :char-data-map="dataMap" />
import yongData from '@/static/hanzi-data/永.json'
const dataMap = { '永': yongData }
想要彻底离线,用全局 setLocalCharData 一次注入全量数据:
import { setLocalCharData } from '@/uni_modules/lime-hanzi-writer'
setLocalCharData({ '永': yongData, '汉': hanData /* ...全量... */ })
自定义数据源
默认链路是:charDataMap / 全局字库 → 网络 uni.request → 抛错,三段都可替换。
import { createCharDataLoader } from '@/uni_modules/lime-hanzi-writer'
// 例:不联网,全部从包内静态资源读
const loader = createCharDataLoader({
dataUrl: (char) => `/static/hanzi-data/${char}.json`,
request: (url, callbacks) => {
// 回调形状固定:success({ statusCode, data }) / fail({ errMsg })
},
})
// 例:走自己的后端
const remoteLoader = createCharDataLoader({
dataUrl: (char, version) => `https://your-cdn.com/hanzi/${version}/${char}.json`,
})
输出静态笔顺 SVG(不依赖 canvas)
需要把笔顺图贴到富文本、导出图片、做题目素材时,可以直接用纯函数 buildHanziSvg 生成 SVG 字符串,完全不涉及 canvas 与组件实例。
import { buildHanziSvg, decodeSvgDataUrl } from '@/uni_modules/lime-hanzi-writer'
// 全部笔画合成一张
const svg = buildHanziSvg({
strokes, // 字符数据里的 strokes 数组
stroke: 'all', // 'all' | 数字(第几笔,0 起)
fill: '#555',
outline: true,
outlineColor: '#E6E6E6',
grid: true,
gridColor: '#DDDDDD',
gridBorderWidth: 3,
gridLineWidth: 2,
})
// 逐笔序列(返回 string[],一个元素一张图)
const list = buildHanziSvg({ strokes, sequence: true, highlightCurrent: true })
// 需要纯 SVG 源码(例如复制到富文本)时:
const source = decodeSvgDataUrl(svg)
<!-- 返回的 data URI 可直接交给 image 渲染 -->
<image :src="svg" mode="aspectFit" />
API 文档
Props
🎯 基础配置
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| character | 显示的汉字 | string | - | - |
| size | 组件尺寸(px),设置后宽高相等 | number | - | - |
| width | 组件宽度(px),size 优先 | number | - | - |
| height | 组件高度(px),size 优先 | number | - | - |
| padding | 内边距(px) | number | 0 |
- |
| dpr | 设备像素比覆盖,不传自动读取 | number | - | - |
| disableScroll | 触摸时禁止页面滚动 | boolean | true |
true, false |
🎬 动画配置
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| animationSpeed | 笔画动画速度倍数,越大越快 | number | 1 |
- |
| delayBetweenStrokes | 笔画间隔(ms) | number | 500 |
- |
🎨 颜色配置
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| strokeColor | 笔画颜色 | string | #555 |
- |
| radicalColor | 部首颜色,null 时跟随 strokeColor |
string | null | null |
- |
| highlightColor | 高亮颜色(测验提示用) | string | #AAF |
- |
| outlineColor | 轮廓颜色 | string | #DDDDDD |
- |
| gridColor | 田字格线颜色 | string | #DDDDDD |
- |
🖥 显示控制
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| showOutline | 是否显示轮廓 | boolean | true |
true, false |
| showGrid | 是否显示田字格 | boolean | false |
true, false |
| gridBorderWidth | 田字格外边框线宽 | number | 3 |
- |
| gridLineWidth | 田字格内部辅助线宽 | number | 2 |
- |
✍️ 手写笔(测验书写)
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| drawingBrush | 笔刷样式 | string | pen |
pen, fountain, chalk, crayon, marker |
| drawingWidth | 笔触宽度(1024 坐标系) | number | 4 |
- |
| drawingColor | 笔触颜色 | string | #333 |
- |
| drawingErrorColor | 写错时笔触颜色 | string | #E5484D |
- |
⚖️ 测验判卷
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| showHintAfterMisses | 连续写错几笔后高亮提示,1 表示每次提示 |
number | 3 |
- |
| leniency | 判卷宽松度,越小越严格 | number | 1 |
- |
| averageDistanceThreshold | 判卷平均偏移阈值,越大越宽松 | number | 350 |
- |
📦 数据配置
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| charDataMap | 本地汉字数据,未命中回落网络 | object | - | - |
🧩 样式定制
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| lClass | 根元素自定义类名 | string | object | - | - |
| lClassCanvas | 画布自定义类名 | string | object | - | - |
| lStyle | 根元素自定义样式 | string | object | - | - |
Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| ready | 画布与当前字符数据均已就绪(setCharacter 成功后也会再次触发) |
- |
| mistake | 测验中写错一笔 | StrokeData |
| correctStroke | 测验中写对一笔 | StrokeData |
| undo | 撤销了一笔 | { character, strokeNum, totalMistakes } |
| complete | 测验完成 | { character, totalMistakes } |
Methods
通过组件 ref 调用:
| 方法名 | 说明 | 参数 |
|---|---|---|
| showCharacter | 显示汉字 | options?: AnimationOptions |
| hideCharacter | 隐藏汉字 | options?: AnimationOptions |
| animateCharacter | 播放笔画书写动画 | options?: OnCompleteOptions |
| animateStroke | 播放指定笔画动画 | strokeNum: number, options?: OnCompleteOptions |
| animateStrokeWithColor | 用指定颜色播放某笔动画 | strokeNum: number, color: string, options?: OnCompleteOptions |
| highlightStroke | 高亮指定笔画 | strokeNum: number, options?: OnCompleteOptions |
| loopCharacterAnimation | 循环播放书写动画 | - |
| pauseAnimation | 暂停动画 | - |
| resumeAnimation | 恢复动画 | - |
| showOutline | 显示轮廓 | options?: AnimationOptions |
| hideOutline | 隐藏轮廓 | options?: AnimationOptions |
| quiz | 开始笔顺测验 | options?: QuizOptions |
| skipQuizStroke | 跳过当前测验笔画 | - |
| undoStroke | 撤销上一笔(不计错),返回 false 表示没有可撤销的笔画 |
返回 boolean |
| cancelQuiz | 取消测验 | - |
| setCharacter | 切换汉字,返回的 Promise 在数据就绪后 resolve | char: string ⇒ Promise\<void> |
| setCharDataMap | 合并本地字符数据(同时写入全局默认) | map: object |
| getStrokeCount | 获取笔画数 | 返回 number |
| getCharacterData | 获取字符数据 | 返回 Promise\<Character> |
| updateDimensions | 更新尺寸 | options: { width?, height?, padding? } |
| updateColor | 更新颜色 | colorName: string, colorVal: string | null, options?: AnimationOptions |
| ready | 等待画布与当前字符数据就绪 | 返回 Promise\<void> |
| destroy | 销毁组件 | - |
通过模块导入调用:
| 方法名 | 说明 | 参数 |
|---|---|---|
| setLocalCharData | 设置全局本地字库(整表替换),对所有实例生效 | map: object |
| setCharDataVersion | 设置网络加载的 hanzi-writer-data 版本号(默认 2.0.1) |
version: string |
| getCharDataVersion | 读取当前数据源版本号 | 返回 string |
| buildHanziSvg | 生成笔顺 SVG(全部 / 单笔 / 逐笔序列) | options: HanziSvgOptions |
| createCharDataLoader | 自定义数据源(地址 / 传输层) | options: CharDataLoaderOptions |
| encodeSvgDataUrl | 生成当前平台可用的 SVG data URI | svg: string ⇒ string |
| decodeSvgDataUrl | 把 data URI 还原成纯 SVG 字符串 | uri: string ⇒ string |
| setNativeBtoa | 注入原生 btoa(鸿蒙官方支持后使用) |
fn: (input: string) => string | null |
| setSvgDataUrlEncoder | 自定义 buildHanziSvg 的 data URI 编码器 |
fn: (svg: string) => string | null |
类型
AnimationOptions
| 参数 | 说明 | 类型 |
|---|---|---|
| duration | 动画时长(ms) | number |
| onComplete | 动画完成回调 | (res: { canceled: boolean }) => void |
QuizOptions
| 参数 | 说明 | 类型 |
|---|---|---|
| onComplete | 测验完成回调 | (summary: { character: string; totalMistakes: number }) => void |
| onCorrectStroke | 正确书写笔画回调 | (strokeData: StrokeData) => void |
| onMistake | 书写错误回调 | (strokeData: StrokeData) => void |
| onUndo | 撤销一笔回调 | (info: { character: string; strokeNum: number; totalMistakes: number }) => void |
StrokeData
| 字段 | 说明 | 类型 |
|---|---|---|
| character | 当前汉字 | string |
| strokeNum | 当前笔画序号 | number |
| mistakesOnStroke | 当前笔画错误次数 | number |
| totalMistakes | 总错误次数 | number |
| strokesRemaining | 剩余笔画数 | number |
| drawnPath | 用户绘制的路径 | { points: Point[] } |
| isBackwards | 是否反向书写 | boolean |
updateColor的colorName可取:strokeColor/radicalColor/highlightColor/outlineColor/drawingColor/drawingErrorColor。
主题定制
组件主要通过 props 定制外观,没有提供额外的 CSS 变量。
方式一:通过 props 直接设置(推荐)
<l-hanzi-writer character="永" :size="240" stroke-color="#333" grid-color="#DDDDDD" />
方式二:通过 lStyle 直接设置
<l-hanzi-writer character="永" :size="240" :l-style="{ width: '240px' }" />
⚠️ 重要提示
关于 class 的使用
请不要直接在 lime- 组件上使用 class 属性,这会导致样式失效或产生意外行为。推荐:
方式一:在父级或根节点上设置 class
<view class="hanzi-wrapper">
<l-hanzi-writer character="永" :size="240" />
</view>
<style>
.hanzi-wrapper {
/* 在这里设置相关样式 */
}
</style>
方式二:使用 lStyle 直接设置
<l-hanzi-writer character="永" :size="240" :l-style="{ width: '240px' }" />
方式三:使用 lClass 配合样式
<l-hanzi-writer character="永" :size="240" l-class="custom-hanzi" />
<style>
.custom-hanzi {
/* 在这里设置相关样式 */
}
</style>
Vue2 使用说明
插件使用了 composition-api,如需在 Vue2 项目中使用,请按照官方教程配置。
// main.js
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)
快速预览
导入插件后,可以直接使用以下标签查看演示效果:
<!-- 代码位于 uni_modules/lime-hanzi-writer/components/lime-hanzi-writer -->
<lime-hanzi-writer />
演示页按四张卡片组织:
- ① 笔顺演示:主舞台播放笔顺动画;「重写」「开始测验」为次级按钮;标题行右侧的状态胶囊显示「共 N 笔」或「测验中 x/y · 错 n」。
- ② 逐笔拆解:复用
buildHanziSvg({ sequence: true, highlightCurrent: true })生成逐笔序列,点任意一格即高亮该笔并朗读笔画名。 - ③ 静态笔顺图:用
buildHanziSvg生成整字 SVG 交给<image>渲染,支持「复制 SVG 源码」与「朗读该字」。 - ④ 显示设置:笔画 / 部首 / 轮廓 / 提示 / 网格 / 笔触 / 写错七类颜色可调,田字格与轮廓为开关。
插件标签说明
| 标签类型 | 示例 | 说明 |
|---|---|---|
| 组件标签 | l-hanzi-writer |
汉字笔顺核心组件 |
| 演示标签 | lime-hanzi-writer |
演示组件,用于查看完整功能演示 |
文档链接
📚 插件详情与更新请访问:
注意事项
- 使用网络加载汉字数据时,组件会请求
https://cdn.jsdelivr.net/npm/hanzi-writer-data@{version}/{character}.json。 - 小程序必须配置合法域名白名单:在各平台后台「服务器域名 → request 合法域名」中添加
https://cdn.jsdelivr.net;切换了其它 CDN 时请对应添加。 - 如不希望任何网络请求,请使用
charDataMap或setLocalCharData提供全量离线数据。 drawingWidth是 1024 逻辑坐标系的相对值,不是屏幕 px。- 笔刷只影响观感,判对判错始终按笔画中心线的几何形状计算。
平台能力矩阵
书写动画的"生长"效果有两种实现:dash(setLineDash + lineDashOffset)与 slice(按比例截取折线点)。默认全平台使用 dash,slice 仅作逃生舱保留。
| 平台 | canvas 2d | Path2D | 书写动画 | 同步测量矩形 | 备注 |
|---|---|---|---|---|---|
| uni-app x · App(Android / iOS) | ✅ | ❌(退回逐段路径) | dash |
✅ getBoundingClientRect |
- |
| uni-app x · Web | ✅ | ✅ 原生 Path2D |
dash |
✅ | 精度最高 |
| uni-app x · 鸿蒙 | ✅ | ❌ | dash |
✅ | SVG 走 base64 |
| uni-app x · 微信小程序 | ✅ | ❌ | dash |
❌ 异步 getRect |
触摸坐标按缓存矩形换算 |
| uni-app(vue2 / vue3)· H5 / App | ✅ | 仅 H5 | dash |
❌ 异步 getRect |
- |
| uni-app(vue2 / vue3)· 微信小程序 | ✅ | ❌ | dash |
❌ 异步 getRect |
需配域名白名单 |
平台差异集中在
platform/目录:uniHost.ts负责 host 注入,svgDataUrl.ts负责 SVG 编码,base64.ts是纯 JS 实现。
常见问题
为什么 ready 之后才能播动画?
组件需要先拿到 canvas 上下文和该字的笔顺数据,两者都完成后才能作画。未就绪时调用方法不会丢,会排队等数据到达后执行最近一次;ready() 额外等的是当前字符的数据。
鸿蒙上 SVG 图片不显示?
鸿蒙的 image 不支持 URL 编码的 svg data URI,插件已自动改用 base64。若你自行拼接 data URI,请使用 encodeSvgDataUrl()。
测验时写的笔画位置偏移?
请确认 size / width / height 与实际渲染尺寸一致;组件用缓存的 canvas 矩形换算触摸坐标。
触摸时页面跟着滚动?
默认 disableScroll 为 true,会拦截默认行为。需要页面滚动时设为 false。
支持与赞赏
如果你觉得本插件解决了你的问题,可以考虑支持作者:
| 支付宝赞助 | 微信赞助 |
|---|---|
![]() |
![]() |

收藏人数:
购买源码授权版(
试用
赞赏(0)


下载 74640
赞赏 604
下载 12768492
赞赏 1959
赞赏
京公网安备:11010802035340号