GrapesJS 插件

GrapesJS 插件 — 常见问题

什么是 GrapesJS 插件？

GrapesJS 插件是一个接收编辑器实例并对其进行扩展的函数——可以注册组件、区块、命令、面板、traits 或样式分组。初始化编辑器时把它放进 plugins 数组，并可通过 pluginsOpts 配置。凡是编辑器 API 暴露出来的能力，插件都能添加或替换。

如何安装 GrapesJS 插件？

多数插件发布在 npm 上：安装包、引入它，然后加入 GrapesJS 初始化调用的 plugins 数组即可。插件通常也提供 UMD 构建，可以直接用 script 标签引入，它会按名称自行注册，因此你可以用字符串引用。GJS.Market 的每个条目都给出确切的包名和初始化代码片段。

GrapesJS 插件能配合 React、Vue 和 Angular 使用吗？

可以。GrapesJS 与框架无关——它在你提供的容器内渲染自己的 DOM，因此插件作用于编辑器实例，而不是你的宿主框架。React、Vue 和 Angular 应用挂载 GrapesJS 的方式相同，同一个插件在三者中都能用。只有那些在画布内渲染特定框架组件的插件才有宿主要求，这类插件会在条目中注明。

怎么确认插件与我的 GrapesJS 版本兼容？

GJS.Market 的每个条目都显示 GrapesJS 版本标识，本页也支持按版本筛选。兼容性问题主要出现在大版本之间——组件、RTE 与 StorageManager 的 API 在此期间发生过变化，为旧大版本编写的插件可能需要兼容层。付费条目会明确写出已测试的版本，并在核心 API 变更时更新。

免费插件和付费插件有什么区别？

免费插件由社区维护，通常采用 MIT 或 BSD 这类宽松许可，你可以自行 fork 和修补。付费插件额外提供专属作者支持、针对新 GrapesJS 版本的更新保障，多数情况下还有更完整的文档。两者上架前都会经过兼容性审核；按下载量或评分排序，可以在任一类别中找出最可靠的选择。