mirror of
https://gitee.com/ElemeFE/element.git
synced 2024-12-02 20:28:52 +08:00
f17533ab11
* Table: fix params order of row events (#12086) * Timeline: add timeline component (#11736) * Timeline: add timeline component * Timeline: add timeline component * Timeline: add test case * Timeline: fix icon class * Timeline: update docs * Timeline: fix test case * Timeline: remove pending attribute * Timeline: fix docs * Timeline: make reverse default to false * Timline: fix test case * Timeline: update element-ui.d.ts * Timeline: optimize code
4.9 KiB
4.9 KiB
Timeline
Visually display timeline.
Basic usage
Timeline can be split into multiple activities in ascending or descending. Timestamps are important features that distinguish them from other components. Note the difference with Steps.
:::demo
<div class="block">
<div class="radio">
Order:
<el-radio-group v-model="reverse">
<el-radio :label="true">descending</el-radio>
<el-radio :label="false">ascending</el-radio>
</el-radio-group>
</div>
<el-timeline :reverse="reverse">
<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 {
reverse: true,
activities: [{
content: 'Success',
timestamp: '2018-04-11'
}, {
content: 'Approved',
timestamp: '2018-04-13'
}, {
content: 'Event start',
timestamp: '2018-04-15'
}]
};
}
};
</script>
:::
Custom node
Size, color, and icons can be customized in node.
:::demo
<div class="block">
<el-timeline>
<el-timeline-item
v-for="(activity, index) in activities2"
:key="index"
:icon="activity.icon"
:type="activity.type"
:color="activity.color"
:size="activity.size"
:timestamp="activity.timestamp">
{{activity.content}}
</el-timeline-item>
</el-timeline>
</div>
<script>
export default {
data() {
return {
activities2: [{
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: '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
<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 Attributes
Attribute | Description | Type | Accepted Values | Default |
---|---|---|---|---|
reverse | whether the node is ascending or descending, default is ascending | boolean | — | false |
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 | — | - |
Timeline-Item Slot
name | Description |
---|---|
— | Custom content for timeline item |
dot | Custom defined node |