logoAnt Design

⌘ K
  • 设计
  • 研发
  • 组件
  • 博客
  • 资源
  • 国内镜像
YouMindTRACTIANLobeHubCodeRabbit
6.5.3
  • 组件总览
  • 更新日志
    v6.5.3
  • 通用
    • Button按钮
    • FloatButton悬浮按钮
    • Icon图标
    • Typography排版
  • 布局
    • Divider分割线
    • Flex弹性布局
    • Grid栅格
    • Layout布局
    • Masonry瀑布流
      6.0.0
    • Space间距
    • Splitter分隔面板
  • 导航
    • Anchor锚点
    • Breadcrumb面包屑
    • Dropdown下拉菜单
    • Menu导航菜单
    • Pagination分页
    • Steps步骤条
    • Tabs标签页
  • 数据录入
    • AutoComplete自动完成
    • Cascader级联选择
    • Checkbox多选框
    • ColorPicker颜色选择器
    • DatePicker日期选择框
    • Form表单
    • Input输入框
    • InputNumber数字输入框
    • Mentions提及
    • Radio单选框
    • Rate评分
    • Select选择器
    • Slider滑动输入条
    • Switch开关
    • TimePicker时间选择框
    • Transfer穿梭框
    • TreeSelect树选择
    • Upload上传
  • 数据展示
    • Avatar头像
    • Badge徽标数
    • Calendar日历
    • Card卡片
    • Carousel走马灯
    • Collapse折叠面板
    • Descriptions描述列表
    • Empty空状态
    • Image图片
    • List列表
      废弃
    • Popover气泡卡片
    • QRCode二维码
    • Segmented分段控制器
    • Statistic统计数值
    • Table表格
    • Tag标签
    • Timeline时间轴
    • Tooltip文字提示
    • Tour漫游式引导
    • Tree树形控件
  • 反馈
    • Alert警告提示
    • Drawer抽屉
    • Message全局提示
    • Modal对话框
    • Notification通知提醒框
    • Popconfirm气泡确认框
    • Progress进度条
    • Result结果
    • Skeleton骨架屏
    • Spin加载中
    • Watermark水印
  • 其他
    • Affix固钉
    • App包裹组件
    • BorderBeam边框流光
      6.4.0
    • ConfigProvider全局化配置
    • Util工具类
何时使用
代码演示
基本用法
各种大小
卡片加载中
自定义描述文案
延迟
自定义指示符
进度
自定义语义结构的样式和类
全屏
API
静态方法
Semantic DOM
主题变量(Design Token)

Spin
加载中

用于页面和区块的加载中状态。
使用import { Spin } from 'antd';
反馈
components/spin提交问题待解决
文档
编辑此页LLMs.md
Skeleton骨架屏Watermark水印

相关资源

Ant Design X
Ant Design Charts
Ant Design Pro
Pro Components
Ant Design Mobile
Ant Design Mini
Ant Design Web3
Ant Design Landing-首页模板集
Scaffolds-脚手架市场
Umi-React 应用开发框架
dumi-组件/文档研发工具
qiankun-微前端框架
Ant Motion-设计动效
国内镜像站点 🇨🇳

社区

Awesome Ant Design
Medium
X
yuque logoAnt Design 语雀专栏
Ant Design 知乎专栏
体验科技专栏
seeconf logoSEE Conf-蚂蚁体验科技大会
加入我们

帮助

GitHub
更新日志
常见问题
For Agents
报告 Bug
议题
讨论区
StackOverflow
SegmentFault

Ant XTech logo更多产品

yuque logo语雀-构建你的数字花园
AntV logoAntV-数据可视化解决方案
Egg logoEgg-企业级 Node.js 框架
Kitchen logoKitchen-Sketch 工具集
Galacean logoGalacean-互动图形解决方案
WeaveFox logoWeaveFox-前端智能研发
xtech logo蚂蚁体验科技
主题编辑器
Made with ❤ by
蚂蚁集团和 Ant Design 开源社区
loading

何时使用

页面局部处于等待异步数据或正在渲染过程时,合适的加载动效会有效缓解用户的焦虑。

代码演示

API

通用属性参考:通用属性

参数说明类型默认值版本全局配置
classNames用于自定义组件内部各语义化结构的 class,支持对象或函数Record<SemanticDOM, string> | (info: { props }) => Record<SemanticDOM, string>-6.0.0
delay延迟显示加载效果的时间(防止闪烁)number (毫秒)-×
description可以自定义描述文案ReactNode-6.3.0×
fullscreen显示带有 Spin 组件的背景booleanfalse5.11.0×
indicator加载指示符ReactNode-5.20.0
percent展示进度,当设置 percent="auto" 时会预估一个永远不会停止的进度number | 'auto'-5.18.0×
size组件大小,可选值为 small medium largestringmedium×
spinning是否为加载中状态booleantrue×
styles用于自定义组件内部各语义化结构的行内 style,支持对象或函数Record<SemanticDOM, CSSProperties> | (info: { props }) => Record<SemanticDOM, CSSProperties>-6.0.0
tip当作为包裹元素时,可以自定义描述文案。已废弃,请使用 descriptionReactNode-×
wrapperClassName包装器的类属性。已废弃,请使用 classNames.rootstring-×

静态方法

  • Spin.setDefaultIndicator(indicator: ReactNode)

    你可以自定义全局默认 Spin 的元素。

Semantic DOM

