Attachment 附件
会话附件行：媒体（图标/缩略图）+ 文件名/元数据 + 上传状态机 + 操作（下载/删除/整卡触发器）。用于聊天发文件、AI 对话传图、客服工单附件等场景。
基础用法
基础附件行
name 文件名 + detail 次级元数据（类型 · 大小）；downloadable 在场显示内置下载按钮（点击派发 oas-download，下载动作由宿主接管）。
上传状态机（state）
idle / uploading / processing / error / done
`uploading`/`processing` 反射 aria-busy 并显示 spinner；`uploading` 渲染底部细进度条（progress 0–100，越界自动收敛）；`error` 缺省 detail 时显示 locale 错误文案（「上传失败」），显式给 detail 则保留宿主文案。
状态机五态：idle / uploading / processing / error / done（默认 done）；removable 在场显示删除按钮（点击派发 oas-remove，默认不自移除——删除决策在宿主）。
尺寸（size）
default / sm / xs
三档 size：default / sm（接受 small 别名）/ xs，逐档收内边距与媒体尺寸。
竖排与缩略图（orientation / 媒体槽）
vertical + slot=media 缩略图
orientation="vertical" 图上文下（窄栏/卡片场景）；slot="media" 放缩略图（任意 <img>/<svg>，最大 64px）即覆盖缺省图形，不放则渲染内置文件图形（纯装饰 aria-hidden）——媒体形态由「插槽有无内容」天然决定，无形态属性。
整卡触发器（href）
href + oas-open 事件反馈
点击上方附件卡触发 oas-open（demo 阻断导航并显示反馈）。
有 href 时整卡变 <a part="trigger">，点击派发 oas-open（detail { href }）；宿主在事件里 preventDefault 可接管打开方式（预览/新窗口），组件会同步阻断默认导航。
操作与事件反馈
removable / downloadable / slot=actions
点删除/下载按钮，此处显示收到的事件。
内置删除/下载按钮的可读名称包含文件名（如「移除 draft-v1.docx」——只读「删除」屏幕阅读器无法区分目标）；slot="actions" 追加自定义操作（组件不管具体动作，事件由插槽内组件派发）。
附件组（oas-attachment-group）
横向滚动 + 吸附 + 边缘渐隐
oas-attachment-group 是横向滚动行：子项逐项吸附（scroll-snap-align: start），两侧可滚时以 mask 边缘渐隐（可滚性反射为 data-scrollable="start end"）。它不拥有数据（纯容器，无属性），默认插槽放 oas-attachment 或任意卡片；键盘 Tab 聚焦后方向键可横向滚动。间距与渐隐宽度走 CSS 变量 --oas-attachment-group-gap / --oas-attachment-group-fade。
无障碍
- 进行中态反射
aria-busy；进度条role="progressbar"带 min/max/now 三值。 - 仅图标操作按钮的
aria-label含目标文件名（不只「删除」）；装饰图形一律aria-hidden。 - error 态用色 + 文案双重传达（不单靠颜色）；
slot="media"放真实缩略图时请自带可读名称（alt/aria-label）。
API
oas-attachment
属性
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
detail | 次级元数据（类型 · 大小）；error 态缺省时显示 locale 错误文案（「上传失败」），显式给值则保留宿主文案 | — | — |
downloadable | 布尔在场：显示内置下载按钮（点击派发 oas-download，下载动作由宿主接管） | boolean | — |
href | 有值则整卡为可点触发器（a[part=trigger]），点击派发 oas-open；宿主 preventDefault 可接管并阻断默认导航 | — | — |
name | 文件名（title 通道；缺省只渲染 media 不报错） | — | — |
orientation | 排布方向：horizontal（默认）/ vertical（图上文下，窄栏场景） | — | — |
progress | 上传进度 0–100（越界自动收敛到 0/100；仅 uploading 态渲染底部细进度条 role=progressbar） | — | — |
removable | 布尔在场：显示内置删除按钮（点击派发 oas-remove；组件默认不自移除，删除决策在宿主） | boolean | — |
size | 三档尺寸：default（默认）/ sm（接受 small 别名）/ xs，逐档收内边距与媒体 | — | — |
state | 上传状态机：idle / uploading / processing / error / done（默认 done；uploading/processing 反射 aria-busy） | string | done |
事件
| 事件 | 说明 |
|---|---|
oas-download | 点击内置下载按钮时派发，detail |
oas-open | 点击 href 整卡触发器时派发，detail { href }；cancelable——宿主 preventDefault 后组件同步阻断链接默认导航 |
oas-remove | 点击内置删除按钮时派发，detail { name }；默认不自移除 |
插槽
| 名称 | 说明 |
|---|---|
actions | 追加自定义操作区（内置下载/删除按钮之后） |
media | 媒体槽（图标/缩略图），放内容即覆盖内置缺省图形 |
oas-attachment-group
插槽
| 名称 | 说明 |
|---|---|
| 默认 | 附件卡片序列（oas-attachment 或任意卡片；横向溢出时吸附滚动 + 边缘渐隐） |
CSS 变量
| CSS 变量 | 默认值 |
|---|---|
--oas-attachment-group-fade | 24px |
--oas-attachment-group-gap | var(--oas-space-2_5) |
部件：::part(attachment) 根、::part(trigger) 触发器、::part(media) / ::part(title) / ::part(description) / ::part(spinner) / ::part(progress) / ::part(actions) / ::part(download) / ::part(remove)。