引言
抛弃冗余堆砌，回归交互本质。本次 Attachment 组件更新，旨在通过补齐关键体验缺口，解决复杂业务中的协同痛点：
过程受控： 规范批量操作逻辑，支持手动上传、取消；
场景适配： 强化视觉自定义能力，高度贴合业务语境；
交互进化： 优化操作体验，打造更连贯的办公交互。 下面，我们将深度解析本次更新背后的设计细节。
一、从“能上传”到“可控上传”：流程掌控感更强
🌟 批量删除，不再逐个操作
过去，如果用户需要删除多个附件，只能一条条点击删除。文件列表过多时，操作比较繁琐低效。 这次新增配置： enableDeleteAll ：支持批量勾选 + 一键删除
👉 带来的变化是：
用户可以像操作列表一样管理附件，而不是“逐个点按钮”。
🌟上传节奏可控：立即上传 or 批量确认
在很多业务中，上传并不是“选一个文件就立刻上传”： 有的场景需要选完一批，再统一提交 有的则希望选完即传，减少等待感 这次新增：
- uploadImmediately：控制上传时机
- upload 实例方法：手动触发上传
- removeImmediately：可配置临时删除，最后调用remove方法统一提交
👉 本质解决的是：上传行为从“组件自动触发”变成“业务可控”
🌟 支持中断上传：不再“只能等它传完” /
当文件较大或网络波动时，用户往往会遇到一个问题： 👉 上传开始了，但我想取消，怎么办？
这次新增：
- onUploadAbort：取消上传回调
- abortUpload 实例方法：手动中断上传
👉 这意味着：
- 用户可以主动终止操作
- 前端可以接管上传生命周期，而不是被动等待
🌟 文件夹上传：一次性带走一整套文件
在实际业务中，用户上传的往往不是单个文件，而是： 👉 一个完整目录（如设计稿、项目资料包）
这次新增： directory：支持上传整个文件夹
👉 对用户来说：
- 不需要压缩文件
- 不需要多次选择
直接“选择整个目录”即可完成上传。
二、场景适配：从“能看”到“按业务看”
🌟 预览逻辑交给你决定
过去，附件预览方式较为固定。
但在企业应用中，不同文件往往有不同预览策略：
- 图片走 CDN
- 文档走在线预览服务
- 私有文件需要鉴权 URL
这次增强：
- onPreview：预览行为钩子
- getPreviewUrl 支持异步函数
👉 关键变化：预览地址不再是静态值，而是可以“动态计算”
比如：先请求接口获取签名 URL，再打开预览
🌟 图片墙体验更完整
在图片类场景（如商品、工单、巡检）中，附件往往以“图片墙”呈现。 这次新增：
- pictureCardShowName：图片下显示文件名 👉 带来的变化：用户不仅能看图，还可根据业务需求选择是否展示文件名
三、交互进化：那些“用久了才发现”的体验问题
🌟图片卡片模式展示更合理
优化点：上传按钮文本溢出问题修复
👉 结果是：界面更干净，不再出现文字挤压或截断异常
🌟受控模式更稳定
修复attachments属性不生效问题
👉 对开发者来说： 受控模式行为更加一致，避免“状态不同步”的隐性问题
欢迎试用
我们将持续迭代优化组件库，提升客户体验。如果您有更好的想法和建议，欢迎您积极反馈给我们。
