# 柱状图
柱状图是一种以长方形的长度为变量的表达图形的统计报告图，由一系列高度不等的纵向条纹表示数据分布的情况，用来比较两个或以上的数值（不同时间或者不同条件）。
# 属性
# 基础
基本属性： 同组件管理 -> 属性 -> 基本属性
系列颜色： 柱子的颜色。支持颜色填充，默认情况下柱子的颜色为主题的颜色。
# 系列
柱状图为单维度，多度量的图表，因此需要分别设置每个系列下的柱子属性。
系列 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 }位置： 文本标签上值的位置。
字体颜色： 修改字体的颜色。
字体大小： 修改字体的大小。
字体粗细： 修改字体的粗细，可为
普通和加粗和更细，默认为普通。字体： 修改字体的样式。
图表标线： 见 组件管理 -> 属性 -> 图表标线。4.2+
标签布局： 见 组件管理 -> 属性 -> 标签布局。4.3+
初始动画： 对组件动画的配置。
开启动画： 组件是否启用动画。
动画时长(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" }