按分类浏览
GrapesJS 资产
GrapesJS 资源管理器插件用于扩展编辑器处理图片、文件与媒体的方式。把 GrapesJS 接入云存储服务、加入拖拽上传界面、对接 Cloudinary 或 S3 等媒体库,或构建自定义资源选择器。浏览免费与付费的资源管理器扩展,它们均已针对 API 兼容性与在 GrapesJS 项目中的集成便利性做过审核。
关于 GrapesJS 资产
GrapesJS 资源管理器负责用户如何上传、浏览并把媒体插入画布设计。默认的资源管理器可用但很基础——它支持图片上传和一个扁平的网格视图。GJS.Market 上的 GrapesJS 资源管理器插件对其进行扩展或替换,使之贴近现代 Web 应用管理媒体的方式。最常见的一类插件提供云存储集成:AWS S3、Cloudflare R2、Cloudinary、Uploadcare 和 Imgix 均有对应插件,它们都支持从编辑器画布直接上传到你的存储桶,并自动插入 URL。第二类插件改善浏览体验:文件夹树视图、按文件名或标签搜索与筛选、批量操作,以及 SVG 和视频文件的预览缩略图。企业级资源管理器插件还包含权限系统,可限制哪些用户能查看或上传到哪些文件夹。GJS.Market 上所有资源管理器插件都会说明其所需的后端接口格式,方便你在安装前确认与现有存储层是否兼容。
GrapesJS 资产 — 常见问题
- 什么是 GrapesJS 资源管理器?
- 资源管理器是内置的媒体浏览器,用户双击图片组件时会打开它。它保存可用资源列表、处理上传,并把所选的 URL 写回组件。开箱状态下只有一个扁平网格和基础上传控件;此外的一切都来自插件或你自己的配置。
- 如何把 GrapesJS 的上传接到自己的后端?
- 把 assetManager.upload 设为你的接口地址,GrapesJS 会以 multipart 表单数据向该地址 POST 文件。你的接口需要返回编辑器期望的 JSON 结构——一个由资源对象组成的 data 数组;若返回格式不符,可在 uploadResponse 回调中转换。接口需要鉴权时,可通过 assetManager 选项添加请求头或凭据。
- GrapesJS 能配合 S3、Cloudinary 或其他 CDN 吗?
- 可以,这也是安装本分类插件最常见的原因。AWS S3、Cloudflare R2、Cloudinary、Uploadcare 和 Imgix 都有现成插件;它们都能从画布直接上传到你的存储桶并插入生成的 URL。对 S3 这类存储,建议使用预签名上传,这样凭据永远不会出现在浏览器中。
- 可以限制用户上传哪些文件吗?
- 编辑器侧只能部分限制,服务端必须强制校验。资源管理器可以在选择器中按可接受的 MIME 类型过滤,但这只是易用性防护,不是安全措施。文件类型、大小上限与按用户的权限必须由你的上传接口来强制执行,因为任何客户端限制都可被绕过。本分类中的企业级插件会在此之上再加一层文件夹级权限。
- 资源管理器支持视频和 SVG 吗?
- 默认管理器是围绕图片设计的,因此视频和 SVG 不会有可用的缩略图。本分类中的多个插件为二者补充了正确的预览渲染,并加入文件夹树、按文件名或标签搜索以及批量操作。安装前请查看各条目支持预览的媒体类型。