2018-08-22 23:34:36 +08:00
|
|
|
---
|
|
|
|
category: Components
|
2018-10-26 00:13:54 +08:00
|
|
|
subtitle: 骨架屏
|
2018-11-04 16:20:35 +08:00
|
|
|
type: 反馈
|
2018-08-22 23:34:36 +08:00
|
|
|
title: Skeleton
|
|
|
|
cols: 1
|
|
|
|
---
|
|
|
|
|
2018-10-26 00:13:54 +08:00
|
|
|
在需要等待加载内容的位置提供一个占位图形组合。
|
2018-08-22 23:34:36 +08:00
|
|
|
|
|
|
|
## 何时使用
|
|
|
|
|
|
|
|
- 网络较慢,需要长时间等待加载处理的情况下。
|
|
|
|
- 图文信息内容较多的列表/卡片中。
|
2019-11-12 22:43:50 +08:00
|
|
|
- 只在第一次加载数据的时候使用。
|
2019-01-29 15:23:23 +08:00
|
|
|
- 可以被 Spin 完全代替,但是在可用的场景下可以比 Spin 提供更好的视觉效果和用户体验。
|
2018-08-22 23:34:36 +08:00
|
|
|
|
|
|
|
## API
|
|
|
|
|
|
|
|
### Skeleton
|
|
|
|
|
2019-07-11 14:14:33 +08:00
|
|
|
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
| active | 是否展示动画效果 | boolean | false | 3.9.0 |
|
|
|
|
| avatar | 是否显示头像占位图 | boolean \| [SkeletonAvatarProps](#SkeletonAvatarProps) | false | 3.9.0 |
|
|
|
|
| loading | 为 `true` 时,显示占位图。反之则直接展示子组件 | boolean | - | 3.9.0 |
|
|
|
|
| paragraph | 是否显示段落占位图 | boolean \| [SkeletonParagraphProps](#SkeletonParagraphProps) | true | 3.9.0 |
|
|
|
|
| title | 是否显示标题占位图 | boolean \| [SkeletonTitleProps](#SkeletonTitleProps) | true | 3.9.0 |
|
2018-08-22 23:34:36 +08:00
|
|
|
|
|
|
|
### SkeletonAvatarProps
|
|
|
|
|
2019-07-11 14:14:33 +08:00
|
|
|
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
| ----- | -------------------- | --------------------------------------------- | ------ | ----- |
|
|
|
|
| size | 设置头像占位图的大小 | number \| Enum{ 'large', 'small', 'default' } | - | 3.9.0 |
|
|
|
|
| shape | 指定头像的形状 | Enum{ 'circle', 'square' } | - | 3.9.0 |
|
2018-08-22 23:34:36 +08:00
|
|
|
|
|
|
|
### SkeletonTitleProps
|
|
|
|
|
2019-07-11 14:14:33 +08:00
|
|
|
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
| ----- | -------------------- | ---------------- | ------ | ----- |
|
|
|
|
| width | 设置标题占位图的宽度 | number \| string | - | 3.9.0 |
|
2018-08-22 23:34:36 +08:00
|
|
|
|
|
|
|
### SkeletonParagraphProps
|
|
|
|
|
2019-07-11 14:14:33 +08:00
|
|
|
| 属性 | 说明 | 类型 | 默认值 | 版本 |
|
|
|
|
| --- | --- | --- | --- | --- |
|
|
|
|
| rows | 设置段落占位图的行数 | number | - | 3.9.0 |
|
|
|
|
| width | 设置段落占位图的宽度,若为数组时则为对应的每行宽度,反之则是最后一行的宽度 | number \| string \| Array<number \| string> | - | 3.9.0 |
|