SuperAPI AI 工具集

file-input

通用与其它

查看项目

更新于 10-16 04:31

技能介绍

用途:文件输入用于让用户从设备选择并上传文件,常见于文档管理、头像上传、电商商品图、表单附件和媒体类应用。

主要能力:支持单选或多选文件,可扩展为拖放区,并提供文件预览、上传进度指示和校验反馈。

使用方式:先确认模式与问题、约束匹配,再从 references/pattern.md 的解剖与示例中选择最小可行变体,先落实无障碍、性能和交互护栏,再做视觉打磨,并按测试指引验证键盘、屏幕阅读器、响应式和失败场景。键盘操作包括 Tab 聚焦、Enter/Space 打开文件浏览器、在文件列表中 Tab 移动焦点、Delete 移除文件、Escape 取消拖放。

适用场景:头像上传、文档提交(PDF、合同、证件)、媒体上传、CSV/JSON 批量导入、邮件附件。

限制与避免:移动端拍照应使用 input type=file capture=environment 或 capture=user;云盘选择需专用 SDK;超大文件应考虑分块上传 API;不适用于实时流媒体。

常见错误:仅做客户端校验(需同时做服务端 MIME 校验);大文件无上传反馈(超过 1 秒应显示进度);拖放区用 div 实现却不可键盘访问(应加 role=button、tabindex=0 并处理 Enter/Space)。

性能护栏:点击到对话框出现小于 100ms,5MB 内图片缩略图生成小于 200ms,单文件客户端校验小于 50ms,进度条每帧更新小于 16ms,组件内存小于 50KB,图片预览用 URL.revokeObjectURL() 释放。

更多实现细节、示例与测试说明见 references/pattern.md。