LineGraph
基础趋势图表组件。趋势图用于显示数据在一个连续的时间间隔或者时间跨度上的变化,它的特点是反映事物随时间或有序类别而变化的趋势。
使用场景
- 适用于分析数据随时间的变化趋势、多组数据随时间变化的相互作用和相互影响。
API
Attributes
趋势图组件属性。
参数 | 说明 | 类型 | 必选 | 可选值 | 默认值 |
---|---|---|---|---|---|
data | 图表数据。如果只显示一条默认折线图,直接传入数据( number[] )即可。如果要显示多条曲线,或要自定义曲线配置时,请传入 LineData[] | number[] | LineData[] | 是 | - | - |
LineOption | 趋势图曲线配置,需结合data.name一同使用,传入数据类型为 LineOption[] | LineOption[] | 否 | - | - |
cateAxis | 类目轴配置。默认类目轴是 x 轴,当只有一条类目轴的时候,传入数据 Array。当类目轴有多条的时候,可以传入CateAxisOptions | string[] | CateAxisOptions[] | 是 | - | - |
valueAxis | 数值轴配置。默认数值轴是 y 轴,默认可以不传参数。如果数值轴有多条,或者需要覆盖默认配置时,可以为对象类型的 series 配置数组 | ValueAxisOptions[] | 否 | - | - |
isRotateAixs | 是否旋转坐标轴,即 x 轴 y 轴互换(x 变数值轴,y 轴变类目轴) | boolean | 否 | true,false | false |
valueSplitLine | 是否显示数值刻度分割线 | boolean | 否 | - | true |
valueAxisLine | 是否显示数值轴坐标轴线 | boolean | 否 | - | true |
valueAxisTick | 是否显示数值轴坐标刻度 | boolean | 否 | - | true |
valueAxisLabel | 是否显示数值轴坐标刻度标签 | boolean | 否 | - | true |
isPercent | 数据是否是百分数 | boolean | 否 | - | true |
tooltipFormatter | tooltip 格式化器 | function | 否 | - | - |
legendOrder | legend 排序(根据最后一组数据排序) | string | 否 | none | desc | asc | none |
LineData
趋势图 data 的格式。
参数 | 说明 | 类型 | 必选 | 可选值 | 默认值 |
---|---|---|---|---|---|
data | 数据 | (number | string)[] | 是 | - |
name | 数据对应的名字,数据和配置一一对应使用的参数 | string | 否 | - | - |
LineOption
趋势图曲线配置。
参数 | 说明 | 类型 | 必选 | 可选值 | 默认值 |
---|---|---|---|---|---|
name | 该组数据名称,用于 tooltip 的显示,legend 的图例筛选,在 setOption 更新数据和配置项时用于指定对应的系列,也是数据和配置一一对应使用的参数 | string | 是 | - | - |
type | 图表类型 | string | 是 | line/area | line |
coordinateSystem | 该系列使用的坐标系 | string | 否 | cartesian2d/polar | cartesian2d |
xAxisIndex | 使用的 x 轴的 index,在单个图表实例中存在多个 x 轴的时候有用 | number | 否 | - | 0 |
yAxisIndex | 使用的 y 轴的 index,在单个图表实例中存在多个 y 轴的时候有用 | number | 否 | - | 0 |
symbol | 标记的图形 | string | 否 | circle/rect/roundRect/triangle/diamond/pin/arrow/none | emptyCircle |
symbolSize | 标记的大小 | number/((value: number[], params?: object) => number) | 否 | - | 4 |
symbolRotate | 标记的旋转角度(而非弧度)。正值表示逆时针旋转 | number | 否 | - | - |
stack | 数据堆叠,同个类目轴上系列配置相同的 stack 值后,后一个系列的值会在前一个系列的值上相加 | string | 否 | - | - |
connectNulls | 是否连接空数据 | boolean | 否 | true/false | false |
clip | 是否裁剪超出坐标系部分的图形 | boolean | 否 | true,false | true |
label | 图形上的文本标签,具体参考label | object | 否 | - | - |
endLabel | 折线端点的标签,具体参考endLabel | object | 否 | - | - |
itemStyle | 折线拐点标志的样式,具体参考itemStyle | object | 否 | - | - |
lineStyle | 线条样式,具体参考lineStyle | object | 否 | - | - |
areaStyle | 区域填充样式,具体参考areaStyle | object | 否 | - | - |
emphasis | 折线图的高亮状态,具体参考emphasis | object | 否 | - | - |
blur | 折线图的淡出状态。开启 emphasis.focus 后有效,具体参考blur | object | 否 | - | - |
select | 折线图的选中状态。开启 selectedMode 后有效,具体参考select | object | 否 | - | - |
selectedMode | 选中模式的配置,表示是否支持多个选中,默认关闭 | string | boolean | 否 | 'single' | 'multiple' | true | false | false |
smooth | 是否平滑曲线显示 | boolean | 否 | true/false | false |
sampling | 折线图在数据量远大于像素点时候的降采样策略,开启后可以有效的优化图表的绘制效率,默认关闭,也就是全部绘制不过滤数据点。 | string | 否 | lttb/average/max/min/sum | - |
dimensions | 使用 dimensions 定义 series.data 或者 dataset.source 的每个维度的信息 | array | 否 | - | - |
silent | 图形是否不响应和触发鼠标事件,即响应和触发鼠标事件 | boolean | 否 | true/false | false |
animation | 是否开启动画 | boolean | 否 | true,false | true |
markPoint | 图表标注,具体参考markPoint | object | 否 | - | - |
markLine | 图表标线,具体参考markLine | object | 否 | - | - |
markArea | 图表标域,具体参考markArea | object | 否 | - | - |
CateAxisOptions
类目轴配置,默认类目轴可以只传类目数据,例如[123, 234,...]。当类目轴有多条,或者需要覆盖默认配置时,可以按以下对象配置 options。
参数 | 说明 | 类型 | 必选 | 可选值 | 默认值 |
---|---|---|---|---|---|
data | 类目轴数据配置 | string[] | {value:string, textStyle:object}[] | 是 | - | - |
show | 是否显示坐标轴,默认 true | boolean | 否 | true,false | true |
type | 坐标轴类型,分类目轴和数值轴 | string | 否 | 'value' | 'category' | true |
name | 坐标轴名称,设置则会显示在轴末端 | string | 否 | - | - |
offset | 相对于默认位置的偏移,相同的位置上有多个轴时有效 | number | 否 | - | - |
nameGap | 坐标轴名称与轴线之间的距离 | number | 否 | - | - |
nameRotate | 坐标轴名字旋转,角度值 | number | 否 | - | - |
inverse | 是否反向坐标轴 | number | 否 | - | - |
nameLocation | 坐标名称显示位置,默认 end | string | 否 | 'end' | 'start' | 'center' | 'middle' | end |
axisLine | 坐标轴轴线相关设置, 具体请参考axisLine | object | 否 | - | - |
axisTick | 坐标刻度相关配置, 具体请参考axisTick | object | 否 | - | - |
axisLabel | 坐标刻度标签配置, 具体请参考axisLabel | object | 否 | - | - |
splitLine | 坐标刻度分隔线, 具体请参考splitLine | object | 否 | - | - |
axisPointer | 坐标轴指示器, 具体请参考axisPointer | object | 否 | - | - |
ValueAxisOptions
数值轴配置,1、默认数值轴是 y 轴,默认可以不传参数;2、如果数值轴有多条,或者需要覆盖默认配置时,可以为对象类型的 series 配置数组
参数 | 说明 | 类型 | 必选 | 可选值 | 默认值 |
---|---|---|---|---|---|
position | 数值轴位置,默认第一个为 left,第二个为 right | string | 否 | left,right | - |
show | 是否显示坐标轴,默认 true | boolean | 否 | true,false | true |
type | 坐标轴类型,分类目轴和数值轴 | string | 否 | 'value' | 'category' | true |
name | 坐标轴名称,设置则会显示在轴末端 | string | 否 | - | - |
offset | 相对于默认位置的偏移,相同的位置上有多个轴时有效 | number | 否 | - | - |
nameGap | 坐标轴名称与轴线之间的距离 | number | 否 | - | - |
nameRotate | 坐标轴名字旋转,角度值 | number | 否 | - | - |
inverse | 是否反向坐标轴 | number | 否 | - | - |
nameLocation | 坐标名称显示位置,默认 end | string | 否 | 'end' | 'start' | 'center' | 'middle' | end |
axisLine | 坐标轴轴线相关设置, 具体请参考axisLine | object | 否 | - | - |
axisTick | 坐标刻度相关配置, 具体请参考axisTick | object | 否 | - | - |
axisLabel | 坐标刻度标签配置, 具体请参考axisLabel | object | 否 | - | - |
splitLine | 坐标刻度分隔线, 具体请参考splitLine | object | 否 | - | - |
axisPointer | 坐标轴指示器, 具体请参考axisPointer | object | 否 | - | - |