Empty Component
Empty component provides placeholder hints for empty states with customizable images and content.
When to Use
- Empty data states
- No search results
- Placeholder content
- Error states
Basic Usage
<template>
<el-empty />
</template>
Custom Image
<template>
<el-empty image="https://example.com/empty.png" />
</template>
Image Size
<template>
<el-empty :image-size="200" />
</template>
Bottom Content
<template>
<el-empty>
<el-button type="primary">Button</el-button>
</el-empty>
</template>
Custom Description
<template>
<el-empty description="No data found">
<el-button type="primary">Add Data</el-button>
</el-empty>
</template>
API Reference
Attributes
| Name | Description | Type | Default |
|---|---|---|---|
| image | Image URL | string |
'' |
| image-size | Image size (width) | number |
— |
| description | Description text | string |
'' |
Slots
| Name | Description |
|---|---|
| default | Content as bottom content |
| image | Content as image |
| description | Content as description |
Common Patterns
Empty Table State
<template>
<el-table :data="tableData">
<el-table-column prop="name" label="Name" />
<template #empty>
<el-empty description="No data available">
<el-button type="primary" @click="fetchData">Refresh</el-button>
</el-empty>
</template>
</el-table>
</template>
Custom SVG Image
<template>
<el-empty>
<template #image>
<svg viewBox="0 0 100 100">
<!-- Custom SVG -->
</svg>
</template>
</el-empty>
</template>
Best Practices
- Provide actionable buttons in empty states
- Use descriptive messages
- Customize image size based on context