mirror of
https://gitee.com/element-plus/element-plus.git
synced 2024-12-15 09:50:58 +08:00
c2b6c30f92
* feat: timeline add hollow prop * feat: update * feat: format Co-authored-by: kooriookami <18114643032@163.com>
173 lines
4.4 KiB
Markdown
173 lines
4.4 KiB
Markdown
## Timeline
|
|
|
|
Visually display timeline.
|
|
|
|
### Basic usage
|
|
|
|
Timeline can be split into multiple activities. Timestamps are important features that distinguish them from other components. Note the difference with Steps.
|
|
|
|
:::demo
|
|
|
|
```html
|
|
<div class="block">
|
|
<el-timeline>
|
|
<el-timeline-item
|
|
v-for="(activity, index) in activities"
|
|
:key="index"
|
|
:timestamp="activity.timestamp"
|
|
>
|
|
{{activity.content}}
|
|
</el-timeline-item>
|
|
</el-timeline>
|
|
</div>
|
|
|
|
<script>
|
|
export default {
|
|
data() {
|
|
return {
|
|
activities: [
|
|
{
|
|
content: 'Event start',
|
|
timestamp: '2018-04-15',
|
|
},
|
|
{
|
|
content: 'Approved',
|
|
timestamp: '2018-04-13',
|
|
},
|
|
{
|
|
content: 'Success',
|
|
timestamp: '2018-04-11',
|
|
},
|
|
],
|
|
}
|
|
},
|
|
}
|
|
</script>
|
|
```
|
|
|
|
:::
|
|
|
|
### Custom node
|
|
|
|
Size, color, and icons can be customized in node.
|
|
|
|
:::demo
|
|
|
|
```html
|
|
<div class="block">
|
|
<el-timeline>
|
|
<el-timeline-item
|
|
v-for="(activity, index) in activities"
|
|
:key="index"
|
|
:icon="activity.icon"
|
|
:type="activity.type"
|
|
:color="activity.color"
|
|
:size="activity.size"
|
|
:hollow="activity.hollow"
|
|
:timestamp="activity.timestamp"
|
|
>
|
|
{{activity.content}}
|
|
</el-timeline-item>
|
|
</el-timeline>
|
|
</div>
|
|
|
|
<script>
|
|
export default {
|
|
data() {
|
|
return {
|
|
activities: [
|
|
{
|
|
content: 'Custom icon',
|
|
timestamp: '2018-04-12 20:46',
|
|
size: 'large',
|
|
type: 'primary',
|
|
icon: 'el-icon-more',
|
|
},
|
|
{
|
|
content: 'Custom color',
|
|
timestamp: '2018-04-03 20:46',
|
|
color: '#0bbd87',
|
|
},
|
|
{
|
|
content: 'Custom size',
|
|
timestamp: '2018-04-03 20:46',
|
|
size: 'large',
|
|
},
|
|
{
|
|
content: 'Custom hollow',
|
|
timestamp: '2018-04-03 20:46',
|
|
type: 'primary',
|
|
hollow: true,
|
|
},
|
|
{
|
|
content: 'Default node',
|
|
timestamp: '2018-04-03 20:46',
|
|
},
|
|
],
|
|
}
|
|
},
|
|
}
|
|
</script>
|
|
```
|
|
|
|
:::
|
|
|
|
### Custom timestamp
|
|
|
|
Timestamp can be placed on top of content when content is too high.
|
|
|
|
:::demo
|
|
|
|
```html
|
|
<div class="block">
|
|
<el-timeline>
|
|
<el-timeline-item timestamp="2018/4/12" placement="top">
|
|
<el-card>
|
|
<h4>Update Github template</h4>
|
|
<p>Tom committed 2018/4/12 20:46</p>
|
|
</el-card>
|
|
</el-timeline-item>
|
|
<el-timeline-item timestamp="2018/4/3" placement="top">
|
|
<el-card>
|
|
<h4>Update Github template</h4>
|
|
<p>Tom committed 2018/4/3 20:46</p>
|
|
</el-card>
|
|
</el-timeline-item>
|
|
<el-timeline-item timestamp="2018/4/2" placement="top">
|
|
<el-card>
|
|
<h4>Update Github template</h4>
|
|
<p>Tom committed 2018/4/2 20:46</p>
|
|
</el-card>
|
|
</el-timeline-item>
|
|
</el-timeline>
|
|
</div>
|
|
```
|
|
|
|
:::
|
|
|
|
### Timeline Slots
|
|
|
|
| Name | Description |
|
|
| ---- | --------------------------- |
|
|
| — | Custom content for timeline |
|
|
|
|
### Timeline-Item Attributes
|
|
|
|
| Attribute | Description | Type | Accepted Values | Default |
|
|
| -------------- | ------------------------- | ------- | ------------------------------------------- | ------- |
|
|
| timestamp | timestamp content | string | — | — |
|
|
| hide-timestamp | whether to show timestamp | boolean | — | false |
|
|
| placement | position of timestamp | string | top / bottom | bottom |
|
|
| type | node type | string | primary / success / warning / danger / info | — |
|
|
| color | background color of node | string | hsl / hsv / hex / rgb | — |
|
|
| size | node size | string | normal / large | normal |
|
|
| icon | icon class name | string | — | — |
|
|
| hollow | icon is hollow | boolean | — | false |
|
|
|
|
### Timeline-Item Slots
|
|
|
|
| Name | Description |
|
|
| ---- | -------------------------------- |
|
|
| — | Custom content for timeline item |
|
|
| dot | Custom defined node |
|