分组条形图

在组件库中，我们给大家提供了丰富的组件，且为了降低大家在项目制作过程中的设计复杂度，对这些组件预设了一些样式，但我们仍可以在此基础上对其样式进行修改。

T 型分组条形图、渐变分组条形图都是分组条形图的预设样式，预设的样式主要包括组件自有数据、组件图形的形状、颜色和数量，但是本质上这三种组件都是分组条形图。

下面我们以T 型分组条形图为例，给大家介绍一下该组件的使用步骤：

1. 添加组件

如果您不太熟悉组件，可以通过组件窗口找到该组件后添加：

如果您比较熟悉组件，可以通过搜索来添加组件，这个方式会更便捷一些。
点击搜索按钮或按键盘Ctrl+F打开搜索框，输入组件名称进行搜索，然后点击对应的组件进行添加。

2. 绑定数据

第一步：确认数据源格式

不同的组件适合于不同格式的数据，如果数据源格式不符合组件的要求，就无法正常显示内容。

（1） 数据类型 1

这种数据类型适用于条形数量固定不变的情况。
这种数据类型是一个 X 轴字段和一个 Y 轴字段，一个 Y 轴字段对应一个条形。
其中 X 轴字段是字符串类型，Y 轴字段是数字类型。

（2） 数据类型 2

这种数据类型适用于 Y 轴字段数量不固定的情况。
这种数据类型是一个 X 轴字段和多个 Y 轴字段，其中 X 轴字段对应 X 轴坐标分类，Y 轴字段数量对应条形堆叠数量，可以通过修改 Y 轴字段进行堆叠条形数量的调整（例如在下面的数据中对 Y 轴字段数量进行调整）。
其中 X 轴字段字符串类型，Y 轴多个字段是数字类型。

第二步：设置数据字段

（1）使用组件自有数据

每个组件都自带一个示例数据源。
单击选中组件，在右侧“数据”设置窗口中，可以看到组件已经设置好了数据字段，且数据字段来自于“组件自有数据”。

【温馨提示】如果您需要在本地数据源准备好之前制作项目，如制作一个原型图或 Demo，此时您可以直接使用组件自有数据。组件自有数据符合上述的组件数据源格式要求，但是不一定符合您的项目需求，所以您需要先对其进行修改才能使用。

在“数据”设置界面下方可以直接修改数据，组件中的数据也会实时更新。

鼠标右键点击数据表头可以修改字段名称、修改数据类型和删除字段。

字段类型包括：字符串、数字和数组（X 轴字段和系列字段都是字符串类型，Y 轴是数字类型，数组类型用于词云组件），只有在字段类型正确的情况下，组件内容才能正常显示。

（2）使用本地数据

第一步：添加数据源

如果您已经准备好了本地数据源，就不需要使用组件自有数据源了。
在“数据”的下拉菜单中点击“添加数据”，将本地数据源添加进来。

在“连接数据”的窗口中，选择对应的数据源类型。

下面以添加Excel 数据源为例：（更多数据源添加方式请参看教程：连接数据）

点击“确定”即添加完成，然后就可以在“连接数据”的窗口中查看详细的数据。

第二步：设置数据字段

点击选中组件，在右侧“数据”设置窗口中切换到“看板公共数据”（同一个项目中所有数据源是共享的）。

在修改数据字段前，需要先删除当前字段，点击字段右侧的“X”可以删除字段。

删除当前字段后，右侧字段栏为空，同时组件会提示“未设置数据”。

把本地数据字段拖拽添加到组件对应的字段中。

（3）设置系列字段

针对上述数据类型 2，下面我们演示一下“系列字段”是如何使用的
数据内容如下，将“城市”设为 X 轴字段，“专业”设为系列字段，“平均收入”设为 Y 轴字段：

生成的条形图如下，可以看到此时有两个条形，分别代表“计算机”专业和“机械”专业。

接下来我们添加一个新的专业“电子”，数据修改如下：

