跳到正文

Spinner 加载

时长未知的短暂等待用 Spinner:面板刷新、某一块在加载、内容正在替换。即将到来的内容形状已知时,用 Skeleton 能让布局保持稳定;能知道进行到哪里时,请用 Progress;Button 自带 loading。

Spinner 表示有东西正在加载。单独使用时是行内元素;包在内容外面时,会在加载期间盖住这些内容。默认的圆环是一条会伸缩的 SVG 弧线;type="pixel" 改用 Raft 的四像素标记,type="dots" 改用三个点。

演示

尺寸

四种命名尺寸,也可以直接给像素值。Spinner 跟随容器的文字色;放在彩色底上时,把容器文字色设成这块底色的 text-on-fill,再用 variant="inverse" 让轨道更明显。

类型

type="ring"(默认)是一条 SVG 弧线。type="pixel" 是 2x2 排列的四个方形像素,按顺时针轮流点亮,和圆环一样跟随文字色。命名尺寸的总宽分别是 9.5、12、14、19px(像素边长 4、5、6、8px)。像素值尺寸是整个标记的宽度:间距取它的六分之一,每个像素是 (size - gap) / 2。开启减少动态效果时像素停止,只保留第一个点亮。

type="dots" 是一排三个圆点,从左到右依次上浮半个点并变亮,每 1.2s 一轮。命名尺寸的总宽分别是 12、16、20、32px(点的直径 3、4、5、8px,间距是半个点),标记高两个点,上浮不会超出它。像素值尺寸是这一排的宽度:每个点取四分之一,每个间距取八分之一。开启减少动态效果时三个点静止。演示在浅色和深色作用域里分别展示三种类型。

思考中与输入中

三个点跟在几个字后面,表示事情在进行、但说不准何时结束:「思考中」「Kate 正在输入」,或者单独放在聊天气泡里。aria-label 写同样的字,读屏读到的就是「思考中」,而不是默认的「加载中」。

描述

覆盖内容

有子元素时,show 为 true 期间 Spinner 盖在内容上方,并把内容调暗;内容会被标记为 aria-busy,也不能点击。

延迟

delay 让 Spinner 等一会儿再出现,很快就完成的操作不会闪一下。隐藏是立即的。

自定义图标

icon 替换圆环并让它旋转;rotate={false} 让它保持静止。type="pixel" 和 type="dots" 时两者都不生效。

Props

名称类型默认值说明版本
typering | pixel | dotsringring 是主题的圆环,pixel 是四像素标记,dots 是三个点,各主题都一样未发布
sizexs | sm | md | lg | numbersm命名尺寸或像素值,type="pixel" 或 type="dots" 时像素值是标记的总宽未发布
variantdefault | inversedefault彩色底上用 inverse 加深轨道;颜色本身来自容器的文字色。未发布
descriptionReactNodeundefinedSpinner 下方的文字。未发布
childrenReactNodeundefined加载期间要覆盖的内容。未发布
showbooleantrue是否显示;有子元素时 false 也会恢复内容的亮度。未发布
delaynumberundefined显示前等待的毫秒数。未发布
iconReactNodeundefined替换圆环,只在 type="ring" 时生效未发布
rotatebooleantrue让自定义 icon 旋转,只在 type="ring" 时生效未发布
contentClassNamestringundefined被覆盖内容的类名。未发布
contentStyleCSSPropertiesundefined被覆盖内容的样式。未发布

Spinner 是一个 role="status" 元素,名称取自语言包(“Loading” / “加载中”);可以用 aria-label 说明具体在加载什么。没有子元素时根节点是行内的 span,有子元素时是块级的 div;ref 和其他属性都加在根节点上。