Skip to content

Spin 加载动画

全局加载动画组件,对齐 Ant Design Spin,可包裹子元素。

示例

可访问性

Spin 在加载中时会渲染为 role="status" 的 polite live region。纯视觉旋转图形会从辅助技术中隐藏;当包裹子元素时,外层容器会根据 spinning 同步 aria-busy。当页面中存在多个加载状态时,建议通过 tiparia-labelaria-labelledby 提供可区分名称。

当设置 delay 时,Spin 会延迟显示视觉 spinner 和 status live region;如果 spinning 在延迟结束前变为 false,则不会显示 spinner。包裹子元素时,aria-busy 仍会立即反映真实加载状态。

API

属性说明类型默认值
spinning是否加载中booleantrue
size尺寸'sm' | 'md' | 'lg''md'
tip提示文字ReactNode-
delay延迟显示加载状态的毫秒数number0
aria-label加载状态可访问名称stringtip 文本或 'Loading'
aria-labelledby使用外部标签命名加载状态string-
aria-live加载状态通知优先级'off' | 'polite' | 'assertive''polite'