此时条形图如下：

3. 设置组件样式

点击选中组件，在右侧“样式”设置窗口中可以看到多个不同的设置分类，每一个分类里都有不同的设置项，这些分类和设置项根据不同的组件会有不同的内容。

3.1. 固定样式设置

所谓固定样式，就是设置完之后一直保持的组件样式，这是和 3.2 章节中的条件样式相对应的，条件样式就是根据数据的变化改变组件的样式。

下面我们按照每一个设置项给大家介绍一下具体的设置。

3.1.1 基本设置

分组条形图 透明度变化，如下图所示：

3.1.2 颜色

（1）默认颜色

指示组件的图形填充颜色。点击“+”和“删除”按钮可以添加、删除颜色配置内容。

数据字段
在默认颜色设置中，有时可能会看见多个配置项，它们显示的区别在于是否有对应的数据字段。
数据字段后显示内容代表当前正在使用的配置项，数据字段后显示“无”的则是备用的配置项。

【温馨提示】备用配置项有两种情况：一种是我们预设的一些配置项，一种则是当前组件之前使用过的历史配置项，在进行字段删减调整时，这些历史配置被保留下来了。

在“数据”设置中添加字段的过程中，默认会在“样式”设置中创建一个新的颜色配置项，如果已有备用配置项，那么这些字段会按照顺序使用这些配置项。

在“字段设置”中，Y 轴字段的顺序是从上到下排序。

第一个字段使用配置 1，第二个字段使用配置 2，以此类推。

我们可以通过鼠标拖动的方式来改变数据字段的排列顺序。

当修改 Y 轴字段的排序后，值 2 字段排在第一位，会使用配置 1，值 1 字段排在第二位，会使用配置 2。

我们也可以在不修改数据字段排序的情况下，通过拖动配置项的顺序来修改配置，例如将配置 2 拖动到配置 1，这样之前配置 2 就变成了配置 1，排序第一位的数据字段（值 1）就会使用这个配置项。

【温馨提示】如果我们想要使用某个备用配置项，也可以直接把该备用配置项拖到对应的字段顺序位置上。

数据颜色
通过下图可以看出，第一个数据颜色给第一根柱子使用，第二个数据颜色给第二根柱子使用，第三个数据颜色给第三根柱子以及其他的柱子使用。

（2）高亮颜色

高亮即鼠标触碰/点击组件的某一行数据时会出现高亮，以凸显当前数据。
这是一个没有开启“高亮设置”按钮的 T 型分组条形图组件：

开启“高亮设置”的按钮后，才可以单独对组件中每个数据字段的高亮颜色进行配置。
在高亮设置中有时也可能会看见多个配置项，这里与“默认颜色”中配置项的情况是一样的，这里就不多作赘述。

开启高亮设置，并设定高亮颜色、边框宽度等，就可以看到组件在显示对应数据柱子时会显示设置的高亮颜色。

3.1.3 图形文本

（1）柱形文本

开启“图形文本”按钮后，组件中才能显示图形文字。

a）数据格式

T 型分组条形图 开启 2 位小数补零，如下图所示：

b）文字样式

T 型分组条形图 柱形文本显示 x 轴名称，如下图所示：

（2）排名文本

开启“排名文本”按钮后，组件中才能显示图形排名。

T 型分组条形图 排名文本格式为文本模板，如下图所示：

T 型分组条形图 排名文本格式为数值文本模板，如下图所示：

3.1.4 图形形状

（1）基本形状

T 型分组条形图柱子的形状。

T 型分组条形图 分片填充形状，如下图所示：

T 型分组条形图 三角形填充形状，如下图所示：

（2）顶部图形

开启顶部图形按钮后，可在组件柱子上生成单独图形样式。

a）多边形

T 型分组条形图 顶部图形为多边形类型，如下图所示：

b）图片

T 型分组条形图 顶部图形为图片类型，如下图所示：

3.1.5 辅助线

