Skip to content
专业版

FaTimeline 时间轴

垂直时间轴组件,支持时间分组显示和滚动激活效果。

使用场景

  • 订单状态跟踪
  • 项目进度展示
  • 审批流程记录
  • 用户操作日志
  • 版本更新历史
  • 活动时间线

Props

属性类型默认值说明
dataT[][]时间轴数据数组
mergebooleanfalse是否合并相同日期的时间标签
classHTMLAttributes['class']-自定义 CSS 类

泛型约束

ts
T extends { datetime: string | number | Date }

Slots

名称说明作用域参数
default时间轴内容模板item: T - 当前时间项数据

注意事项

  1. 数据格式data 数组中的每一项必须包含 datetime 字段(支持 Date、string、number 类型)
  2. 时间格式:推荐使用 ISO 格式字符串或 Date 对象,确保正确解析
  3. 合并模式merge 为 true 时,相同日期的时间项只显示一个时间标签
  4. 滚动效果:组件会根据滚动位置自动激活对应时间点的年份/月份/日期显示
  5. 内容自定义:通过默认插槽可以完全自定义每个时间项的展示内容
  6. 高度设置:建议设置固定高度或放在可滚动容器中使用