Loading
Loading
  • root
    6.0.0
    根元素,设置绝对定位、显示控制、颜色、字体大小、文本对齐、垂直对齐、透明度和过渡动画(fullscreen 为 false 时才有效)
  • section
    6.3.0
    加载元素区域,设置相对定位、弹性盒子布局、对齐方式和颜色
  • indicator
    6.0.0
    指示器元素,设置宽度、高度、字体大小、行内块显示、过渡动画、变换原点、行高
  • description
    6.3.0
    描述元素,设置字体大小、行高
  • container
    6.3.0
    容器元素,放置被 Spin 包裹的子元素,设置透明度和过渡动画

主题变量(Design Token)

组件 Token如何定制?
Token 名称描述类型默认值
contentHeight内容区域高度string | number400
dotSize加载图标尺寸number20
dotSizeLG大号加载图标尺寸number32
dotSizeSM小号加载图标尺寸number14
全局 Token如何定制?
Token 名称描述类型默认值
colorBgContainer组件的容器背景色,例如:默认按钮、输入框等。务必不要将其与 `colorBgElevated` 混淆。string#ffffff
colorBgMask浮层的背景蒙层颜色,用于遮罩浮层下面的内容,Modal、Drawer、Image 等组件的蒙层使用的是该 tokenstringrgba(0,0,0,0.45)
colorFillSecondary二级填充色可以较为明显地勾勒出元素形体,如 Rate、Skeleton 等。也可以作为三级填充色的 Hover 状态,如 Table 等。stringrgba(0,0,0,0.06)
colorPrimary品牌色是体现产品特性和传播理念最直观的视觉元素之一。在你完成品牌主色的选取之后,我们会自动帮你生成一套完整的色板,并赋予它们有效的设计语义string#1677ff
colorText最深的文本色。为了符合W3C标准,默认的文本颜色使用了该色,同时这个颜色也是最深的中性色。stringrgba(0,0,0,0.88)
colorTextDescription控制文本描述字体颜色。stringrgba(0,0,0,0.45)
colorTextLightSolid控制带背景色的文本,例如 Primary Button 组件中的文本高亮颜色。string#fff
colorWhite不随主题变化的纯白色string#fff
fontFamilyAnt Design 的字体家族中优先使用系统默认的界面字体,同时提供了一套利于屏显的备用字体库,来维护在不同平台以及浏览器的显示下,字体始终保持良好的易读性和可读性,体现了友好、稳定和专业的特性。string-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans', sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji'
fontSize设计系统中使用最广泛的字体大小,文本梯度也将基于该字号进行派生。number14
lineHeight文本行高number1.5714285714285714
marginXXS控制元素外边距,最小尺寸。number4
motionDurationMid动效播放速度,中速。用于中型元素动画交互string0.2s
motionDurationSlow动效播放速度,慢速。用于大型元素如面板动画交互string0.3s
paddingSM控制元素的小内间距。number12
zIndexPopupBase浮层类组件的基础 Z 轴值,用于一些悬浮类的组件的可以基于该值 Z 轴控制层级,例如 FloatButton、 Affix、Modal 等number1000
基本用法

一个简单的 loading 状态。

Aquileo | CodeSandbox Icon
Aquileo | Hitu Icon
Aquileo | codepen icon
Aquileo | External Link Icon
Aquileo | Expand Icon
Alert message title
Further details about the context of this alert.

Loading state:

卡片加载中

可以直接把内容内嵌到 Spin 中,将现有容器变为加载状态。

Aquileo | CodeSandbox Icon
Aquileo | Hitu Icon
Aquileo | codepen icon
Aquileo | External Link Icon
Aquileo | Expand Icon
Alert message title
Further details about the context of this alert.

Loading state:

延迟

延迟显示 loading 效果。当 spinning 状态在 delay 时间内结束,则不显示 loading 状态。

Aquileo | CodeSandbox Icon
Aquileo | Hitu Icon
Aquileo | codepen icon
Aquileo | External Link Icon
Aquileo | Expand Icon
进度

展示进度,当设置 percent="auto" 时会预估一个永远不会停止的进度条。

Aquileo | CodeSandbox Icon
Aquileo | Hitu Icon
Aquileo | codepen icon
Aquileo | External Link Icon
Aquileo | Expand Icon
5.18.0
全屏

fullscreen 属性非常适合创建流畅的页面加载器。它添加了半透明覆盖层,并在其中心放置了一个旋转加载符号。

Aquileo | CodeSandbox Icon
Aquileo | Hitu Icon
Aquileo | codepen icon
Aquileo | External Link Icon
Aquileo | Expand Icon
各种大小

小的用于文本加载,默认用于卡片容器级加载,大的用于页面级加载。

Aquileo | CodeSandbox Icon
Aquileo | Hitu Icon
Aquileo | codepen icon
Aquileo | External Link Icon
Aquileo | Expand Icon
Loading
Loading
Loading
Loading...
Alert message title
Further details about the context of this alert.
自定义描述文案

自定义描述文案。

Aquileo | CodeSandbox Icon
Aquileo | Hitu Icon
Aquileo | codepen icon
Aquileo | External Link Icon
Aquileo | Expand Icon
自定义指示符

使用自定义指示符。

Aquileo | CodeSandbox Icon
Aquileo | Hitu Icon
Aquileo | codepen icon
Aquileo | External Link Icon
Aquileo | Expand Icon
自定义语义结构的样式和类

通过 classNames 和 styles 传入对象/函数可以自定义 Spin 的语义化结构样式。

Aquileo | CodeSandbox Icon
Aquileo | Hitu Icon
Aquileo | codepen icon
Aquileo | External Link Icon
Aquileo | Expand Icon
6.0.0