双向柱状图
文档基于双向柱状图v1.7.0版本
组件说明
双向柱状图是柱状图的一种，实现双向展示正负柱状样式，支持多系列数据配置以及双向式的数据展示。
效果案例
*双向柱状图 效果案例
一、样式
在样式中可以设置组件的基本属性、全局样式、提示框、图例、动画、X轴、Y轴、参考线、数据系列。
1、基本属性
位置尺寸
位置包括组件的横坐标和纵坐标，单位为px；横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。
尺寸包括组件的宽度和高度，单位为px；可单击比例锁锁定组件宽高比，等比例调整组件的宽高，比例锁默认不锁定。
*尺寸调整不影响组件内容显示、组件动画。
*组件位置尺寸说明
默认隐藏
勾选之后在初始加载时组件默认隐藏且关闭回调触发，通常用来配合显隐控制，如【选项卡】组件进行显隐切换。
2、全局样式
在全局样式中支持配置组件布局、轮播、柱子样式、边距等样式。
布局
支持选择柱状类型：堆叠/平铺
*布局类型（左 - 堆叠 右 - 平铺）
轮播方式
支持选择轮播方式：提示框轮播/图表轮播
*轮播方式（左 - 提示框轮播 右 - 图表轮播）
注意：启用轮播动画须同时开启【动画】，其中【提示框轮播】与【图表轮播】相冲突，二者仅可选其一。
柱子样式
配置项 | 说明 |
系列间距 | 柱子间不同系列的间距，取值范围0-1，柱子粗细根据柱间间距自适应 |
柱间间距 | 每组柱子间的间距，取值范围0-1，柱子粗细根据柱间间距自适应 |
柱外间距 | 柱子与图表两侧的间距，取值范围0-1，柱子粗细根据柱外间距自适应 |
柱子背景 | 柱子的背景颜色、透明度 |
*柱间距说明
边距
基本柱状图表距离整个组件四边（上、下、左、右）的边距
*边距样式说明
3、提示框
配置项 | 说明 |
索引位置 | 提示框默认位置索引，起始值为0 |
偏移 | 提示框在x/y方向上的偏移量 |
边距 | 提示框内边与其内容的间距（上、下、左、右） |
布局 | 提示框内整体及个体系列的分布位置和对齐方式 |
指示牌 | 提示牌宽高，且支持自定义上传背景图片 |
标签样式 | 标签字体样式及间距 |
标签阴影 | 标签字体阴影样式 |
值样式 | 数值字体样式 |
值阴影 | 数值字体阴影样式 |
色块 | 图例色块的大小 |
*提示框 样式演示
4、图例
配置项 | 说明 |
文本样式 | 图例的文本字号、颜色 |
间距 | 图文的间距 |
布局 | 图例的布局方式，支持修改对齐、间距、排布 |
5、动画
间隔时长
支持设置轮播动画间隔时长，仅在开启轮播时起效
6、X轴
支持自定义配置柱状图的x轴显隐、样式编辑
配置项 | 说明 |
轴标签 | X轴的轴标签，可调整格式、文本样式、展示方式和偏移量 |
轴单位 | X轴的轴单位，可调整单位内容、文本样式、偏移 |
轴线 | X轴的轴线颜色和粗细 |
刻度线 | X轴的刻度线的颜色、粗细、长度 |
网格线 | X轴的网格线样式 |
7、Y轴
支持自定义配置柱状图的y轴显隐、样式编辑
配置项 | 说明 |
轴标签 | y轴正反向极轴，支持自定义输入，也支持系统选择，置空时系统根据数据中的最大、最小值和指标点的个数自动计算； 标签刻度数 |
轴单位 | Y轴轴标签的单位，可调整单位内容、偏移量和文字样式 |
轴线 | Y轴的轴线，支持修改颜色和粗细 |
刻度线 | Y轴的刻度线，可调整刻度线的颜色、粗细、长度 |
网格线 | Y轴的网格线样式 |
8、参考线
支持自定义配置参考线显隐、样式编辑
配置项 | 说明 |
参考值 | 【最大值】即默认数据最大值；【自定义】可自定义设置参考值 |
参考线 | 线颜色及样式：实线/虚线 |
文本 | 辅助文字内容及样式编辑 |
*参考线（左 - 关闭 右 - 开启）
9、数据系列
数据有类型区分展示需求时，可以将数据划分成不同系列
配置项 | 说明 |
映射 | 映射的【系列值】对应数据中的系列字段，【显示名】是编辑页面中字段的变量名 |
颜色 | 支持独立配置柱体的【正值颜色】和【负值颜色】 |
数值标签 | 默认未开启，开启下改变文本样式、符号位及标签偏移 |
*数值标签（左 - 关闭 右 - 开启）
二、数据
组件数据格式
字段 | 说明 |
x | 类目，即x轴文本 |
y | 值，即y轴数值 |
s | 系列 |
*组件数据格式说明
JSON数据案例
[
{
"x": "2010/01/01 00:00:00",
"y": 75,
"s": "系列一"
},
{
"x": "2010/01/01 00:00:00",
"y": 180,
"s": "系列二"
},
{
"x": "2010/02/01 00:00:00",
"y": 200,
"s": "系列一"
},
{
"x": "2010/02/01 00:00:00",
"y": 100,
"s": "系列二"
},
{
"x": "2010/03/01 00:00:00",
"y": -40,
"s": "系列一"
},
{
"x": "2010/03/01 00:00:00",
"y": 125,
"s": "系列二"
},
{
"x": "2010/04/01 00:00:00",
"y": 190,
"s": "系列一"
},
{
"x": "2010/04/01 00:00:00",
"y": 110,
"s": "系列二"
},
{
"x": "2010/05/01 00:00:00",
"y": 90,
"s": "系列一"
},
{
"x": "2010/05/01 00:00:00",
"y": -60,
"s": "系列二"
}
]数据配置项说明
配置项 | 说明 |
数据源 | 数据源类型、数据源选择等 |
数据过滤器 | 勾选启用数据过滤器，单击添加过滤器，可在设置数据源页面中配置数据过滤器，详情请参见数据过滤器使用说明 |
数据响应结果 | 展示数据请求的响应结果 |
自动更新 | 选中后可以设置数据请求时间间隔 |
数据对接详情
数据对接详情请见以下文档👇
三、交互
当前组件通过载入动画、回调参数、自定义事件三种方式设置组件交互。
载入动画
所有组件均提供移入、移入(小)、划变三种组件载入动画。
载入动画选择无时，则组件没有载入动画。
载入动画仅在可视化应用预览、发布组件加载时显示。
配置项 | 说明 |
渐隐渐显 | 启用是 |
速率 | 匀速、慢快慢(cubic-bezier(0.25,0.1,0.25,1))、低速开始、低速结束、低速开始和结束(cubic-bezier(0.42,0,0.58,1)) |
方向 | 动画方向 |
持续时间 | 载入动画持续时间，单位为ms |
延时 | 载入动画延时长，单位为ms |
自定义事件
自定义事件为「交互事件」的增强模块，支持通过数据驱动组件状态、或变更组件样式配置，也可自定义编辑复杂的条件逻辑；
详细的自定义事件教学👉自定义事件教学
欢迎您在评论区留下您对该组件的意见，管理员会及时回复您，如长时间未回复欢迎您搜索钉钉群：33782396或者扫描以下二维码添加微信群 说出您的想法，采纳后将送出定制礼品。
也可以通过问卷来向我们反馈需求：https://jinshuju.net/f/XyCXU0