ant-design/components/empty/index.zh-CN.md

---
category: Components
subtitle: 空状态
type: 数据展示
title: Empty
cols: 1
---

空状态时的展示占位图。

## 何时使用

- 当目前没有数据时，用于显式的用户提示。
- 初始化场景时的引导创建流程。

## API

```jsx
<Empty>
  <Button>创建</Button>
</Empty>
```

| 参数 | 说明 | 类型 | 默认值 | 版本 |
| --- | --- | --- | --- | --- |
| description | 自定义描述内容 | string \| ReactNode | - |  |
| imageStyle | 图片样式 | CSSProperties | - |  |
| image | 设置显示图片，为 string 时表示自定义图片地址。 | string \| ReactNode | `Empty.PRESENTED_IMAGE_DEFAULT` |  |

## 内置图片

- Empty.PRESENTED_IMAGE_SIMPLE

  <img src="https://user-images.githubusercontent.com/507615/54591679-b0ceb580-4a65-11e9-925c-ad15b4eae93d.png" height="35px">

- Empty.PRESENTED_IMAGE_DEFAULT

  <img src="https://user-images.githubusercontent.com/507615/54591670-ac0a0180-4a65-11e9-846c-e55ffce0fe7b.png" height="100px">
New Component: Empty (#13651) 2018-12-26 16:01:00 +08:00			`---`
			`category: Components`
			`subtitle: 空状态`
			`type: 数据展示`
			`title: Empty`
			`cols: 1`
			`---`

			`空状态时的展示占位图。`

			`## 何时使用`

:memo: Improve Empty doc 2019-04-02 10:26:45 +08:00			`- 当目前没有数据时，用于显式的用户提示。`
			`- 初始化场景时的引导创建流程。`
feat: Improve Empty component again (#15487) * feat: rewrite component empty * refactor: use static variable * refactor: extraction function for component empty * docs: update docs and demo * feature: image add image style prop * docs: update doc of component empty * docs: add since comment to imageStyle prop * test: update snapshots * style: use number in style * docs: update docs of component empty * docs: update doc of component empty * test: fix test broken * docs: update docs for empty component * refactor: rewrite empty component * docs: update doc of component empty * doc: change image size 2019-03-20 17:45:35 +08:00
New Component: Empty (#13651) 2018-12-26 16:01:00 +08:00			`## API`

			```jsx
			`<Empty>`
			`<Button>创建</Button>`
			`</Empty>`
			```

docs: show version Number features were added (#17373) * docs: add api first appearance * docs: fix auto-complete doc * docs: replace Version Added with Version * docs: date picker common method * docs: date picker common method * docs: tree * docs: remove meaningless 3.0.0 2019-07-11 14:14:33 +08:00			`\| 参数 \| 说明 \| 类型 \| 默认值 \| 版本 \|`
			`\| --- \| --- \| --- \| --- \| --- \|`
docs(update): removed 3.x version description in 4.0-prepare (#19827) * docs(update): removed 3.x version description in 4.0-prepare ref #19815 * docs(update): update docs remove carousel/index.zh-CN.md empty version column * docs(update): update docs remove carousel/index.en-US.md empty version column 2019-11-20 20:31:43 +08:00			`\| description \| 自定义描述内容 \| string \\| ReactNode \| - \| \|`
			`\| imageStyle \| 图片样式 \| CSSProperties \| - \| \|`
			\| image \| 设置显示图片，为 string 时表示自定义图片地址。 \| string \\| ReactNode \| `Empty.PRESENTED_IMAGE_DEFAULT` \| \|
:memo: Improve Empty doc 2019-04-02 10:26:45 +08:00
docs(update): removed 3.x version description in 4.0-prepare (#19827) * docs(update): removed 3.x version description in 4.0-prepare ref #19815 * docs(update): update docs remove carousel/index.zh-CN.md empty version column * docs(update): update docs remove carousel/index.en-US.md empty version column 2019-11-20 20:31:43 +08:00			`## 内置图片`
:memo: Improve Empty doc 2019-04-02 10:26:45 +08:00
:lipstick: prittier all files 2019-05-07 14:57:32 +08:00			`- Empty.PRESENTED_IMAGE_SIMPLE`
:memo: Improve Empty doc 2019-04-02 10:26:45 +08:00
			`<img src="https://user-images.githubusercontent.com/507615/54591679-b0ceb580-4a65-11e9-925c-ad15b4eae93d.png" height="35px">`

:lipstick: prittier all files 2019-05-07 14:57:32 +08:00			`- Empty.PRESENTED_IMAGE_DEFAULT`
:memo: Improve Empty doc 2019-04-02 10:26:45 +08:00
			`<img src="https://user-images.githubusercontent.com/507615/54591670-ac0a0180-4a65-11e9-846c-e55ffce0fe7b.png" height="100px">`