辅助线是一种参考线、分界线，设置辅助线的位置可以对数据分布形态进行分割和归纳，使得数据分布形态及趋势更加明显。

开启辅助线按钮后，可以添加辅助线，并进行设置。

例如将辅助线线条位置设置为“600”，此时组件上会出现一条供参考的分界线，帮助我们查看以数据“600”为分界的数据分布形态。

3.1.6 轴

（1）X 轴

启用 X 轴后，X 轴的样式才会显示在组件中。

根据勾选的 X 轴字段，在“分类”“数值”和“对数”这 3 个选项中选择正确的数据类型，否则会导致 X 轴显示出错，一般 X 轴的数据类型都为“分类”，少数情况下会为“数值”类型。

“对数”是一种数学概念，“底数”是指在对数运算中作为基数的数，一般默认“底数”为“10”。

a）轴线

T 型分组条形图 X 轴轴线样式，如下图所示：

b）刻度线

T 型分组条形图 X 轴轴刻度线样式，如下图所示：

c）刻度值

刻度值在不同的数据类型下的配置项并不相同，下面为大家分别进行介绍。

在数据类型为“分类”或“对数”的情况下：

T 型分组条形图 X 轴轴刻度值样式，如下图所示：

在数据类型为“数值”的情况下：

d）轴名称

T 型分组条形图 X 轴名称样式，如下图所示：

e）网格线

T 型分组条形图 X 轴网格线样式，如下图所示：

（2）Y 轴

启用 Y 轴后，Y 轴的样式才会显示在组件中。

根据勾选的 Y 轴字段，在“分类”“数值”和“对数”这 3 个选项中选择正确的数据类型，否则会导致 Y 轴显示出错，一般 Y 轴的数据类型都为“数值”，少数情况下会为“分类”类型。

“对数”是一种数学概念，“底数”是指在对数运算中作为基数的数，一般默认“底数”为“10”。

a）轴线

T 型分组条形图 Y 轴轴线样式，如下图所示：

b）刻度线

T 型分组条形图 Y 轴轴刻度线样式，如下图所示：

c）刻度值

刻度值在不同的数据类型下的配置项略有不同，下面为大家分别进行介绍。

在数据类型为“数值”的情况下：

T 型分组条形图 Y 轴轴刻度值样式，如下图所示：

在数据类型为“分类”或“对数”的情况下：

d）轴名称

T 型分组条形图 Y 轴名称样式，如下图所示：

e）网格线

T 型分组条形图 Y 轴网格线样式，如下图所示：

3.1.7 图例

图例指组件中会出现每条数据的具体内容，可以从中了解每项代表的意思。

T 型分组条形图 图例样式，如下图所示：

当勾选了多个 Y 轴字段，图例就可以以“翻页”的类型来展示，点击“翻页按钮样式”对翻页按钮单独进行配置。

分组柱状图 翻页按钮样式，如下图所示：

【温馨提示】图例不会随着组件大小变化而变化，但会遮住组件具体内容，此时需要调整组件的内边距以达到内容的完整展现。

3.1.8 提示信息

（1）基本样式

T 型分组条形图 提示信息基本样式，如下图所示：

（2）数据格式

（3）文字样式

T 型分组条形图 提示信息文字样式，如下图所示：

3.1.9 展示设置

在此处设置组件中数据的展示形式。

分组条形图 滚动展示，如下图所示：

分组条形图 轮播展示，如下图所示：

3.1.10 内边距

内边距指组件中心距离组件上下左右边框的位置。

分组条形图 内边距示意图，如下图所示：

3.1.11 大小＆位置

可以通过直接点击和拖动组件来调整大小和位置，也可以通过直接输入宽、高、X 坐标和Y 坐标的方式来设置。

分组条形图 大小＆位置参数示意图，如下图所示：

3.1.12 边框设置

开启“边框设置”按钮后，组件中才会显示边框样式，才可以对组件整体边框样式进行配置。

