项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。
仅桌面端保证样式

Timeline 时间轴 ​

垂直时间轴,按时间顺序展示一系列节点。竖向轴线与圆点居中对齐、逐节点连贯绘制;支持左右交替排列、时间戳四种位置、语义色 / 任意色圆点、图标与自定义圆点、末尾加载占位幽灵节点。

基础用法 ​

节点内容写在 eb-timeline-item 默认插槽,timestamp 显示时间戳(默认在内容下方),type 设置语义色圆点。

  • 创建订单
    2026-08-01 09:00
  • 支付完成
    2026-08-01 10:30
  • 等待发货
    2026-08-01 12:00
  • 订单关闭
    2026-08-02 08:00
  • 左右交替 ​

    mode="alternate" 时节点按奇偶交替分布在轴两侧,配合 label 在对侧显示标签;variant="filled" 切换为实心圆点(item 同名属性可单独覆盖容器)。

  • 需求评审通过
    09:00
    08-01
  • 开发联调完成
    14:00
    08-02
  • 修复线上缺陷
    10:00
    08-03
  • 时间戳位置 placement ​

    placement 支持四种位置:top / bottom 把时间戳放在节点内容上方或下方;start / end 把时间戳移到轴的对侧(left 模式下在轴右侧),可同时与 label 共存于两侧。

  • 2026-08-01 09:00
    时间戳在内容上方
  • 默认在内容下方
    2026-08-01 10:30
  • 09:45
    时间戳移到轴左侧
  • 时间戳移到轴右侧
    10:45
  • 自定义颜色与空心 ​

    color 支持任意色值,也接受语义色名(primary / success / warning / danger / info、blue / green / red / gray / warning,自动映射主题 token);hollow 强制该节点为空心圆点(在 filled 容器中可单独回退为描边样式)。

  • 任意色值
  • 语义色名映射主题 token
  • 空心圆点
  • 图标、尺寸与自定义圆点 ​

    icon 传入图标名替换圆点内图标,size="large" 加大圆点直径;需要完全接管时使用 #dot 插槽。

  • 图标圆点(large 尺寸)
  • 图标圆点
  • 完全自定义圆点
  • 加载占位 ​

    开启 pending 后末尾追加幽灵节点(灰色加载圆点),传字符串可自定义文案,pendingDot 可替换幽灵节点的圆点。

  • 加载历史记录中
  • 创建订单
    2026-08-01 09:00
  • 支付完成
    2026-08-01 10:30
  • 倒序 ​

    reverse 视觉上倒序展示(配合 flex 反转,常用于「最新在上」的消息流);即使开启倒序,pending 幽灵节点仍保持在末尾。

  • 同步最新动态中
  • 创建订单
    2026-08-01 09:00
  • 支付完成
    2026-08-01 10:30
  • API ​

    Timeline Props

    参数说明类型默认值
    mode节点排列模式:left 轴在左 / right 轴在右 / alternate 奇偶交替left | right | alternateleft
    reverse节点倒序展示(pending 幽灵节点仍在末尾)booleanfalse
    pending末尾幽灵节点,true 用默认文案,字符串自定义boolean | stringfalse
    pendingDot幽灵节点自定义圆点(组件或已注册组件名)object | string—
    variant节点样式变体,item 未显式指定时继承outlined | filledoutlined

    Timeline Slots

    参数说明类型默认值
    defaulteb-timeline-item 节点列表——

    TimelineItem Props

    参数说明类型默认值
    timestamp时间戳文本string—
    placement时间戳位置:top / bottom 在内容侧,start / end 移到轴对侧top | bottom | start | endbottom
    label轴对侧标签文本string—
    type语义色圆点primary | success | warning | danger | info—
    color自定义圆点颜色,语义色名或任意色值,优先级高于 typestring—
    hollow空心圆点(强制 outlined 变体)booleanfalse
    variant节点变体,缺省继承容器(hollow 优先于继承值)outlined | filled—
    size圆点尺寸,large 为 14px、normal 为 10pxnormal | largenormal
    icon圆点内图标(未提供 dot 插槽时生效,字符串为图标名)string | object—
    loading加载中(灰色圆点,容器 pending 节点内部使用)booleanfalse
    position手动指定节点位置 start / end,覆盖 mode 推断start | end—
    isPending / index内部使用(幽灵节点标记与 alternate 奇偶推算)boolean / numberfalse / 0

    TimelineItem Slots

    参数说明类型默认值
    default节点内容——
    dot自定义圆点(优先于 icon)——
    label自定义对侧标签——