Upload 上传

经典款式，用户点击按钮弹出文件选择框。触发控件使用库自身的 Button，上传由本地 mock customRequest 完成，不依赖外网接口。

把文件拖入后上传，支持点击选择与批量文件。示例的 customRequest 为本地 mock，随机数以外不依赖任何外部服务。

以卡片形式展示图片缩略图，使用 list-type="picture-card"。缩略图来自本地 data URL，示例不依赖外网图片。

通过 maxCount 限制最多保留的文件数；超出时新文件会替换最早的文件（maxCount={1} 时行为最明显）。

accept 限定文件选择器；beforeUpload 里做真实校验：非图片或超过 1MB 时用 message.error 提示并返回 Upload.LIST_IGNORE，文件不会进入列表。

对比 beforeUpload 的两种拒绝语义：返回 false 时文件仍进入列表但不发送请求；返回 Upload.LIST_IGNORE 时文件被完全忽略。两者都不会产生网络请求。

用 customRequest 接管上传：示例每 200ms 上报一次 onProgress，到 100% 后调用 onSuccess。真实项目可在此接入自己的请求库、鉴权或分片逻辑。

customRequest 里调用 onError 后，列表项进入 error 状态并保留文件信息，便于用户重试或移除。

用 v-model:file-list 受控管理文件列表：外部按钮可以直接清空列表，页面上的文件数与列表状态始终一致。

list-type="picture-circle" 把缩略图渲染成圆形，常用于头像或头像组场景。

设置 directory 后文件选择器以文件夹模式打开，选中的目录会被遍历为多个文件。示例仍由本地 mock 完成上传。

pastable 会监听页面粘贴事件，剪贴板中的图片会直接进入上传流程。浏览器需要在用户授权/聚焦的页面中触发粘贴。

customRequest 先把请求挂起，文件保持在 uploading 状态；点击 “Start Upload” 后才逐项推进进度并成功。演示了“先选择、后提交”的受控上传流程。

通过 showUploadList 打开预览、下载与移除按钮，并用 onPreview / onDownload 接管动作。示例用 message 反馈，不真正打开外部链接。

把 Avatar 放进 Upload 作为触发控件，并关闭文件列表，点击头像即可选择文件。

通过 ConfigProvider 的 theme.components.Upload 设置当前组件令牌：pictureCardSize 控制图片卡片尺寸，actionsColor 控制下方文本列表的操作图标颜色。照片墙的遮罩操作维持高对比色。 示例使用本地 data URL 缩略图与 mock 上传，不访问外网；也可通过原生 style 覆盖对应 CSS 变量。

用 defaultFileList 提供非受控的初始文件列表，后续变化由组件内部维护；onChange 用于展示最近一次文件状态变化。上传过程由本地 mock customRequest 完成。

#iconRender 作用域插槽收到 { file, listType }，可按扩展名为文件列表渲染不同图标。示例使用 listType="picture" 且不提供缩略图，因此列表会展示自定义图标。

通过 onPreview 接管文件预览：示例在页面内展示本地 data URL 图片，并提供可访问的「关闭预览」按钮。文件列表的预览图标带有本地化 aria-label，可用键盘操作。

Upload 提供 root / list / item / trigger 四个语义槽。示例为列表和条目设置类名与内联样式，展示「类名拼接、样式覆盖」的用法；上传由本地 mock 完成。

本仓不提供已废弃的 transformFile 属性；等价能力由 beforeUpload 返回新的 File 完成。示例把文件名中的空格替换为连字符并转成小写，再交给 mock 上传。

accept="image/png" 只影响文件选择框的过滤，真正的类型校验放在 beforeUpload：非 PNG 文件会提示错误并返回 Upload.LIST_IGNORE，不会进入列表。

progress 支持渐变 strokeColor、数字或 CSS 长度 strokeWidth、showInfo 与 ARIA 名称。 本例显示 4px 渐变进度和当前百分比。初始文件从 30% 推进到 100%，新选择的文件通过 mock customRequest 反馈进度；成功事件后收起进度条。