盈帆报表柱状图插件说明

柱形图，又称长条图、柱状统计图、亦称条图、条状图、棒形图，是一种以长方形的长度为变量的统计图表。长条图用来比较两个或以上的价值，只有一个变量，通常利用于较小的数据集分析。长条图亦可横向排列，或用多维方式表达。（摘自百度百科--“柱形图”条目）

盈帆报表软件插件中包含柱状图、条形图等图表插件，在单元格或者悬浮元素中可以选择菜单栏中的“插入”-“插入插件”，选择“01基础图表”中的“柱状图”，确定后即可生成一个柱状图。

双击柱状图所在的位置，弹出Table页，Table页中包括“属性”、“JSON”、“扩展属性”。在柱状图属性面板中可以设置柱状图的“标题”、“图例”、“网格”、“数据”等属性。JSON面板中可以查看到当前柱状图实际的属性数据。扩展属性面板对于柱状图没有显示的属性可以进行扩展。

属性面板：

“标题”属性中包括：控件主题、控件类型、控件背景颜色、显示标题、标题文本、背景颜色、上边距、下边距、左边距、右边距、文本样式：颜色、字体风格、字体粗细、字体名称、字体大小。

“控件主题”：当前控件的整体样式设置，包括柱状图的颜色、坐标轴的颜色、图例的样式等一系列主题风格。需要注意的是设置主题时，之前如有其他的属性设置，会重新刷新之前的属性，一般建议先设置好主题之后，再设置其他属性。

当前的控件主题不满足实际需求时，可在echarts中，自定义主题：https://echarts.apache.org/zh/theme-builder.html，自定义的主题下载后，放置服务器\webapps\efreport\pluginResource\theme目录下，前端使用时，强制刷新页面即可使用新的主题。需要注意的是，自定义的主题名称与现有的不能重复，现有的主题名称可以在服务器\webapps\efreport\pluginResource\theme目录下查看。

“控件类型”：当前柱状图显示的类型，是普通的柱状图还是堆叠柱状图。

“控件背景颜色”：当前控件的背景颜色。使用RGBA格式，可以设置透明，颜色最后两位设置为0时，即是透明，例如：“#ffffff00”。

“显示标题”：是否显示控件的标题。

“标题文本”：当前控件的标题文本。

“背景颜色”：当前标题文本的背景颜色。可设置透明。

“上边距”：当前标题距离上边框的位置。可以设置整数，百分比，或者“auto”、“top”、“middle”、“bottom”。

“下边距”：当前标题距离下边框的位置。可以设置整数，百分比，或者“auto”、“top”、“middle”、“bottom”。

“左边距”：当前标题距离左边框的位置。可以设置整数，百分比，或者“auto”、“left”、“center”、“right”。

“右边距”：当前标题距离左边框的位置。可以设置整数，百分比，或者“auto”、“left”、“center”、“right”。

需要注意的是，上边距与下边距是互斥的，左右边距是互斥的，一般情况下设置其中一个即可。

文本样式：

“颜色”：当前标题文本的颜色。

“字体风格”：当前标题文本的字体风格。

“字体粗细”：当前标题文本是否加粗。

“字体名称”：当前标题文本的字体名称。

“字体大小”：当前标题文本的字体大小。

“图例”属性中包括：图例类型、列表布局、文本对齐、显示图例、背景颜色、上边距、下边距、左边距、右边距、文本样式：颜色、字体风格、字体粗细、字体名称、字体大小。

“图例类型”：当前图例是否是滚动翻页模式显示。

“列表布局”：当前图例是水平布局还是垂直布局。

“文本对齐”：当前图例文本是左对齐还是右对齐。

“显示图例”：当前图例是否显示。

“背景颜色”：当前图例文本的背景颜色。可设置透明。

“上边距”：当前图例距离上边框的位置。可以设置整数，百分比，或者“auto”、“top”、“middle”、“bottom”。

“下边距”：当前图例距离下边框的位置。可以设置整数，百分比，或者“auto”、“top”、“middle”、“bottom”。

“左边距”：当前图例距离左边框的位置。可以设置整数，百分比，或者“auto”、“left”、“center”、“right”。

“右边距”：当前图例距离左边框的位置。可以设置整数，百分比，或者“auto”、“left”、“center”、“right”。

需要注意的是，上边距与下边距是互斥的，左右边距是互斥的，一般情况下设置其中一个即可。

文本样式：

“颜色”：当前图例文本的颜色。

“字体风格”：当前图例文本的字体风格。

“字体粗细”：当前图例文本是否加粗。

“字体名称”：当前图例文本的字体名称。

