时序图
自 2.2.0 起,dot、link 系列也整体移至 @visactor/vchart-extension,主包不再导出或自动注册 DotSeries、LinkSeries、registerDotSeries、registerLinkSeries,对应的 IDotSeriesSpec、ILinkSeriesSpec 类型也从扩展包导入。registerSequenceChart({ VChart }) 和 registerSequenceAnalysis({ VChart }) 会注册各自需要的系列;在 common 图表中单独使用时,需要从扩展包导入并调用 registerDotSeries()、registerLinkSeries()。
注册与迁移
自 VChart 2.2.0 起,时序图(type: 'sequence')从主包迁移至 @visactor/vchart-extension。先安装与 VChart 版本一致的扩展包,并在创建图表前调用 registerSequenceChart({ VChart })。原有 type: 'sequence' 和 series 配置保持不变。
旧版本兼容: VChart 2.2.0 之前的完整包内置时序图,无需调用扩展包的 registerSequenceChart;按需引入时仍使用对应版本主包的注册方法。下方在线 demo 会先判断扩展注册方法是否存在,以兼容版本切换。使用 2.2.0 及以上版本时,仍需加载与 VChart 版本一致的扩展包,存在性判断不能替代扩展包的安装和加载。
// VChart 2.2.0 及以上版本的业务项目用法(两包版本需一致): import VChart from '@visactor/vchart'; import { registerSequenceChart } from '@visactor/vchart-extension'; import type { ISequenceChartSpec } from '@visactor/vchart-extension'; registerSequenceChart({ VChart }); // const spec: ISequenceChartSpec = { type: 'sequence', ... }; // new VChart(spec, { dom: 'chart' }).renderSync();
ISequenceChartSpec 和 registerSequenceChart 的导入来源由核心包改为扩展包。React/Taro/Openinula 的 SequenceChart 组件已封装注册逻辑;使用通用 VChart 组件时仍需先注册。此图展示时间轴上的事件及统计,与 type: 'sequenceAnalysis' 的时序分析图是两种独立的扩展图表。
简介
在社交媒体、行为监测等场景中,往往需要在线性时间的演进中, 以节点和边的形式展示不同用户不同时间的不同行为, 并且为了更好地从中发现用户的行为偏好, 还需要以柱状图的形式展示行为统计信息。基于线性时间映射的时序图可以展示这种场景下的数据。
图表构成
时序图本质上为特定系列和组件组成的组合图。

