【踩坑日记 · 前端】为 Excalidraw 添加中文手写字体
Excalidraw 是一款完全免费的手绘风格绘图在线应用,能快速画出漂亮的流程图、示意图和图表,但美中不足的是,Excalidraw 只支持英文手写字体,好在 Excalidraw 是开源软件,我们可以通过修改代码为其添加中文手写字体。
前言
Excalidraw 是一款完全免费的手绘风格绘图在线应用,能快速画出漂亮的流程图、示意图和图表,地址: Excalidraw | Hand-drawn look & feel • Collaborative • Secure
但美中不足的是,Excalidraw 只支持英文手写字体,好在 Excalidraw 是开源软件,我们可以通过修改代码为其添加中文手写字体。
中文手写字体
在这里向大家推荐几款好看的中文手写字体,我个人比较喜欢 沐瑶软笔手写体
,下面就以这款字体为例,演示如何为 Excalidraw 添加中文手写字体。
-
字语青梅硬笔(商用需付费)
-
沐瑶软笔手写体(免费商用)
-
沐瑶随心手写体(免费商用)
步骤
1. 下载源代码和中文字体
下载 Excalidraw 源代码 到本地并解压,或者直接使用 Git 克隆项目:
git clone https://github.com/excalidraw/excalidraw
下载中文手写体,并将其复制到 public
目录下:
注意:字体名不能含有中文或其他特殊符号,建议将字体名重命名为纯英文。在这里我选择的字体是
沐瑶软笔手写体
,并重命名为Muyao.ttf
,后续代码中的字体名一定要保持一致。
2. 注册字体
编辑 public/font.css
,添加文手写体:
@font-face {
font-family: "Muyao";
src: url("Muyao.ttf");
font-display: swap;
}
添加完成后代码如下:
编辑 src/index-node.ts
,添加下列代码注册中文手写字体:
registerFont("./public/Muyao.ttf", { family: "Muyao" });
添加完成后代码如下:
3. 预加载字体资源
编辑 public/index.html
,在其中加入字体预加载代码,可以提高应用启动时的速度:
<link
rel="preload"
href="Muyao.ttf"
as="font"
type="font/ttf"
crossorigin="anonymous"
/>
添加完成后代码如下:
4. 增加字体枚举
编辑 src/constant.ts
,在 FONT_FAMILY
常量中加入字体的枚举:
5. 添加字体切换按钮
最后,编辑 /src/actions/actionProperties.tsx
,在 PanelComponent
的返回值数组中加入下列元素:
{
value: FONT_FAMILY.Muyao,
text: t("labels.handDrawn"),
icon: FreedrawIcon,
}
添加完成后代码如下:
部署测试
进入 excalidraw 源代码目录,在终端中执行下列代码:
# 安装依赖包
yarn
# 启动应用
yarn start
出现上面的输出代表应用启动成功,用浏览器访问 http://localhost:3000
:
在左侧的面板中可以看到刚才添加的手写字体,选择即可切换。
参考资料
[1] Excalidraw - 免费的手绘风格白板应用 - 知乎
[2] 送给大家的免费字体:沐瑶软笔手写体_春颜秋色-站酷ZCOOL
[3] 送给大家的字体2:沐瑶随心手写体_春颜秋色-站酷ZCOOL
[5] GitHub - excalidraw/excalidraw: Virtual whiteboard for sketching hand-drawn like diagrams
开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!
更多推荐
所有评论(0)