Skeleton
骨架屏

在需要等待加载内容的位置提供一个占位图形组合。

使用import{ Skeleton }from"antd";

源码components/skeleton

文档

编辑此页更新日志

何时使用

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

代码演示

基本

最简单的占位效果。

复杂的组合

更复杂的组合。

动画效果

显示动画效果。

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.

包含子组件

加载占位图包含子组件。

列表

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

API

通用属性参考：通用属性

Skeleton

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

SkeletonAvatarProps

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

SkeletonTitleProps

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

SkeletonParagraphProps

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

SkeletonButtonProps

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

SkeletonInputProps

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

主题变量（Design Token）

组件 Token如何定制？

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

Skeleton骨架屏