时序图是一种用于展示时间序列数据的图表类型,它可以表现出数据在时间上的变化趋势。
在时序图中,我们推荐至少配置一对事件 link 系列,柱系列可根据需要配置 0 个或若干个:
注意:link 系列必须通过'dotSeriesIndex'属性与 dot 系列绑定,因为其绘制数据及部分配置依赖于 dot 系列。
时序图通常还包含以下组件:
- 时间轴: 所有系列共用的 x 轴,也是时序数据与图元属性映射的介质。
- 缩略轴: 在时序数据展示过于密集时,会将缩略轴组件与时间轴绑定以"控制时间的缩放"。
- 滚动条: 当并行的事件序列过多,即 y 方向分类过多时,可以通过配置滚动条以“控制 dot 系列和link 系列的上下滚动”。
快速上手
关键配置
全局配置:
appendPadding属性用于配置图表的内边距, 建议配置, 否则 dot 和 link 系列的 title 将会与 grid 重叠.
时间轴配置:
type属性用于配置轴的类型, 此处推荐配置time用以映射时序数据, 需要注意的是时间轴仅支持时间戳数据layers属性用于配置时间轴子母轴的配置, 当轴为时间轴时方可生效. 第 0 项表示母轴, 即下方的轴; 第 1 项表示子轴, 即上方的轴. 通过timeFormat配置标签的时间格式. 通过 tickStep 配置时间的间隔秒数.
dot 系列配置:
xField属性声明为 dot 系列的横坐标字段yField属性声明为 dot 系列的纵坐标字段title属性声明为 dot 系列的标题字段, 标题位于时间线左侧subTitle属性声明为 dot 系列的副标题字段, 标题位于标题下方dotTypeField属性声明为 dot 系列的事件点分组字段, 在相同的分组中事件点的颜色相同.highLightSeriesGroup属性声明为 dot 系列的高亮分组配置, 当配置seriesGroupField时, 可以指定高亮某个特定属性的分组clipHeight属性声明为 dot 系列的可视高度
link 系列配置: link 系列(link series)的数据依赖于事件(event series)系列
dotSeriesIndex属性声明为关联的 dot 系列的索引fromField属性声明为起点位置字段toField属性声明为终点位置字段dotTypeField属性声明为关系类型字段
时序图特性
数据
上文提到时序图包含柱系列、dot 系列和 link 系列,它们在时序图中展示的数据及其结构各不相同。
柱系列数据
对于柱系列而言需要展示特定时间间隔内的时序数据总数,属于频率统计的一种,所以结构类似于直方图。
- 两个
数值字段,如:start_timeend_time - 一个
数值字段,如:value
数据定义如下:
data: [
{
name: 'bar',
values: [
{
start_time: 0,
end_time: 10,
value: 1
},
{
start_time: 10,
end_time: 20,
value: 5
},
{
start_time: 20,
end_time: 30,
value: 2
}
]
}
];
dot 系列数据
对于 dot 系列而言,既要通过title subTitle grid等图元展示一连串事件构成的序列,又要通过dot图元展示具体的事件,所以是一种嵌套类型的数据。
data: [
{
name: 'bar',
values: [
{
type: 'user_did', // 事件序列类型,映射title图元文本
id: '713019502467512xxxx', // uid / ip / did...,映射subTitle图元文本
dots: [
// 事件序列数组
{
event_time: 1662061124, // 事件发生的时间,映射
node_name: '713019502467512xxxx_1662061124_login_device', // 节点名称(字段名称不可变且保证数据唯一性,如果需要绑定link 系列,则该节点名称要与link系列一一对应
action_type: 'login_device', // 事件类型,映射dot图元颜色
children: [
// 事件的附带info,用于展示在tooltip中
{
action_type: 'login_device'
}
]
}
]
},
{
id: '683827422612367xxxx',
type: 'user_did',
dots: [
{
event_time: 1662321122,
node_name: '683827422612367xxxx_1662321122_login_device',
action_type: 'login_device',
children: [
{
action_type: 'login_device'
}
]
},
{
event_time: 1662301120,
node_name: '683827422612367xxxx_1662301120_registry_device',
action_type: 'registry_device',
children: [
{
action_type: 'registry_device'
}
]
},
{
event_time: 1662503541,
node_name: '683827422612367xxxx_1662503541_registry_device',
action_type: 'registry_device',
children: [
{
action_type: 'registry_device'
}
]
},
{
event_time: 1662311121,
node_name: '683827422612367xxxx_1662311121_login_device',
action_type: 'login_device',
children: [
{
action_type: 'login_device'
}
]
},
{
event_time: 1662161125,
node_name: '683827422612367xxxx_1662161125_login_device',
action_type: 'login_device',
children: [
{
action_type: 'login_device'
}
]
}
]
}
]
}
];
link 系列数据
对于 link 系列而言,需要通过两个字段分别指定 link 的起点和终点。
注意:起点字段和终点字段的数据必须与 dot 系列数据中的node_name数据一一对应,这样 link 图元在绘制时才能找到对应的起点和终点位置。
data: [
{
name: 'link',
values: [
{
from: '683827468797481xxxx_1662346668_im', // 起点字段
to: '683827420033672xxxx_1662346668_im', // 终点字段
action_type: 'im', // 事件关系类型,映射link颜色
children: [
// 事件关系的附带info,用于展示在tooltip中
{
action_type: 'im',
msg_id: 800000
}
]
}
]
}
];
提示 info 配置
上文提到在事件或事件关系会附带一些额外 info,该 info 通常以Object的形式出现,为了将层级结构正确展示在 tooltip 中,dot 和 link 系列内置解析Object的方法,用户只需要在sequenceChart.tooltip.content中进行如下配置即可。
注意:内置的方法仅解析children字段,所以无论是数据,还是此处的 tooltip 配置,都应该保持children 字段不变。
{
hasShape: true,
shapeType: 'square',
key: 'children',
value: (datum: any) => datum['children']
}
下面的例子展示了包含 tooltip 配置的社交媒体时序图: