散点图

1. 简介

散点图是使用散点来展示数据的一种图表，支持自定义 X 轴、Y 轴以及散点的样式，适用于展示不同时间下离散数据的差异。

2. 效果展示

效果.png

3. 样式

在样式中可以设置散点图组件的位置、颜色、坐标轴、提示信息和展示状态等。

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

月份	销售额
Jan	110
Feb	200
Mar	130
Apr	300
May	280
Jun	500
Jul	410
Aug	600
Sept	390
Oct	700

3.1 基本设置

配置项	说明
不透明度	1）根据个人喜好或整体和谐度合理地使用透明度，会让大屏布局更美观；	2）这个设置项的一个常见用法是结合条件样式/交互/多状态来实现组件的显示和隐藏。
抽样率	1）对数据进行抽样展示。如有 100 条数据，抽样率为 100%，此时会显示 100 条数据，如抽样率为 50％，则只显示 50 条数据；	2）这个设置项主要是在数据量过多、组件显示效果不佳时，可以借助这个选项来减少数据量，但是与此同时部分数据也会不显示，所以要谨慎使用。

散点图 透明度变化，如下图所示：
透明度1.gif

3.2 颜色

指示组件的填充颜色。给组件的 Y 轴字段配置数据后，可以对这些字段单独进行颜色设置。

散点图 示例数据颜色，如下图所示：
原颜色设置.png 效果.png

散点图 更换数据颜色，如下图所示：
颜色设置.png 颜色.png

3.3 X 轴

配置项	说明
数据类型	有3 种类型，分别是分类、连续数值和时间，数据类型的选择根据导入的数据源而定。
轴线	X 轴的线条类型、颜色及粗细的配置。
轴刻度线	X 轴的刻度线颜色、粗细及长度的配置。
轴刻度值	X 轴的轴标签位置、距轴线的位置、字体设置、外发光展示设置及旋转角度的配置。

X轴.png

3.4 Y 轴

配置项	说明
轴线	Y 轴的线条类型、颜色及粗细的配置。
轴刻度线	Y 轴的刻度线颜色、粗细及长度的配置。
轴刻度值	Y 轴的轴标签显示格式、计数单位、小数设置、刻度值范围和颜色、大小，字体设置和外发光显示设置，其中轴刻度值支持系统自适应，也也支持自定义值范围。
显示轴单位	Y 轴的轴标签的单位，可调整单位内容和字体样式。

Y轴.png

【温馨提示】要注意Y 轴的轴刻度值设置，轴刻度值显示格式有两种：数值和百分比，注意选择和数据相对应的格式。轴刻度值设置有两种：自适应和自定义，在自定义的时候要注意最小、最大刻度值的设置，必须比数据的值大。

3.5 缩略轴

缩略轴，是一个辅助查看数据的组件，开启缩略轴后可以看数据全貌，也可以看具体的数据内容，最主要的是可以拖拽缩略轴观察数据在一定区间内的演变。
缩略轴1.gif

3.6 网格线

网格线易于查看和计算数据，在这里可以对组件的 X 轴、Y 轴的网格线进行设置，包括线条类型和粗细、线条颜色和粗细等内容。
网格线.png

3.7 辅助线

辅助线是一种参考线、分界线，设置辅助线的位置可以对数据分布形态进行分割和归纳，使得数据分布形态及趋势更加明显。当线条类型为虚线时，可以设置 Y 轴的虚线粗细。

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

辅助线.png

3.8 排序

将数据按一定顺序来呈现在组件中，组件的排序方式有 3 种：不排序、从小到大、从大到小。
排序.png

3.9 图形形状

图形形状描述的是组件中数据的条形形状，在此处可对散点的半径和描边进行设置。

散点图 散点半径为 10 样式，如下图所示：
半径.png

3.10 图例

鼠标移动到图表中会出现每条数据的具体内容，可以了解每项代表的意思。图例设置包括图例位置、颜色、大小及偏移量。
文本.png

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

3.11 内边距

内边距可以设置组件中心距离上下左右边框各自的位置，单位为px。
边距.png

3.12 提示信息

提示信息指的是鼠标移动到组件上时显示的信息，提示信息样式包括：提示框样式、文字样式和数据样式的设置。
提示.gif

3.13 展示设置

可以设置组件中数据的展示形式，包括展示延迟、持续时间、循环播放展示等。
提示.gif

3.14 大小＆位置

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

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

位置.png

3.15 边框设置

在此处可以对组件边框的边框颜色、宽度、图形边框圆角半径等样式进行配置。
边框.png

3.16 背景设置

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

散点图 无背景色样式，如下图所示：
效果.png

散点图 有背景色样式，如下图所示：
背景.png

4. 交互

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

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

5. 数据

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

5.1 字段设置

在组件中，X 轴字段为纵坐标，反应了散点图的组成部分，Y 轴字段为横坐标，反应了每一个散点部分的不同高度。可将数据拖拽放入对应轴字段展示数据，也可单击后一一勾选。

当X 轴为一个字段，Y 轴为多个字段时，组件如下所示：
字段.png

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

月份	产品一	产品二	产品三
一月	110	230	381
二月	350	160	350
三月	310	190	222
四月	250	222	160
五月	150	301	230
六月	410	333	162
七月	450	260	362
八月	360	300	155
九月	280	130	402
十月	111	402	222
十一月	80	241	100
十二月	120	231	130

5.2 动态数据项

使用动态数据，可以更灵活地对组件中的每一个样式属性做设置。

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

5.3 数据联动

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

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

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

5.4 数据筛选

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

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

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

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;

点击“选择资源文件”，添加含示例代码的 JavaScript 文件。

添加完成后会代码会自动执行，此时组件已经能够自动在大屏上向右移动了。
代码.gif

【温馨提示】详细的代码设置请参考二次开发教程。

7. 扩展设置

组件的每个样式属性都可以打开一个“扩展设置”菜单，将鼠标移至属性名称的右侧点击后即可看到，菜单共包含三个选项：“条件样式”、“调用代码示例”、“生成数据字段”。
基本设置.png

7.1 条件样式

此功能可以将已经设置好的数据条件应用于组件的样式属性中，便于实现组件在不同条件下的状态。

【温馨提示】详细的条件样式设置请参考数据条件教程。

7.2 调用代码示例

此功能用于组件的二次开发，便于编写二次开发相关的JavaScript 代码。

【温馨提示】详细的调用代码示例设置请参考二次开发教程。

7.3 生成数据字段

此功能可以给组件的样式属性生成一个“动态数据项”，便于精准控制样式的属性值。
动态.png

【温馨提示】详细的生成数据字段设置请参考设置动态数据项教程。

8. 组件状态

组件可以设置多个状态，状态之间可以通过设置状态触发条件来进行切换。

【温馨提示】详细的组件状态设置请参考设置组件的多状态教程。

散点图