Attachment 附件进阶：管控更精准，定义更自由！

引言

抛弃冗余堆砌，回归交互本质。本次 Attachment 组件更新，旨在通过补齐关键体验缺口，解决复杂业务中的协同痛点：
过程受控： 规范批量操作逻辑，支持手动上传、取消；
场景适配： 强化视觉自定义能力，高度贴合业务语境；
交互进化： 优化操作体验，打造更连贯的办公交互。
下面，我们将深度解析本次更新背后的设计细节。

一、从“能上传”到“可控上传”：流程掌控感更强

🌟 批量删除，不再逐个操作

过去，如果用户需要删除多个附件，只能一条条点击删除。文件列表过多时，操作比较繁琐低效。
这次新增配置：
enableDeleteAll ：支持批量勾选 + 一键删除

👉 带来的变化是：
用户可以像操作列表一样管理附件，而不是“逐个点按钮”。

🌟上传节奏可控：立即上传 or 批量确认

在很多业务中，上传并不是“选一个文件就立刻上传”：
有的场景需要选完一批，再统一提交
有的则希望选完即传，减少等待感
这次新增：

uploadImmediately：控制上传时机
upload 实例方法：手动触发上传
removeImmediately：可配置临时删除，最后调用remove方法统一提交

👉 本质解决的是：上传行为从“组件自动触发”变成“业务可控”

🌟 支持中断上传：不再“只能等它传完” /

当文件较大或网络波动时，用户往往会遇到一个问题：
👉 上传开始了，但我想取消，怎么办？

这次新增：

onUploadAbort：取消上传回调
abortUpload 实例方法：手动中断上传

👉 这意味着：

用户可以主动终止操作
前端可以接管上传生命周期，而不是被动等待
🌟 文件夹上传：一次性带走一整套文件
在实际业务中，用户上传的往往不是单个文件，而是：
👉 一个完整目录（如设计稿、项目资料包）

这次新增：
directory：支持上传整个文件夹

👉 对用户来说：

不需要压缩文件
不需要多次选择

直接“选择整个目录”即可完成上传。

二、场景适配：从“能看”到“按业务看”

🌟 预览逻辑交给你决定

过去，附件预览方式较为固定。

但在企业应用中，不同文件往往有不同预览策略：

图片走 CDN
文档走在线预览服务
私有文件需要鉴权 URL

这次增强：

onPreview：预览行为钩子
getPreviewUrl 支持异步函数

👉 关键变化：预览地址不再是静态值，而是可以“动态计算”

比如：先请求接口获取签名 URL，再打开预览

🌟 图片墙体验更完整

在图片类场景（如商品、工单、巡检）中，附件往往以“图片墙”呈现。
这次新增：

pictureCardShowName：图片下显示文件名
👉 带来的变化：用户不仅能看图，还可根据业务需求选择是否展示文件名

三、交互进化：那些“用久了才发现”的体验问题

🌟图片卡片模式展示更合理

优化点：上传按钮文本溢出问题修复

👉 结果是：界面更干净，不再出现文字挤压或截断异常

🌟受控模式更稳定

修复attachments属性不生效问题

👉 对开发者来说：
受控模式行为更加一致，避免“状态不同步”的隐性问题

欢迎试用

我们将持续迭代优化组件库，提升客户体验。如果您有更好的想法和建议，欢迎您积极反馈给我们。