mirror of
https://gitee.com/element-plus/element-plus.git
synced 2024-12-15 18:01:24 +08:00
140 lines
3.4 KiB
Markdown
140 lines
3.4 KiB
Markdown
## Timeline 时间线
|
||
|
||
可视化地呈现时间流信息。
|
||
|
||
### 基础用法
|
||
|
||
Timeline 可拆分成多个按照时间戳排列的 activity，时间戳是其区分于其他控件的重要特征，使⽤时注意与 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: '活动按期开始',
|
||
timestamp: '2018-04-15'
|
||
}, {
|
||
content: '通过审核',
|
||
timestamp: '2018-04-13'
|
||
}, {
|
||
content: '创建成功',
|
||
timestamp: '2018-04-11'
|
||
}]
|
||
};
|
||
}
|
||
};
|
||
</script>
|
||
```
|
||
:::
|
||
|
||
### ⾃定义节点样式
|
||
|
||
可根据实际场景⾃定义节点尺⼨、颜⾊，或直接使⽤图标。
|
||
|
||
:::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"
|
||
:timestamp="activity.timestamp">
|
||
{{activity.content}}
|
||
</el-timeline-item>
|
||
</el-timeline>
|
||
</div>
|
||
|
||
<script>
|
||
export default {
|
||
data() {
|
||
return {
|
||
activities: [{
|
||
content: '支持使用图标',
|
||
timestamp: '2018-04-12 20:46',
|
||
size: 'large',
|
||
type: 'primary',
|
||
icon: 'el-icon-more'
|
||
}, {
|
||
content: '支持自定义颜色',
|
||
timestamp: '2018-04-03 20:46',
|
||
color: '#0bbd87'
|
||
}, {
|
||
content: '支持自定义尺寸',
|
||
timestamp: '2018-04-03 20:46',
|
||
size: 'large'
|
||
}, {
|
||
content: '默认样式的节点',
|
||
timestamp: '2018-04-03 20:46'
|
||
}]
|
||
};
|
||
}
|
||
};
|
||
</script>
|
||
```
|
||
:::
|
||
|
||
### ⾃定义时间戳
|
||
|
||
当内容在垂直⽅向上过⾼时，可将时间戳置于内容之上。
|
||
|
||
:::demo
|
||
```html
|
||
<div class="block">
|
||
<el-timeline>
|
||
<el-timeline-item timestamp="2018/4/12" placement="top">
|
||
<el-card>
|
||
<h4>更新 Github 模板</h4>
|
||
<p>王小虎 提交于 2018/4/12 20:46</p>
|
||
</el-card>
|
||
</el-timeline-item>
|
||
<el-timeline-item timestamp="2018/4/3" placement="top">
|
||
<el-card>
|
||
<h4>更新 Github 模板</h4>
|
||
<p>王小虎 提交于 2018/4/3 20:46</p>
|
||
</el-card>
|
||
</el-timeline-item>
|
||
<el-timeline-item timestamp="2018/4/2" placement="top">
|
||
<el-card>
|
||
<h4>更新 Github 模板</h4>
|
||
<p>王小虎 提交于 2018/4/2 20:46</p>
|
||
</el-card>
|
||
</el-timeline-item>
|
||
</el-timeline>
|
||
</div>
|
||
```
|
||
:::
|
||
|
||
### Timeline-item Attributes
|
||
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
||
|---------- |-------- |---------- |------------- |-------- |
|
||
| timestamp | 时间戳 | string | - | — |
|
||
| hide-timestamp | 是否隐藏时间戳 | boolean | — | false |
|
||
| placement | 时间戳位置 | string | top / bottom | bottom |
|
||
| type | 节点类型 | string | primary / success / warning / danger / info | - |
|
||
| color | 节点颜色 | string | hsl / hsv / hex / rgb | - |
|
||
| size | 节点尺寸 | string | normal / large | normal |
|
||
| icon | 节点图标 | string | — | - |
|
||
|
||
### Timeline-Item Slot
|
||
| name | 说明 |
|
||
|------|--------|
|
||
| — | Timeline-Item 的内容 |
|
||
| dot | 自定义节点 |
|