Skeleton
骨架屏

在需要等待加载内容的位置提供一个占位图形组合。
使用import{ Skeleton }from"antd";

何时使用

  • 网络较慢,需要长时间等待加载处理的情况下。
  • 图文信息内容较多的列表/卡片中。
  • 只在第一次加载数据的时候使用。
  • 可以被 Spin 完全代替,但是在可用的场景下可以比 Spin 提供更好的视觉效果和用户体验。

代码演示

最简单的占位效果。

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code

更复杂的组合。

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code

显示动画效果。

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code
Image placeholder

骨架按钮、头像、输入框、图像和自定义节点。

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code

Ant Design, a design language

We supply a series of design principles, practical patterns and high quality design resources (Sketch and Axure), to help people create their product prototypes beautifully and efficiently.

加载占位图包含子组件。

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code

在列表组件中使用加载占位符。

CodeSandbox Icon
codepen icon
External Link Icon
expand codeexpand code

API

通用属性参考:通用属性

Skeleton

属性说明类型默认值
active是否展示动画效果booleanfalse
avatar是否显示头像占位图boolean | SkeletonAvatarPropsfalse
loading为 true 时,显示占位图。反之则直接展示子组件boolean-
paragraph是否显示段落占位图boolean | SkeletonParagraphPropstrue
round为 true 时,段落和标题显示圆角booleanfalse
title是否显示标题占位图boolean | SkeletonTitlePropstrue

SkeletonAvatarProps

属性说明类型默认值
active是否展示动画效果,仅在单独使用头像骨架时生效booleanfalse
shape指定头像的形状circle | square-
size设置头像占位图的大小number | large | small | default-

SkeletonTitleProps

属性说明类型默认值
width设置标题占位图的宽度number | string-

SkeletonParagraphProps

属性说明类型默认值
rows设置段落占位图的行数number-
width设置段落占位图的宽度,若为数组时则为对应的每行宽度,反之则是最后一行的宽度number | string | Array<number | string>-

SkeletonButtonProps

属性说明类型默认值版本
active是否展示动画效果booleanfalse
block将按钮宽度调整为其父宽度的选项booleanfalse4.17.0
shape指定按钮的形状circle | round | square | default-
size设置按钮的大小large | small | default-

SkeletonInputProps

属性说明类型默认值
active是否展示动画效果booleanfalse
size设置输入框的大小large | small | default-

主题变量(Design Token)

组件 Token如何定制?

Token 名称描述类型默认值
blockRadius骨架屏圆角number4
gradientFromColor渐变色起点颜色stringrgba(0,0,0,0.06)
gradientToColor渐变色终点颜色stringrgba(0,0,0,0.15)
paragraphLiHeight段落骨架屏单行高度number16
paragraphMarginTop段落骨架屏上间距number28
titleHeight标题骨架屏高度string | number16

全局 Token如何定制?