Spinner 加载转轮
用紧凑旋转指示器反馈局部操作正在处理中且尚未完成。
使用概览
适合使用
- 按钮、表格区域或小型容器需要即时加载反馈时。
不建议使用
- 任务有可测量进度，或长时间等待需要解释当前阶段时。
真实示例
保存中指示器
为局部保存操作提供可读的进行中反馈。
安装
本地候选警告Registry 地址仅指向当前本地文档站；npm 包也只用于本地候选验证，尚未公开发布。
pnpm dlx shadcn@4.16.0 add http://127.0.0.1:3000/r/spinner.json基础用法
导入
import { Spinner } from "@richardqiu/quartz/spinner";JSX
<Spinner size="md" label="正在保存" />状态与控制摘要
默认
加载中
label · textactive · booleanAPI 参考
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
label | string | 未设置 | 为旋转图形提供描述当前任务的可访问文本。 |
size | "sm" | "md" | "lg" | "md" | 根据所在控件或区域选择指示器尺寸。 |
组合结构
- 01
Spinner
键盘约定
- Spinner 不可交互，也不进入键盘焦点顺序。
可访问性契约
- Spinner 独立承担加载播报时提供 label；位于已命名控件内时可保持装饰性。
- 系统减少动效或 Quartz none 模式下停止旋转。