分组条形图 边框样式，如下图所示：

3.1.13 背景设置

组件默认没有背景颜色，如果需要设置背景颜色，需要先开启“背景设置”项按钮。

分组条形图 使用点九填充背景样式，如下图所示：

分组条形图 平铺填充背景色样式，如下图所示：

3.2. 条件样式设置

所谓条件样式，就是组件会根据数据条件变化的样式。（关于数据条件的设置请参看教程：数据条件）
几乎所有的设置项都可以进行条件样式的设置，但是不同的设置项在设置条件样式时稍有区别，具体有以下两种方式：

方式 1：在扩展设置菜单中设置

大部分设置项的条件设置方式都为方式 1，具体步骤如下：

以“基本设置”中的“不透明度”设置项为例：
点击选中组件，将鼠标移动到该设置项上，就可以看到设置项名称右侧会出现三个点（扩展设置按钮）。

点击这三个点，就可以打开扩展设置的窗口，第一个选项就是“条件样式”。
另外，将鼠标移动到设置项上使用鼠标右键点击，也可以打开扩展设置设置窗口。

点击“条件样式”打开条件样式设置的窗口。

点击“+添加条件样式”，然后选择需要触发的数据条件（这里可选的数据条件必须是已有的数据条件）。
根据当前设置项，我们可以设置满足条件 1 时的不透明度数值，以及当条件都不满足时的不透明度数值。

设置完成之后，该设置项就会出现“已启用条件样式”的提示。

方式 2：直接在设置项中设置

有一些设置项的条件设置方式会直接显示在设置项中，可以直接进行设置，具体步骤如下：

比较常用的一个设置就是根据数据条件来改变组件的颜色，这里我们就以“颜色”设置为例：
点击选中组件，开启“条件样式”按钮，就可以进行条件样式的设置。

【温馨提示】关于颜色的数据条件设置在“3.1.2 默认颜色”中已经作了详细的说明，这里就不多作赘述。

3.3. 通过数据字段设置样式

所有设置项的修改本质都是值的修改，所以所有设置项都可以通过数据字段进行控制，这里需要用到动态数据字段功能。

仍然以“基本设置”中的“不透明度”设置为例：
打开扩展设置的窗口，点击第三个选项“生成数据字段”。

点击后，该设置项就会出现“请设置数据字段”的提示。

切换到“数据”设置界面，此时可以看到界面中新添加了一个“动态数据字段”的设置项，并且针对刚才选择的“不透明度”设置项生成了一个关联的字段。

接下来只需要添加一个数据字段到这里，就可以通过数据来控制不透明度了。
添加一个数值为“0”的数据到数据字段中，可以看到通过动态数据字段将不透明度的数值修改为“0”，从而使组件隐藏。

4. 设置组件交互

点击选中组件，在右侧“交互”设置窗口中可以对当前组件的交互进行添加和删除。

所有组件在添加后都有两个预设交互，对应的分别是入场动画和离场动画，这两个交互建议大家不要删除。
对于图表类组件，通常不需要设置动画之外的交互。

5. 二次开发

点击选中组件，在右侧“代码”设置窗口中可以对组件进行二次开发设置。

二次开发需要通过载入JavaScript 脚本文件来实现。
点击“+”添加设置项，多个脚本可以添加多个设置项。

在二开的过程中，我们可以对组件的样式进行控制。如果我们希望控制某个设置项，可以先在样式中查看该设置项的二开代码示例。

以“不透明度”设置项为例：
打开扩展设置的弹窗，点击“调用代码示例”。

可以看到这个设置项的二次开发调用代码示例。

这里我们举一个简单的二开示例（更详细的请参考二次开发教程）：
二开功能：组件自动在大屏上向右移动
示例代码：如下所示

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

/**
 * Extension.prototype.element;
 * Extension.prototype.enabled;
 * Extension.findExtensionsOfClass(className)
 * Element.prototype.setOption()
 * Element.prototype.getOption()
 * Element.prototype.getFullData()
 * Element.prototype.name
 */
