# 正负交错柱状图

正负交错柱状图是一种以长方形的长度为变量的表达图形的统计报告图，由一系列高度不等的横向条纹表示数据分布的情况，用来比较两个或以上的数值（如跟平均值作对比）。

# 属性

# 基础

基本属性： 同组件管理 -> 属性 -> 基本属性
系列颜色： 柱子的颜色。支持颜色填充，默认情况下柱子的颜色为主题的颜色。

# 系列

正负交错柱状图为单维度，多度量的图表，因此需要分别设置每个系列下的柱子属性。

系列 1：
类型： 柱状和折线的转换。
堆叠名： 系列中堆叠名称相同者堆叠在一起。
顺序： 控制图形的层级顺序。值小的图形会被值大的图形覆盖。
数据标注： 是否显示最大值、最小值的数据标注。

警告：

数据标注只有在柱状图或折线图上可用，堆叠柱状图和折线堆叠图上不可用。

平均线： 是否显示同一系列的平均线。
柱设置： 该系列下柱子的颜色、边框设置，支持颜色填充和渐变填充两种方式。
- 宽度： 柱子宽度，左右滑动或者输入值改变宽度，可为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)： 动画的时长。
- 缓动效果： 动画的缓动效果。
数据映射： 同饼图属性 -> 系列 -> 数据映射。3.0+

# 数据

# 静态数据

系列颜色

上图中的示例JSON代码如下：

[
  {
    "x": "ten",
    "y": -7
  },
  {
    "x": "nine",
    "y": 9
  },
  {
    "x": "eight",
    "y": -20
  },
  {
    "x": "seven",
    "y": 12
  },
  {
    "x": "six",
    "y": -23
  },
  {
    "x": "five",
    "y": 8
  },
  {
    "x": "four",
    "y": -17
  },
  {
    "x": "three",
    "y": 36
  },
  {
    "x": "two",
    "y": -36
  },
  {
    "x": "one",
    "y": 18
  }
]

x：维度，各柱的类目。
y：度量，柱的值。

正负交错柱状图中需要单维度、多度量的数据，所以横轴中只解析拖入的第一个字段、纵轴中解析拖入的前两个字段，多余字段在图表中不解析。

# 数据资源

系列颜色

# 交互

# 交互事件

勾选启用，开启组件交互功能。当单击正负交错柱状图柱子时，绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值，触发数据请求，查询相关数据，更新组件。具体配置请参考组件交互。

# 柱图悬停事件

勾选启用，开启组件交互功能。当悬停正负交错柱状图柱子时，绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值，触发数据请求，查询相关数据，更新组件。具体配置请参考组件交互。

# 柱图移出事件

勾选启用，开启组件交互功能。当移出正负交错柱状图柱子时，绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值，触发数据请求，查询相关数据，更新组件。具体配置请参考组件交互。

# X 轴标签单击事件

勾选启用，开启组件交互功能。当单击正负交错柱状图 X 轴标签时，绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值，触发数据请求，查询相关数据，更新组件。具体配置请参考组件交互。

# Y 轴标签单击事件

勾选启用，开启组件交互功能。当单击正负交错柱状图 Y 轴标签时，绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值，触发数据请求，查询相关数据，更新组件。具体配置请参考组件交互。

# 数据响应

正负交错柱状图支持数据响应配置。

# 数据上卷，下钻

正负交错柱状图支持数据上卷，下钻配置。

# 节点编程

详见柱图节点编程

← 环形柱状图折线柱状图 →

# 正负交错柱状图

# 属性

# 基础

# 系列

# 视区

# X 轴

# Y 轴

# 标题

# 图例

# 提示框

# 工具栏

# 时间轴