组件
Spinner 进行中指示
用于短暂动作的视觉反馈,始终配合可理解的状态。
Spinner 表示正在处理,不表示完成比例。适合保存按钮、局部刷新或少量等待;首次加载长内容时优先使用与布局相符的 Skeleton。
安装
pnpm dlx shadcn@4.22.1 add http://127.0.0.1:3040/r/v0.3.0/spinner.json首次使用请先完成 Registry 与主题接入。
组合
<span role="status">
<Spinner size={14} /> 正在保存…
</span>使用当前文字颜色,不单独硬编码背景。按钮等待时同时更新文案、阻止重复动作;减少动态效果模式下保持静态指示和状态文本。
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
size | number | 14 | SVG 宽高,单位 px |
className | string | — | 控制颜色和布局 |
| 可访问呈现 | 装饰 SVG | aria-hidden | 状态由父级文本提供 |
键盘与约束
Spinner 不可聚焦。不要改变等待按钮宽度导致邻近操作跳动;长时间请求应给出可恢复的错误或取消策略,这些由业务管理。
避免这样使用
不要让读屏只读到没有含义的图形;不要永久旋转来掩盖失败;不要同时在每一行和页面中央重复显示等待动画。
来源与版本
0.1.0,来自 Subtic apps/web/components/ui/spinner.tsx。提炼为无应用依赖的 SVG 指示器。
查看由当前源码生成的类型参考
只展示 Kitseed 自身定义的属性,原生 HTML 与 Base UI 透传属性请参阅对应上游说明。
Spinner
| 属性 | 类型 | 默认值 |
|---|---|---|
size? | number | 14 |
className? | string | — |
unstyled? | boolean | false |