class Button{
  update(){
    const position = this.element.getOption(
      ["position"]
    );
    // 当前元素在X轴上移动一定的距离
    this.element.setOption(
      ["position"],
      [(position[0] + 1 )%100,position[1]]
    );
  }
}
export default Button;

点击“选择文件”，添加JavaScript 脚本文件，脚本启用后效果如下图所示：

6. 设置组件的多状态切换

多状态主要用于通过数据条件或是点击交互（通常是点击其他组件来触发本组件的状态切换）来切换组件设置项的场景，这里的设置项包括组件的样式、交互、数据和代码。

在以数据条件为触发条件时，条件样式和状态切换可以实现相同的效果。（例如数据变化后改变组件颜色）
在以鼠标操作为触发条件时，交互和状态切换可以实现相同的效果。（例如通过点击按钮切换组件的显示隐藏状态）
具体通过哪种方法没有固定的要求，大家可以自行选择。但是在不同的应用场景中，虽然最终都能实现相同的效果，但是设置便捷程度会有一些区别。

6.1. 添加状态

每一个组件都有一个默认的状态属性，在这个默认的状态中，包含了上述所有的设置。

但是我们也可以添加多个状态，这样每个状态都会包含上述所有的设置，而这些状态之间又是互相独立的。
我们可以通过以下两种方式来添加新状态：

第一种：新建状态

点击右上角的“+”可以添加一个新的组件状态。

在状态设置窗口中，我们可以设置状态的名称。

新建的状态需要有默认的设置，默认情况下新状态都与当前组件的默认状态保持一致。
我们也可以修改这个默认设置，开启窗口中的高级设置，我们可以设置这个新状态的跟随对象，也就是这个新状态与现有的哪个状态设置保持一致。

第二种：复制已有状态

点击右上角的状态名称可以展开状态列表，展开后可以看到当前组件的所有状态。

在这个状态列表中，我们可以对状态进行重命名、复制和删除。
点击状态名称右侧的复制按钮，可以复制当前状态为一个新状态，复制后的新状态的所有设置项与复制对象状态保持一致。

6.2. 切换状态

在编辑项目时，我们可以通过点击状态列表中的不同状态来切换组件状态。

在项目运行时，状态的切换一般需要通过数据条件或点击交互。

第一种：根据数据条件切换状态
在新建状态时，或者点击状态列表右侧的编辑可以打开状态设置窗口，在开启高级设置后，可以看到状态切换的数据条件设置。
在这里我们可以选择已设置的数据条件，从而在数据条件满足时，组件的状态就会发生变化。

第二种：根据点击交互切换状态

通过点击交互来切换组件状态一般是点击其他组件来切换当前组件的状态，所以交互设置在其他组件上而非本组件上。举个例子，点击按钮切换当前组件的显示隐藏状态。

首先先给组件设置一个隐藏状态（默认状态当做显示状态）。
点击“+”新建“隐藏”状态，然后在该状态下修改组件不透明度为“0%”。

添加一个“显示”按钮和一个“隐藏”按钮。
为显示按钮组件添加一个交互，点击后切换组件到默认状态（显示状态）。

给隐藏按钮组件添加一个交互，点击后切换组件到隐藏状态。

这样我们就实现了点击按钮切换组件显示/隐藏的效果了。

6.3. 锁定状态

在组件的样式设置中，大家会发现有一些设置项上有个锁定的图标，这个表示当前所有状态中的这个设置项都已经被锁定到默认状态，也就意味着如果修改这个设置项，那么所有状态中的这个设置项都会统一被修改。
这是在组件的多状态下可以统一修改多个状态中相同的设置项的功能。

如果不想锁定，可以点击后进行解锁，那么所有状态中的这个设置项都会被解锁。

有一些常用的设置项默认就被锁定了，如果希望锁定其他设置项，可以点击设置项右侧的三个点，然后进行锁定。