“字体大小”：当前图例文本的字体大小。

“网格”属性中包括：显示网格、背景颜色、上边距、下边距、左边距、右边距。

“显示网格”：当前网格是否显示。

“背景颜色”：当前网格的背景颜色，网格不显示时设置背景颜色无效。可设置透明。

“上边距”：当前图表网格距离上边框的位置。可以设置整数，百分比，或者“auto”、“top”、“middle”、“bottom”。

“下边距”：当前图表网格距离下边框的位置。可以设置整数，百分比，或者“auto”、“top”、“middle”、“bottom”。

“左边距”：当前图表网格距离左边框的位置。可以设置整数，百分比，或者“auto”、“left”、“center”、“right”。

“右边距”：当前图表网格距离左边框的位置。可以设置整数，百分比，或者“auto”、“left”、“center”、“right”。

“数据”属性中包括：数据来源：数据来源、数据集，分类：数据（数据列）、是否显示X轴、X轴颜色、X轴位置、X轴单位、旋转角度、字体大小、是否显示分隔线，系列（数据列）：数据、是否显示标签、标签格式、标签文本颜色、标签字体大小、是否显示提示框、柱状宽度，值：数据（数据列）、是否显示Y轴、Y轴颜色、Y轴位置、Y轴单位、旋转角度、字体大小、是否显示分隔线。

数据来源：

“数据来源”：当前柱状图的数据来源是数据集还是单元格数据。

“数据集”：数据来源设置为“数据集数据”时，当前属性显示，可以设置数据集是哪个数据集。

分类：

“数据（数据列）”：分类数据的数据来源，数据来源设置为“数据集数据”时，显示“数据列”属性，可以设置分类的数据列。通俗来说每一个分类就是X轴上显示的文本标签。

“是否显示X轴”：当前柱状图是否显示X轴。

“X轴颜色”：当前柱状图X轴的颜色，不显示X轴时，此属性无效。

“X轴位置”：当前柱状图X轴的位置是在下方显示还是在上方显示，不显示X轴时，此属性无效。

“X轴单位”：当前柱状图X轴的单位，不显示X轴时，此属性无效。

“旋转角度”：当前柱状图X轴刻度的旋转角度。

“字体大小”：当前柱状图X轴刻度的文本大小。

“是否显示分隔线”：当前柱状图X轴刻度的分隔线是否显示。

系列：

“数据（数据列）”：系列数据的数据来源，数据来源设置为“数据集数据”时，显示“数据列”属性，可以设置系列的数据列。通俗来说每一个系列就是要显示的柱子。

“是否显示标签”：当前柱状图上是否显示文本标签。

“标签格式”：当前柱状图上文本标签的文本格式，按照规则可自定义，不显示标签时，此属性无效。{a}：系列名。{b}：数据名。{c}：数据值。{d}：百分比。示例： {b} : {c} ({d}%)。

“标签文本颜色”：当前柱状图上文本标签的文本颜色，不显示标签时，此属性无效。

“标签字体大小”：当前柱状图上文本标签的文本大小，不显示标签时，此属性无效。

“是否显示提示框”：鼠标移动到柱状图上时，是否显示提示框。

“柱状宽度”：设置柱状图显示的柱子宽度。

值：

“数据（数据列）”：值数据的数据来源，数据来源设置为“数据集数据”时，显示“数据列”属性，可以设置值的数据列。通俗来说每一个值就是显示的每一个柱子的实际值。

“是否显示Y轴”：当前柱状图是否显示Y轴。

“Y轴颜色”：当前柱状图Y轴的颜色，不显示Y轴时，此属性无效。

“Y轴位置”：当前柱状图Y轴的位置是在左侧显示还是在右侧显示，不显示Y轴时，此属性无效。

“Y轴单位”：当前柱状图Y轴的单位，不显示Y轴时，此属性无效。

“旋转角度”：当前柱状图Y轴刻度的旋转角度。

“字体大小”：当前柱状图Y轴刻度的文本大小。

“是否显示分隔线”：当前柱状图Y轴刻度的分隔线是否显示。

JSON面板

JSON面板主要查看当前设置的属性的JSON格式。

扩展属性面板

在提供的属性页面中，如果有一些比较个性的属性没有展现出来，可以在扩展属性面板中添加echarts提供的图表属性来进行扩展。扩展属性的格式与echarts提供的配置项属性格式一致：https://echarts.apache.org/zh/option.html#title。以下截图是使用扩展属性将柱状图设置成渐变效果（在“建筑产值”报表模板中，B9单元格的柱状图属性）：