进阶 docs.budibase.com 2026-11-12 08:33:37 · 16 阅读

第25章 Budibase 附件组件指南:上传、存储与验证

附件

Single Attachment 和 Attachment List 组件允许用户向你的 Budibase 应用上传文件。

上传的文件存储在 MinIO 中。

这两个组件与 Budibase DB 的 Attachment 数据类型(Single attachment 和 Attachment List)配合使用效果最佳。

📘 文件大小 请注意你所选数据库支持的最大文件大小限制。

添加附件组件

Attachment 组件必须以 Form 组件作为父级。

要添加 Attachment 组件,请点击 Form > Single Attachment 或 Form > Attachment List。

组件添加后即可立即使用,无需额外配置。

管理访问权限

如果需要指定用户角色(例如允许公开上传文件),你需要调整相应数据表的写入权限级别。

验证

附件字段的表单验证选项不多:

约束说明必填必须至少上传一个文件。单文件大小上限(MB)任何上传文件都不能超过指定的大小限制(单位为 MB)。上传总大小上限(MB)所有上传文件的总大小不能超过指定的限制(单位为 MB)。

指定可接受的文件扩展名

默认情况下,Attachment 组件接受任何扩展名的文件。但在某些场景下,你可能希望限制文件类型,比如只接受 PDF 文件,或只接受图片文件。

extensions 属性接受一个文件扩展名数组,例如 [".webp",".png"]。使用 Handlebars 时,注意先用 split 拆分逗号分隔的字符串;使用 JavaScript 时,直接返回扩展名数组即可,如下所示。

{{ split ".png,.jpg,.jpeg,.svg,.gif,.webp" }}return ['.png','.jpg','.jpeg','.svg','.gif','.webp']

这样操作系统的原生文件选择对话框就会带上相应的自定义过滤条件。更新于 6 个月前 此页面对你有帮助吗?

评论 (0)