用途：image-upload 是 UX 模式，帮助团队让用户可靠地选择、预览、校验并替换图片，适用于头像上传、列表与目录管理、用截图或照片记录工作等场景。若不需要完整媒体处理，应改用更简单的图片、链接或文件输入；浏览器原生行为足够时，避免自定义复杂控件。
主要能力：覆盖图片选择、预览、校验和替换流程，强调在上传前或上传中让用户确认；要求把状态、元数据和控制作为模式的一等部分，而非事后叠加的浮层；需处理不同设备编解码、拍摄流程和带宽差异带来的降级行为。
使用方式：先确认模式匹配问题与约束，再从 references/pattern.md 的解剖和示例出发选择最小可行变体，最后应用无障碍、性能与交互护栏并叠加视觉细节。用测试指南验证键盘、屏幕阅读器、响应式和失败场景。
无障碍护栏：键盘方面，确保仅用键盘可完成上传，焦点顺序合理，保持高缩放可见焦点；屏幕阅读器方面，优先语义元素，必要时才加 ARIA，在正确位置礼貌播报错误、加载或完成状态，用 aria-describedby 或结构标题关联标签、提示和状态文本；视觉方面，不只用颜色传达严重程度、完成或选中状态。
常见错误：把媒体仅当装饰会导致上传与播放流程失效，应把状态、元数据和控制作为核心；跳过降级行为会因编解码、拍摄和带宽差异出问题，需为不支持的 API、低数据条件和加载失败规划优雅降级；遗漏无障碍替代（如字幕、转录、alt 文本或可见状态）会使模式具有排他性，应把替代访问路径视为核心体验。
适用场景：头像上传、目录管理、截图记录等。限制：资料未提供具体收费、价格、平台与量化效果；资料未提供完整代码或安装命令；完整实现细节、示例和测试说明见 references/pattern.md 与模式页面。