Back to Plate

Excalidraw

docs/(plugins)/(elements)/excalidraw.cn.mdx

1.0.01.8 KB
Original Source
<ComponentPreview name="excalidraw-demo" /> <PackageInfo>

功能特性

  • 集成 Excalidraw 库用于创建绘图和图表
</PackageInfo>

安装

bash
npm install @platejs/excalidraw

使用方式

tsx
import { ExcalidrawPlugin } from '@platejs/excalidraw/react';

const plugins = [
  // ...其他插件
  ExcalidrawPlugin,
];

插入工具栏按钮

可以将此项添加到插入工具栏按钮来插入 Excalidraw 元素:

tsx
{
  icon: <PenToolIcon />,
  label: 'Excalidraw',
  value: KEYS.excalidraw,
}

插件

ExcalidrawPlugin

Excalidraw 空元素插件。

API 接口

insertExcalidraw

向编辑器中插入 Excalidraw 元素。

<API name="insertExcalidraw"> <APIParameters> <APIItem name="props" type="NodeProps<TExcalidrawElement>" optional> Excalidraw 元素的属性参数 </APIItem> <APIItem name="options" type="InsertNodesOptions" optional> 插入 Excalidraw 元素的配置选项 </APIItem> </APIParameters> </API>

钩子函数

useExcalidrawElement

Excalidraw 组件的行为钩子。

<API name="useExcalidrawElement"> <APIState> <APIItem name="element" type="TExcalidrawElement"> Excalidraw 元素 </APIItem> <APIItem name="libraryItems" type="LibraryItems" optional> 在 Excalidraw 组件中显示的库项目 - **默认值:** `[]` </APIItem> <APIItem name="scrollToContent" type="boolean" optional> 是否滚动到 Excalidraw 组件内部内容 - **默认值:** `true` </APIItem> </APIState> <APIReturns type="object"> <APIItem name="Excalidraw" type="any"> Excalidraw 组件 </APIItem> <APIItem name="excalidrawProps" type="ExcalidrawProps"> 传递给 Excalidraw 组件的属性参数 </APIItem> </APIReturns> </API>