# 柱状图
柱状图是一种以长方形的长度为变量的表达图形的统计报告图,由一系列高度不等的纵向条纹表示数据分布的情况,用来比较两个或以上的数值(不同时间或者不同条件)。
# 属性
# 基础
基本属性: 同组件管理 -> 属性 -> 基本属性
系列颜色: 柱子的颜色。支持颜色填充,默认情况下柱子的颜色为主题的颜色。
# 系列
柱状图为单维度,多度量的图表,因此需要分别设置每个系列下的柱子属性。
系列 1:
类型: 柱状和折线的转换。
堆叠名: 系列中堆叠名称相同者堆叠在一起。
顺序: 控制图形的层级顺序。值小的图形会被值大的图形覆盖。
Y 轴索引: 绑定 Y 轴的图表显示。
数据标注: 是否显示最大值、最小值的数据标注。
警告:
数据标注只有在柱状图或折线图上可用,堆叠柱状图和折线堆叠图上不可用。
- 平均线: 是否显示同一系列的平均线。
柱设置: 该系列下柱子的颜色、边框设置,支持颜色填充和渐变填充两种方式。
宽度: 柱子宽度,左右滑动或者输入值改变宽度,可为
px
和%
。最小高度: 柱子的最小高度,可用于防止某数据项的值过小而影响交互。
不同类目间距: 不同类目柱间距离,此属性应设置于坐标系中最后一个
bar
系列上才会生效,并且是对此坐标系中所有bar
系列生效。同类目间距: 同类目柱间距离,此属性应设置于坐标系中最后一个
bar
系列上才会生效,并且是对此坐标系中所有bar
系列生效。渐变色: 是否添加渐变色。
是:
渐变色方向: 渐变色的方向,可为
正下到正上
,左下到右上
,右上到左下
。渐变色范围设置: 设置渐变色的颜色范围。
否:
- 颜色: 控制柱的颜色。
描边颜色: 图形描边颜色。
描边线宽: 图形描边宽度。
描边类型: 图形描边类型。
左上圆角: 左上圆角的弧度。
右上圆角: 右上圆角的弧度。
右下圆角: 右下圆角的弧度。
左下圆角: 左下圆角的弧度。
柱背景
显示柱背景: 是否显示柱背景。
渐变色: 柱背景的颜色是否渐变。
是:
渐变色方向: 渐变色的方向,可为
正下到正上
,左下到右上
,右上到左下
。渐变色范围设置: 设置渐变色的颜色范围。
否:
- 颜色: 控制柱背景的颜色。
描边颜色: 柱背景描边的颜色。
描边线宽: 柱背景描边线的宽度。
描边类型: 柱背景描边线的类型,可为
实线
,虚线
,点线
。
文本标签: 指柱状图图形上的文本标签,可用于说明图形的一些数据信息,例如值、名称等。
显示: 是否显示文本。
内容格式器: 标签内容格式器,支持字符串模板和回调函数两种形式,字符串模板与回调函数返回的字符串均支持用
\n
换行。字符串模板变量
{a}
: 系列名。{b}
: 数据名。{c}
: 数据值。例如:
{b}: {c}
回调函数
可用参数为
data
。示例:
return data.name;
参数
data
是 内容格式器需要的单个数据资源。格式如下:{ // 数据名,类目名 "name": string, // 传入的原始数据项 "data": Object, // 传入的数据值 "value": number | Array, // 百分比 "percent": number }
位置: 文本标签上值的位置。
字体颜色: 修改字体的颜色。
字体大小: 修改字体的大小。
字体粗细: 修改字体的粗细,可为
普通
和加粗
和更细
,默认为普通
。字体: 修改字体的样式。
初始动画: 对组件动画的配置。
开启动画: 组件是否启用动画。
动画时长(ms): 动画的时长。
缓动效果: 动画的缓动效果。
数据映射: 同 饼图属性 -> 系列 -> 数据映射 。3.0+
折线设置: 该系列下折线的设置。
平滑曲线: 折线是否为平滑曲线。
线颜色: 折线的颜色。
宽度: 折线的宽度。
类型: 折线的类型。
折线样式: 该系列下折线样式的设置。
渐变色: 是否添加渐变色。
是:
渐变色方向: 渐变色的方向,可为
正下到正上
,左下到右上
,右上到左下
。渐变色范围设置: 设置渐变色的颜色范围。
否:
- 颜色: 控制柱的颜色。
拐点图形: 折线拐点处的图形。
拐点大小: 折线拐点的大小。
拐点描边: 折线拐点的描边颜色。
描边线宽: 折线拐点的描边线宽。
描边类型: 折线拐点的描边类型。
文本标签: 指折线拐点处上的文本标签,可用于说明图形的一些数据信息,例如值、名称等。
显示: 是否显示文本。
内容格式器: 标签内容格式器,支持字符串模板和回调函数两种形式,字符串模板与回调函数返回的字符串均支持用
\n
换行。字符串模板变量
{a}
: 系列名。{b}
: 数据名。{c}
: 数据值。例如:
{b}: {c}
回调函数
可用参数为
data
。示例:
return data.name;
参数
data
是 内容格式器需要的单个数据资源。格式如下:{ // 数据名,类目名 "name": string, // 传入的原始数据项 "data": Object, // 传入的数据值 "value": number | Array, // 百分比 "percent": number }
位置: 文本标签上值的位置。
字体颜色: 修改字体的颜色。
字体大小: 修改字体的大小。
字体粗细: 修改字体的粗细,可为
普通
和加粗
和更细
,默认为普通
。字体: 修改字体的样式。
初始动画: 对组件动画的配置。
开启动画: 组件是否启用动画。
动画时长(ms): 动画的时长。
缓动效果: 动画的缓动效果。
- 系列 2:系列 2 为另一条柱子的系列设置,配置与系列 1相同。
# 视区
# X 轴
# Y 轴
# 标题
# 图例
# 提示框
# 工具栏
# 时间轴
# 数据
# 静态数据
上图中的示例JSON
代码如下:
[
{
"x": "一月",
"y1": 26,
"y2": 60
},
{
"x": "二月",
"y1": 26,
"y2": 49
},
{
"x": "三月",
"y1": 50,
"y2": 70
},
{
"x": "四月",
"y1": 20,
"y2": 60
},
{
"x": "五月",
"y1": 30,
"y2": 40
}
]
x: 维度,各柱的类目。
y1: 度量,系列 1 柱的值。
y1: 度量,系列 2 柱的值。
柱状图中需要单维度、多度量的数据,所以横轴中只解析拖入的第一个字段、纵轴中解析拖入的前两个字段,多余字段在图表中不解析。
# 数据资源
# 交互
# 柱图单击交互事件
勾选启用,开启组件交互功能。当单击柱状图柱子时,绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值,触发数据请求,查询相关数据,更新组件。具体配置请参考组件交互。
# 柱图悬停事件
勾选启用,开启组件交互功能。当悬停柱状图柱子时,绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值,触发数据请求,查询相关数据,更新组件。具体配置请参考组件交互。
# 柱图移出事件
勾选启用,开启组件交互功能。当移出柱状图柱子时,绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值,触发数据请求,查询相关数据,更新组件。具体配置请参考组件交互。
# X 轴标签单击事件
勾选启用,开启组件交互功能。当单击柱状图 X 轴标签时,绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值,触发数据请求,查询相关数据,更新组件。具体配置请参考组件交互。
# Y 轴标签单击事件
勾选启用,开启组件交互功能。当单击柱状图 Y 轴标签时,绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值,触发数据请求,查询相关数据,更新组件。具体配置请参考组件交互。
# 数据响应
柱状图支持数据响应配置。
# 数据上卷,下钻
柱状图支持数据上卷,下钻配置。
# 节点编程
# 事件
柱图点击事件: 柱子单击触发事件。
- 抛出的参数: 柱子所携带的数据。
图表配置转换完成后: 图表 Option 配置转换完成后事件。
- 抛出的参数: 配置完成后的 Option 。
柱图悬停事件: 鼠标悬停到柱图时触发。3.0+
- 抛出的参数: 柱图所携带的数据。
柱图移出事件: 鼠标移出柱图时触发。3.0+
- 抛出的参数: 柱图所携带的数据。
图例切换事件: 图表图例切换时触发。3.0+
- 抛出的参数: 切换的图例名称及选中状态。
时间轴切换事件: 时间轴节点切换时触发。3.0+
- 抛出的参数: 时间轴节点名称。
X 轴/角度轴标签单击事件: X 轴/角度轴标签单击时触发。3.0+
- 抛出的参数: 标签值。
Y 轴/径向轴标签单击事件: Y 轴/径向轴标签单击时触发。3.0+
- 抛出的参数: 标签值。
伸缩域改变事件: 伸缩区域改变时触发。3.0+
- 抛出的参数: 开始/结束位置的百分比值。
# 动作
导入图表配置: 可导入 Echarts 图表 Option 配置。
- 接收的参数: 修改后的 Option 。
设置图例: 设置图例的选中状态。3.0+
{ "类型一": true, "类型二": false, "类型三": false }
设置时间轴: 设置活动的时间轴节点。 3.0+
- 接受参数: 时间轴节点名称。例如:
{ "value": "2021" }