2018-08-22 23:34:36 +08:00
---
category: Components
2018-09-29 17:08:44 +08:00
type: Feedback
2018-08-22 23:34:36 +08:00
title: Skeleton
cols: 1
---
2019-04-19 22:39:21 +08:00
Provide a placeholder while you wait for content to load, or to visualise content that doesn't exist yet.
2019-05-07 14:57:32 +08:00
2018-08-22 23:34:36 +08:00
## When To Use
2019-04-19 22:39:21 +08:00
- When a resource needs long time to load.
- When the component contains lots of information, such as List or Card.
- Only works when loading data for the first time.
- Could be replaced by Spin in any situation, but can provide a better user experience.
2018-08-22 23:34:36 +08:00
## API
### Skeleton
2019-07-11 14:14:33 +08:00
| Property | Description | Type | Default | Version |
| --- | --- | --- | --- | --- |
| active | Show animation effect | boolean | false | 3.9.0 |
| avatar | Show avatar placeholder | boolean \| [SkeletonAvatarProps ](#SkeletonAvatarProps ) | false | 3.9.0 |
| loading | Display the skeleton when `true` | boolean | - | 3.9.0 |
| paragraph | Show paragraph placeholder | boolean \| [SkeletonParagraphProps ](#SkeletonParagraphProps ) | true | 3.9.0 |
| title | Show title placeholder | boolean \| [SkeletonTitleProps ](#SkeletonTitleProps ) | true | 3.9.0 |
2018-08-22 23:34:36 +08:00
### SkeletonAvatarProps
2019-07-11 14:14:33 +08:00
| Property | Description | Type | Default | Version |
| --- | --- | --- | --- | --- |
| size | Set the size of avatar | number \| Enum{ 'large', 'small', 'default' } | - | 3.9.0 |
| shape | Set the shape of avatar | Enum{ 'circle', 'square' } | - | 3.9.0 |
2018-08-22 23:34:36 +08:00
### SkeletonTitleProps
2019-07-11 14:14:33 +08:00
| Property | Description | Type | Default | Version |
| -------- | ---------------------- | ---------------- | ------- | ------- |
| width | Set the width of title | number \| string | - | 3.9.0 |
2018-08-22 23:34:36 +08:00
### SkeletonParagraphProps
2019-07-11 14:14:33 +08:00
| Property | Description | Type | Default | Version |
| --- | --- | --- | --- | --- |
| rows | Set the row count of paragraph | number | - | 3.9.0 |
| width | Set the width of paragraph. When width is an Array, it can set the width of each row. Otherwise only set the last row width | number \| string \| Array< number \| string > | - | 3.9.0 |