kitseed.
组件

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

属性类型默认值说明
sizenumber14SVG 宽高,单位 px
classNamestring—控制颜色和布局
可访问呈现装饰 SVGaria-hidden状态由父级文本提供

键盘与约束

Spinner 不可聚焦。不要改变等待按钮宽度导致邻近操作跳动;长时间请求应给出可恢复的错误或取消策略,这些由业务管理。

避免这样使用

不要让读屏只读到没有含义的图形;不要永久旋转来掩盖失败;不要同时在每一行和页面中央重复显示等待动画。

来源与版本

0.1.0,来自 Subtic apps/web/components/ui/spinner.tsx。提炼为无应用依赖的 SVG 指示器。

查看由当前源码生成的类型参考

只展示 Kitseed 自身定义的属性,原生 HTML 与 Base UI 透传属性请参阅对应上游说明。

Spinner

属性类型默认值
size?number14
className?string—
unstyled?booleanfalse

本页内容