山海鲸可视化

数据变化

1. 简介

数据变化主要用来反映数据的变化趋势，包括增长或者下降。

2. 效果展示

效果.png

3. 样式

在样式中可以设置数据变化组件的位置、字体、边框、和背景等。

接下来，会用以下示例数据对组件样式进行说明：

月份	入港人流量（万人）	出港人流量（万人）
1 月	16	27

3.1 基本设置

配置项	说明
不透明度	这个设置项的一个常见用法是结合条件样式/交互/多状态来实现组件的显示和隐藏。
默认值	当没有字段时显示该数值，也可以直接填入一个数值。
显示样式	4 种样式：图标在前、数据在前、只显示数据、只显示图标。
数据格式	2 种格式：数值、百分比。
小数位数	手动填入位数，如果位数超出设置的位数限制，则进行四舍五入处理。
小数补零	小数位数不够时，默认为 0。
显示正号/显示负号	显示数据的正号/负号。

数据变化 图标在前/数据在前样式，如下图所示：
图标在前.png 效果.png

数据变化 只显示数据/只显示图标样式，如下图所示：
只显示数据.png 只显示图标.png

3.2 数据样式

当数据处于不同趋势时可以对其字体颜色、大小等进行设置，共有 3 种趋势：数据增长时、数据保持不变时和数据下降时。

在示例数据中，数据为正增长趋势，因此只显示为数据增长时的字体颜色。
数据增长.png

数据增长时.png

3.3 显示单位

在此处可手动填入数据的单位，并进行字体和位置的设置。
单位.png

3.4 图标样式

当数据处于不同趋势状态下可以对其图标颜色、大小和样式进行设置，共有 3 种趋势：数据增长时、数据保持不变时和数据下降时。

数据变化 图标样式为曲线/折线，如下图所示：
曲线箭头.png 折现箭头.png

数据变化 图标样式为正号/圆点，如下图所示：
正好.png 圆点.png

3.5 字体设置

设置文本的水平对齐方式，包括左对齐、居中对齐和右对齐。

3.6 大小＆位置

通常我们可以通过直接点击和拖动组件来设置大小和位置，在这里也可以通过直接输入X 坐标、Y 坐标、宽和高来设置。

配置项	说明
组件大小	组件的 X、Y 轴坐标，X 坐标为组件左上角距离页面左边界的像素距离，Y 坐标为组件左上角距离页面上边界的像素距离。
组件位置	即组件的宽度和高度，单位为px。
组件旋转	三维空间旋转可以输入任意数值，数值对应角度向 X 轴/Y 轴旋转。

位置.png

3.7 边框设置

在此处可以对组件边框的边框颜色、宽度、图形边框圆角半径和边框样式等样式进行配置，边框样式包括实线、虚线、点状线和无边框 4 种。
边框.png

3.8 背景设置

组件默认没有背景颜色，如果需要设置背景颜色，可以在此处进行设置，也可以将背景设置为一张图片或视频，可以选择填充方式和模糊程度。

数据变化 无背景色样式，如下图所示：
效果.png

数据变化 有背景色样式，如下图所示：
背景.png

4. 交互

交互功能为组件赋予了在一定条件下与大屏操作进行交互的能力。

【温馨提示】详细的交互设置请参考设置交互教程。

5. 数据

对数据进行配置可以让组件根据相应的数据显示对应的图形，目前，山海鲸可视化软件支持导入文件数据、连接数据库、连接 API、连接山海鲸数据管家等多种数据连接方式。

5.1 字段设置

在该组件中，只有一个数字字段，可将数据拖拽放入对应轴字段展示数据，也可单击后一一勾选。

该组件的字段只能设置一个，如下图所示：

上图中所用示例数据如下：

1 月销量	2 月销量	增长率 1	增长率 2
1000	2000	0.25	-25％

5.2 数据联动

假设有 2 个表单分别为表单 A、表单 B，将 A 表单里某个字段的值作为查询条件，关联引用出 B 表单的数据，并填写到指定的字段中，就是数据联动。

联动项	说明
联动其他组件	开启数据联动后，单击一个图表中的任一数据点，其他使用相同数据集的图表也会随其联动变化。
受其他组件联动	开启数据联动后，图表中的数据会随发起联动的组件的变化而变化。

【温馨提示】详细的数据联动设置请参考设置数据联动教程。

5.3 数据筛选

将满足条件的数据通过筛选过滤出来。

筛选条件	说明
不筛选	不进行数据筛选。
筛选数据源指定行	可选择筛选数据源某一行数据。
选择数据条件	可自行选择数据筛选的条件。

【温馨提示】详细的数据筛选设置请参考设置数据筛选教程。

6. 代码

通过添加JavaScript 文件，可以满足对组件进行二次开发的需求。

例如，我们希望组件能够自动在大屏上向右移动，只需添加相应的JavaScript 文件即可实现。以下为本教程中使用的示例代码：

/**
 * 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;