Empty

Empty state placeholder.

When To Use#

When there is no data provided, display for friendly tips.
User tutorial to create something in fresh new situation.

Examples

No Data

Basic

Simplest Usage.

import { Empty } from 'antd';

ReactDOM.render(<Empty />, mountNode);

No Data

Chose image

You can choose another style of image by setting image to Empty.PRESENTED_IMAGE_SIMPLE.

import { Empty } from 'antd';

ReactDOM.render(<Empty image={Empty.PRESENTED_IMAGE_SIMPLE} />, mountNode);

Customize Description

Customize

Customize image source, image size, description and extra content.

import { Empty, Button } from 'antd';

ReactDOM.render(
  <Empty
    image="https://gw.alipayobjects.com/zos/antfincdn/ZHrcdLPrvN/empty.svg"
    imageStyle={{
      height: 60,
    }}
    description={
      <span>
        Customize <a href="#API">Description</a>
      </span>
    }
  >
    <Button type="primary">Create Now</Button>
  </Empty>,
  mountNode,
);

Select

TreeSelect

Cascader

Transfer

0 item

No Data

0 item

No Data

Table

Name	Age
No Data

List

No Data

ConfigProvider

Use ConfigProvider set global Empty style.

import {
  ConfigProvider,
  Switch,
  Divider,
  TreeSelect,
  Select,
  Cascader,
  Transfer,
  Table,
  List,
} from 'antd';
import { SmileOutlined } from '@ant-design/icons';

const customizeRenderEmpty = () => (
  <div style={{ textAlign: 'center' }}>
    <SmileOutlined style={{ fontSize: 20 }} />
    <p>Data Not Found</p>
  </div>
);

const style = { width: 200 };

class Demo extends React.Component {
  state = {
    customize: false,
  };

  render() {
    const { customize } = this.state;
    return (
      <div>
        <Switch
          unCheckedChildren="default"
          checkedChildren="customize"
          checked={customize}
          onChange={val => {
            this.setState({ customize: val });
          }}
        />

        <Divider />

        <ConfigProvider renderEmpty={customize && customizeRenderEmpty}>
          <div className="config-provider">
            <h4>Select</h4>
            <Select style={style} />

            <h4>TreeSelect</h4>
            <TreeSelect style={style} treeData={[]} />

            <h4>Cascader</h4>
            <Cascader style={style} options={[]} showSearch />

            <h4>Transfer</h4>
            <Transfer />

            <h4>Table</h4>
            <Table
              style={{ marginTop: 8 }}
              columns={[
                {
                  title: 'Name',
                  dataIndex: 'name',
                  key: 'name',
                },
                {
                  title: 'Age',
                  dataIndex: 'age',
                  key: 'age',
                },
              ]}
            />

            <h4>List</h4>
            <List />
          </div>
        </ConfigProvider>
      </div>
    );
  }
}

ReactDOM.render(<Demo />, mountNode);

No description

Simplest Usage with no description.

import { Empty } from 'antd';

ReactDOM.render(<Empty description={false} />, mountNode);

API#

<Empty>
  <Button>Create</Button>
</Empty>

Property	Description	Type	Default
description	Customize description	string \| ReactNode	-
imageStyle	The style of image	CSSProperties	-
image	Customize image. Will treat as image url when string provided	string \| ReactNode	`Empty.PRESENTED_IMAGE_DEFAULT`

Built-in images#

Empty.PRESENTED_IMAGE_SIMPLE
Empty.PRESENTED_IMAGE_DEFAULT