今天和大家安利一款超赞的开源项目, 基于这个项目我们可以轻松定制自己的白板, 思维导图, 原型草图设计, 流程图工具等, 它就是——Excalidraw。
接下来我会和大家介绍一下这款开源项目的功能特点, 如何二次开发, 以及如何使用我改造好的成品快速部署到自己的服务器上。
效果演示:
在线地址: https://board.dooring.vip。
开源地址: https://gitee.com/lowcode-china/excalidraw-mini。
功能介绍
首先 Excalidraw 的技术栈采用 Vite + React + TypeScript + Yarn + Husky, 目前开源 star 已经有 66k+, 还是非常受开发者喜欢的。
这里先介绍一下我使用完这款开源项目的一个功能总结:
- 支持手绘风格的草图设计
- 支持流程图, 思维导图的设计
- 支持多人协同
- 支持会议白板, 激光笔标注
- 支持多种导出格式
- 支持二次开发
虽然这款工具界面设计的非常简洁, 但是却可以做出非常精美的作品, 比如架构图(Dooring的架构就是用它画的~):
业务流程 & 设计思路。
思维导图:
当然我们还能发挥想象, 应用在更多的场景. 我之前写的很多技术文章里的架构图, 流程图, 都是用它来设计的, 偶尔也会用它来设计一下产品草图, 非常方便。
二次开发
接下来就到了技术小伙伴最关注的环节了,如何使用它, 二次开发自己的白板应用。
安装
首先我们需要在自己的项目里安装它:
yarn add react react-dom @excalidraw/excalidraw
接下来写一个简单的demo:
function App() {
return (
<>
<h1 style={{ textAlign: "center" }}>Dooring Example</h1>
<div style={{ height: "500px" }}>
<Excalidraw />
</div>
</>
);
}
预览效果如下:
当然如果觉得它默认的主题色不符合自己的业务场景, 我们还能自定义主图风格:
.custom-styles .excalidraw {
--color-primary: #fcc6d9;
--color-primary-darker: #f783ac;
--color-primary-darkest: #e64980;
--color-primary-light: #f2a9c4;
}
.custom-styles .excalidraw.theme--dark {
--color-primary: #d494aa;
--color-primary-darker: #d64c7e;
--color-primary-darkest: #e86e99;
--color-primary-light: #dcbec9;
}
excalidraw 组件还提供了很多自定义的属性, 可以让我们轻松扩展和定制, 比如我们想扩展右侧功能按钮, 可以用如下的代码:
function App() {
return (
<div style={{ height: "500px" }}>
<Excalidraw
renderTopRightUI={() => {
return (
<button
style={{
background: "#70b1ec",
border: "none",
color: "#fff"
}}
onClick={() =>
window.location.href = 'https://dooring.vip'
}
>
H5制作
</button>
);
}}
/>
</div>
);
}
这里我们用到了它的 renderTopRightUI 属性, 类型是一个函数, 我们在函数里返回我们想要定制的组件按钮即可, 效果如下:
当然还有很多可定制的属性, 大家也可以自行探索, 我把我自己定制好的一套白板发布到 gitee 上了, 包括中文支持, 欢迎页面, 页面控件等, 感兴趣的也可以直接基于我的项目二次开发. 如下:
在线地址: https://board.dooring.vip。
开源地址: https://gitee.com/lowcode-china/excalidraw-mini。