仅桌面端保证样式
Timeline 时间轴
垂直时间轴,按时间顺序展示一系列节点。竖向轴线与圆点居中对齐、逐节点连贯绘制;支持左右交替排列、时间戳四种位置、语义色 / 任意色圆点、图标与自定义圆点、末尾加载占位幽灵节点。
基础用法
节点内容写在 eb-timeline-item 默认插槽,timestamp 显示时间戳(默认在内容下方),type 设置语义色圆点。
创建订单
支付完成
等待发货
订单关闭
左右交替
mode="alternate" 时节点按奇偶交替分布在轴两侧,配合 label 在对侧显示标签;variant="filled" 切换为实心圆点(item 同名属性可单独覆盖容器)。
需求评审通过
08-01
开发联调完成
08-02
修复线上缺陷
08-03
时间戳位置 placement
placement 支持四种位置:top / bottom 把时间戳放在节点内容上方或下方;start / end 把时间戳移到轴的对侧(left 模式下在轴右侧),可同时与 label 共存于两侧。
时间戳在内容上方
默认在内容下方
时间戳移到轴左侧
时间戳移到轴右侧
自定义颜色与空心
color 支持任意色值,也接受语义色名(primary / success / warning / danger / info、blue / green / red / gray / warning,自动映射主题 token);hollow 强制该节点为空心圆点(在 filled 容器中可单独回退为描边样式)。
任意色值
语义色名映射主题 token
空心圆点
图标、尺寸与自定义圆点
icon 传入图标名替换圆点内图标,size="large" 加大圆点直径;需要完全接管时使用 #dot 插槽。
图标圆点(large 尺寸)
图标圆点
完全自定义圆点
加载占位
开启 pending 后末尾追加幽灵节点(灰色加载圆点),传字符串可自定义文案,pendingDot 可替换幽灵节点的圆点。
加载历史记录中
创建订单
支付完成
倒序
reverse 视觉上倒序展示(配合 flex 反转,常用于「最新在上」的消息流);即使开启倒序,pending 幽灵节点仍保持在末尾。
同步最新动态中
创建订单
支付完成
API
Timeline Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| mode | 节点排列模式:left 轴在左 / right 轴在右 / alternate 奇偶交替 | left | right | alternate | left |
| reverse | 节点倒序展示(pending 幽灵节点仍在末尾) | boolean | false |
| pending | 末尾幽灵节点,true 用默认文案,字符串自定义 | boolean | string | false |
| pendingDot | 幽灵节点自定义圆点(组件或已注册组件名) | object | string | — |
| variant | 节点样式变体,item 未显式指定时继承 | outlined | filled | outlined |
Timeline Slots
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| default | eb-timeline-item 节点列表 | — | — |
TimelineItem Props
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| timestamp | 时间戳文本 | string | — |
| placement | 时间戳位置:top / bottom 在内容侧,start / end 移到轴对侧 | top | bottom | start | end | bottom |
| label | 轴对侧标签文本 | string | — |
| type | 语义色圆点 | primary | success | warning | danger | info | — |
| color | 自定义圆点颜色,语义色名或任意色值,优先级高于 type | string | — |
| hollow | 空心圆点(强制 outlined 变体) | boolean | false |
| variant | 节点变体,缺省继承容器(hollow 优先于继承值) | outlined | filled | — |
| size | 圆点尺寸,large 为 14px、normal 为 10px | normal | large | normal |
| icon | 圆点内图标(未提供 dot 插槽时生效,字符串为图标名) | string | object | — |
| loading | 加载中(灰色圆点,容器 pending 节点内部使用) | boolean | false |
| position | 手动指定节点位置 start / end,覆盖 mode 推断 | start | end | — |
| isPending / index | 内部使用(幽灵节点标记与 alternate 奇偶推算) | boolean / number | false / 0 |
TimelineItem Slots
| 参数 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| default | 节点内容 | — | — |
| dot | 自定义圆点(优先于 icon) | — | — |
| label | 自定义对侧标签 | — | — |