常规组件公共库参考指南
✅使用指南
EasyV平台本身内置了各式各样精美的常规组件（例如柱状图、折线图、饼图等等），以充分满足用户搭建可视化应用的需求。为了降低学习搭建成本，快速上手可视化应用的搭建，EasyV对官方组件进行了标准化改造。在常规组件中很多组件的配置项是通用的，我们对这些组件的通用配置项做了封装，那么在了解掌握了一个组件的配置项之后，其他同类型组件就无需增加很多额外的学习成本。
本文就柱状图、折线图、饼图、散点图的通用配置项进行了说明，帮助你快速上手所有同类型的组件😎！
⬛️ 柱状图
一、样式
在样式中可以设置组件的基本属性、全局、坐标轴、系列和提示框。
1、基本属性
位置尺寸
位置包括组件的横坐标和纵坐标，单位为px；横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。
尺寸包括组件的宽度和高度，单位为px；可单击比例锁锁定组件宽高比，等比例调整组件的宽高，比例锁默认不锁定。
基本柱状图组件尺寸不影响组件内容显示、组件动画。
*组件位置尺寸说明
默认隐藏
勾选之后在初始加载时组件默认隐藏且关闭回调触发，通常用来配合显隐控制，如【选项卡】组件进行显隐切换。
2、全局
边距
基本柱状图表距离整个组件四边（上、下、左、右）的边距
*边距样式说明
柱状样式
配置项 | 说明 |
柱状类型 | 柱子样式，可选择方形或子弹头 |
系列间距 | 柱子间不同系列的间距，取值范围不限，柱子粗细根据柱间间距自适应 |
柱间间距 | 每组柱子间的间距，取值范围不限，柱子粗细根据柱间间距自适应 |
外间距 | 柱子与图表两侧的间距，取值范围0-1，柱子粗细根据柱外间距自适应 |
柱子背景 | 柱子的背景颜色、透明度 |
*柱间距说明
图例
在图例中可以调整组件的文本样式、图标尺寸、间距、布局、点击交互和未选中样式。
a. 文本样式
可对文本样式按需修改
b. 图标尺寸
自定义图例图标尺寸，基本折线图默认折线。
c. 间距
调整图例图标与文字之间的间距
d. 布局
在「布局」中支持进一步调整图例列数、间距、位置和偏移。
配置项 | 说明 |
列数 | 图例的列数 |
间距 | 图例之间的行距以及列距 |
位置 | 图例的展示位置 |
偏移 | 通过x轴和y轴控制偏移量 |
e.点击交互
开启「点击交互」后，可通过点击标签筛选并显示对应数据，关闭该功能后无法进行点击交互。
同时，可在「未选中样式」中配置透明度来区分未选中时的样式。
*点击交互配置项说明
轮播动画
开启后图表数据进行轮播，可设置滚动时长和动画间隔。
数据动画
开启后首次加载和数据变化时会加载动画效果。
3、坐标轴
启用
启用可以选择是否开启某坐标轴，取消勾选后则取消该坐标轴和对应的配置。
X轴
通过「启用」控制X轴显隐，可通过轴标签、轴线、刻度和网格线进行坐标轴样式配置：
配置项 | 说明 |
轴标签 | X轴的轴标签，可调整格式、文本样式、展示方式和偏移量 |
轴线 | X轴的轴线颜色和粗细 |
刻度 | X轴的刻度线的颜色、粗细、长度 |
网格线 | X轴的网格线样式 |
其中，X轴标签分为类目型和时间型两个不同维度：
类目型：以类目为单位，标签名由数据源提供。
时间型：以时间为单位，如下图 👇
注：展示标签的数量会根据原标签数量进行整除后展示,如果输入的数量不能被整出，则会出现不能如期按照输入数量进行展示的情况。（因为组件本身逻辑，在处理标签显示时，会整除后按间距调整数量分布，如果不能整除，则无法正确分配间距）
例如原标签数量为12，则可展示3、4、6个（可被整除）标签的的展示等。如果想展示输入数量的标签也可启动轮播。
*X轴轴标签样式说明
Y轴
通过「启用」控制Y轴显隐，可通过轴标签、轴单位、轴线、刻度和网格线进行坐标轴样式配置：
配置项 | 说明 |
轴标签 | y轴数值范围，支持自定义输入，也支持系统选择，置空时系统根据数据中的最大、最小值和指标点的个数自动计算； 标签刻度支持自适应和数量强制或步长强制，非自适应情况下可编辑标签和步长数量，小数点位数； 支持修改后缀内容、偏移和文本样式。 |
轴单位 | Y轴轴标签的单位，可调整单位内容、偏移量和文字样式 |
轴线 | Y轴的轴线，支持修改颜色和粗细 |
刻度 | Y轴的刻度线，可调整刻度线的颜色、粗细、长度 |
网格线 | Y轴的网格线样式 |
其中，Y轴标签支持以下刻度配置：
「数值范围」支持自定义输入，也支持系统选择，置空时系统根据数据中的最大/小值和指标点的个数自动计算；
「标签刻度」支持开启「刻度自适应」或设置「数量强制」和「步长强制」，非自适应情况下可自定义编辑标签、步长数量及小数位数；
*Y轴轴标签样式说明
Z轴
通过「启用」控制Z轴显隐，可通过轴标签、轴单位、轴线、刻度和网格线进行坐标轴样式配置：
配置项 | 说明 |
轴标签 | Z轴数值范围，支持自定义输入，也支持系统选择，置空时系统根据数据中的最大最小值和指标点的个数自动计算； 标签刻度支持自适应或数量强制和步长强制，非自适应情况下可编辑标签和步长数量，小数点位数； 支持修改后缀内容、偏移和文本样式。 |
轴单位 | Z轴轴标签的单位，可调整单位内容、偏移量和文字样式 |
轴线 | Z轴的轴线，支持修改颜色和粗细 |
刻度 | Z轴的刻度线，可调整刻度线的颜色、粗细、长度 |
网格线 | Z轴的网格线样式 |
其中，Z轴标签同样支持以下配置：
「数值范围」支持自定义输入，也支持系统选择，置空时系统根据数据中的最大/小值和指标点的个数自动计算；
「标签刻度」支持开启「刻度自适应」或设置「数量强制」和「步长强制」，非自适应情况下可自定义编辑标签、步长数量及小数位数；
*Z轴轴标签样式说明
4、系列
对数据有类型区分展示需求时，可以将数据划分成不同系列。
当图表数据存在多类型展示需求时，组件默认将数据划分成多个系列，用户可通过对各系列数据进行自定义数据映射，从而完成对每个系列配置相应样式。
其中，数据系列操作支持：
：增加一个系列数据
：删除一个系列数据
：调整系列的显示格式（纵向展示、横向展示）
配置项
配置项 | 说明 |
映射 | 映射的字段名对应数据中的s系列字段，显示名是编辑页面中字段的变量名 |
纵轴选择 | 当有多个维度的数据需要展示时，支持对不同的系列选择不同轴向展示(前提：需同时开启Y、Z坐标轴)。 |
填充样式 | 可选择纹理或者颜色 |
颜色 | 改变指定系列的颜色 |
极值高亮 | 对基本柱状图中的同一系列的数据中的最大值(最小值)高亮 |
*数据系列配置项说明
*轴向选择配置项说明
数值标签
柱子数据值的标签
配置项 | 说明 |
文本样式 | 数值标签的文本字体、字号、颜色、透明度、间距等 |
偏移 | 数值标签的数字与柱子的偏移距离，数值越大，距离越远 |
位置 | 可选择数值标签的位置（起点、居中、终点、终点外、图表外） |
5、提示框
自动轮播
启用后提示框进行自动轮播，可设置停留时间。
手动触发
鼠标悬浮到对应系列上时，显示提示框。
提示框
字段 | 说明 |
提示框样式 | 柱状图的提示框，支持调整提示框的背景、尺寸、边距和偏移量 |
行高 | 每个数据值间的行高 |
框内数据 | 提示框内的数据，支持修改类目标签、数据名称、数据值的文字样式、后缀等 |
*提示框配置项说明
指示器
提示的高亮区域，支持修改颜色和宽度。
*指示器配置项说明
二、数据
组件数据格式
字段 | 说明 |
x | 类目，即x轴文本 |
y | 值，即y轴数值 |
s | 系列 |
*组件数据格式说明
JSON数据案例
[
{
"x": "2010/01/01 00:00:00",
"y": 180,
"s": "系列一"
},
{
"x": "2010/01/01 00:00:00",
"y": 320,
"s": "系列二"
},
{
"x": "2010/02/01 00:00:00",
"y": 200,
"s": "系列一"
},
{
"x": "2010/02/01 00:00:00",
"y": 120,
"s": "系列二"
},
{
"x": "2010/03/01 00:00:00",
"y": 160,
"s": "系列一"
},
{
"x": "2010/03/01 00:00:00",
"y": 180,
"s": "系列二"
},
{
"x": "2010/04/01 00:00:00",
"y": 200,
"s": "系列一"
},
{
"x": "2010/04/01 00:00:00",
"y": 160,
"s": "系列二"
},
{
"x": "2010/05/01 00:00:00",
"y": 180,
"s": "系列一"
},
{
"x": "2010/05/01 00:00:00",
"y": 220,
"s": "系列二"
},
{
"x": "2010/06/01 00:00:00",
"y": 180,
"s": "系列一"
},
{
"x": "2010/06/01 00:00:00",
"y": 220,
"s": "系列二"
}
]数据配置项说明
配置项 | 说明 |
数据源 | 数据源类型、数据源选择等 |
数据过滤器 | 勾选启用数据过滤器，单击添加过滤器，可在设置数据源页面中配置数据过滤器，详情请参见数据过滤器使用说明 |
数据响应结果 | 展示数据请求的响应结果 |
自动更新 | 选中后可以设置数据请求时间间隔 |
数据对接详情
数据对接详情请见以下文档👇
三、交互
载入动画
所有组件均提供移入、移入(小)、划变三种组件载入动画。
载入动画选择无时，则组件没有载入动画。
载入动画仅在可视化应用预览、发布组件加载时显示。
配置项 | 说明 |
渐隐渐显 | 启用是 |
速率 | 匀速、慢快慢(cubic-bezier(0.25,0.1,0.25,1))、低速开始、低速结束、低速开始和结束(cubic-bezier(0.42,0,0.58,1)) |
方向 | 动画方向 |
持续时间 | 载入动画持续时间，单位为ms |
延时 | 载入动画延时长，单位为ms |
回调参数
回调参数可以理解为参数变量，用于控制组件之间参数的传递，从而达到交互的目的。
字段值即参数变量，变量名是对字段值的重命名
详细的回调参数教学👉 回调的使用
自定义事件
自定义事件为「交互事件」的增强模块，支持通过数据驱动组件状态、或变更组件样式配置，也可自定义编辑复杂的条件逻辑。
详细的自定义事件教学👉自定义事件教学
〰️折线图
一、样式
在样式中可以设置组件的基本属性、全局、坐标轴、系列和提示框。
1、基本属性
位置尺寸
位置包括组件的横坐标和纵坐标，单位为px；横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。
尺寸包括组件的宽度和高度，单位为px；可单击比例锁锁定组件宽高比，等比例调整组件的宽高，比例锁默认不锁定。
*尺寸调整不影响组件内容显示、组件动画。
*组件位置尺寸说明
默认隐藏
勾选之后在初始加载时组件默认隐藏且关闭回调触发，通常用来配合显隐控制，如【选项卡】组件进行显隐切换。
2、全局
在全局中支持配置组件边距、外间距、图例、数据动画等样式。
边距
图表距离整个组件四边（上、下、左、右）的边距。
*边距样式说明
外间距
曲线与图表外围的间距，取值范围0-1。
*外间距说明
图例
在图例中可以调整组件的文本样式、图标尺寸、间距、布局、点击交互和未选中样式。
a. 文本样式
可对文本样式按需修改
b. 图标尺寸
自定义图例图标尺寸，基本折线图默认折线。
c. 间距
调整图例图标与文字之间的间距
d. 布局
在「布局」中支持进一步调整图例列数、间距、位置和偏移。
配置项 | 说明 |
列数 | 图例的列数 |
间距 | 图例之间的行距以及列距 |
位置 | 图例的展示位置 |
偏移 | 通过x轴和y轴控制偏移量 |
e.点击交互
开启「点击交互」后，可通过点击标签筛选并显示对应数据，关闭该功能后无法进行点击交互。
同时，可在「未选中样式」中配置透明度来区分未选中时的样式。
*点击交互 - 未选中样式
轮播动画
开启后图表数据进行轮播，可设置滚动时长和动画间隔。
数据动画
开启后首次加载和数据变化时会加载动画效果。
3、坐标轴
组件坐标轴分为x轴、y轴、z轴，可通过「启用」来控制是否开启某一轴的数据。
如下图所示，当取消开启x轴后可以看到x轴和x轴的相关配置项消失。
*启用x轴
X轴
通过「启用」控制X轴显隐，可通过轴标签、轴线、刻度和网格线进行坐标轴样式配置：
配置项 | 说明 |
轴标签 | X轴的轴标签格式、文本样式、展示方式和偏移量 |
轴线 | X轴的轴线颜色和粗细 |
刻度 | X轴的刻度线的颜色、粗细、长度 |
网格线 | X轴的网格线样式分布 |
其中，X轴标签分为类目型和时间型两个不同维度：
类目型：以类目为单位，标签名由数据源提供。
时间型：以时间为单位，如“2017-1-1”、“2017年01月01日”等，如下图
Y轴
通过「启用」控制Y轴显隐，可通过轴标签、轴单位、轴线、刻度和网格线进行坐标轴样式配置：
配置项 | 说明 |
轴标签 | Y轴轴标签配置，包括数据范围、刻度模式、文本样式、数据格式化、后缀内容和偏移量 |
轴单位 | Y轴轴标签的单位，可调整单位内容、偏移量和文字样式 |
轴线 | Y轴的轴线，支持修改颜色和粗细 |
刻度 | Y轴的刻度线，可调整刻度线的颜色、粗细、长度 |
网格线 | Y轴的网格线样式 |
其中，Y轴标签支持以下刻度配置：
「数值范围」支持自定义输入，也支持系统选择，置空时系统根据数据中的最大/小值和指标点的个数自动计算；
「标签刻度」支持开启「刻度自适应」或设置「数量强制」和「步长强制」，非自适应情况下可自定义编辑标签、步长数量及小数位数；
Z轴
通过「启用」控制Z轴显隐，可通过轴标签、轴单位、轴线、刻度和网格线进行坐标轴样式配置：
配置项 | 说明 |
轴标签 | Z轴轴标签配置，包括数据范围、刻度模式、文本样式、数据格式化、后缀内容和偏移量 |
轴单位 | Z轴轴标签的单位，可调整单位内容、偏移量和文字样式 |
轴线 | Z轴的轴线，支持修改颜色和粗细 |
刻度 | Z轴的刻度线，可调整刻度线的颜色、粗细、长度 |
网格线 | Z轴的网格线样式 |
其中，Z轴标签同样支持以下配置：
「数值范围」支持自定义输入，也支持系统选择，置空时系统根据数据中的最大/小值和指标点的个数自动计算；
「标签刻度」支持开启「刻度自适应」或设置「数量强制」和「步长强制」，非自适应情况下可自定义编辑标签、步长数量及小数位数；
4、系列
当图表数据存在多类型展示需求时，组件默认将数据划分成多个系列，用户可通过对各系列数据进行自定义数据映射，从而完成对每个系列配置相应样式。
其中，数据系列操作支持：
：增加一个系列数据
：删除一个系列数据
：调整系列的显示格式（纵向展示、横向展示）
数据系列
配置项 | 说明 |
映射 | 映射中字段名对应数据中的系列字段，显示名是编辑页面中字段的变量名 |
纵轴选择 | 选择当前系列对应的纵轴Y轴/Z轴 |
折线 | 改变指定系列的折线样式，样式内容包括折线类型、颜色、粗细、曲线、null值连接 |
数据标记 | 改变指定系列的数据标记模式，单圆/双圆标记样式 |
数值标签 | 默认未开启。开启下改变文本样式、偏移 |
*系列 - 数据映射 字段名和显示名
*系列 - 数值标签
5、提示框
自动轮播
默认未开启，开启下提示框按轴标签横向轮播。
悬停触发
支持鼠标焦点移入到对应的数据点后会显示当前对应的数据提示框。
*悬停触发 提示框效果
提示框
提示框整体分为两部分，提示框样式和框内数据：
组成 | 说明 |
提示框样式 | 提示框的样式，支持调整提示框的背景、尺寸、边距和偏移量 |
框内数据 | 提示框内的数据，支持修改标签、行高、数据的文字样式 |
行高 | 提示框内每个数据值间的行高 |
*框内数据 对应样式配置
二、数据
组件数据格式
字段 | 说明 |
x | 类目，即x轴文本 |
y | 值，即y轴数值 |
s | 系列 |
*组件数据格式说明
JSON数据案例
[
{
"x": "2010/01/01 00:00:00",
"y": 180,
"s": "系列一"
},
{
"x": "2010/01/01 00:00:00",
"y": 320,
"s": "系列二"
},
{
"x": "2010/02/01 00:00:00",
"y": 200,
"s": "系列一"
},
{
"x": "2010/02/01 00:00:00",
"y": 120,
"s": "系列二"
},
{
"x": "2010/03/01 00:00:00",
"y": 160,
"s": "系列一"
},
{
"x": "2010/03/01 00:00:00",
"y": 180,
"s": "系列二"
},
{
"x": "2010/04/01 00:00:00",
"y": 200,
"s": "系列一"
},
{
"x": "2010/04/01 00:00:00",
"y": 160,
"s": "系列二"
},
{
"x": "2010/05/01 00:00:00",
"y": 180,
"s": "系列一"
},
{
"x": "2010/05/01 00:00:00",
"y": 220,
"s": "系列二"
},
{
"x": "2010/06/01 00:00:00",
"y": 180,
"s": "系列一"
},
{
"x": "2010/06/01 00:00:00",
"y": 220,
"s": "系列二"
}
]数据配置项说明
配置项 | 说明 |
数据源 | 数据源类型、数据源选择等 |
数据过滤器 | 勾选启用数据过滤器，单击添加过滤器，可在设置数据源页面中配置数据过滤器，详情请参见数据过滤器使用说明 |
数据响应结果 | 展示数据请求的响应结果 |
自动更新 | 选中后可以设置数据请求时间间隔 |
数据对接详情
数据对接详情请见以下文档👇
三、交互
载入动画
所有组件均提供移入、移入(小)、划变三种组件载入动画。
载入动画选择无时，则组件没有载入动画。
载入动画仅在可视化应用预览、发布组件加载时显示。
配置项 | 说明 |
渐隐渐显 | 启用是 |
速率 | 匀速、慢快慢(cubic-bezier(0.25,0.1,0.25,1))、低速开始、低速结束、低速开始和结束(cubic-bezier(0.42,0,0.58,1)) |
方向 | 动画方向 |
持续时间 | 载入动画持续时间，单位为ms |
延时 | 载入动画延时长，单位为ms |
回调参数
回调参数可以理解为参数变量，用于控制组件之间参数的传递，从而达到交互的目的。
字段值即参数变量，变量名是对字段值的重命名
详细的回调参数教学👉 回调的使用
自定义事件
自定义事件为「交互事件」的增强模块，支持通过数据驱动组件状态、或变更组件样式配置，也可自定义编辑复杂的条件逻辑。
详细的自定义事件教学👉自定义事件教学
🔵饼图
（基于3D饼图打个样）
一、样式
在样式中可以设置组件的基本属性、全局、饼图属性、系列和轮播动画。
1、基本属性
位置尺寸
位置包括组件的横坐标和纵坐标，单位为px；横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。
尺寸包括组件的宽度和高度，单位为px；可单击比例锁锁定组件宽高比，等比例调整组件的宽高，比例锁默认不锁定。
*尺寸调整不影响组件内容显示、组件动画。
*组件位置尺寸说明
默认隐藏
勾选之后在初始加载时组件默认隐藏且关闭回调触发，通常用来配合显隐控制，如【选项卡】组件进行显隐切换。
2、全局
在全局中支持配置组件边距、相机设置、图例等样式。
边距
图表距离整个组件四边（上、下、左、右）的边距。
*边距样式说明
像素比
可调整组件像素比值，像素比越大，组件渲染越清晰。
注意：减小像素比值以通过降低组件效果来缓解性能负担。
*低像素值（上） 高像素值（上）
相机设置
可改变物体在视图相机中的投影类型。每个3D视图都支持两种不同类型的投影：正交相机和透视相机。
相机配置 | 说明 |
移动 | 通过X、Y、Z设置饼图视角位置。 |
旋转 | 通过绕X轴、绕Y轴、绕Z轴设置饼图旋转角度。 |
*正交相机 透视相机
图例
在图例中可以调整组件的顺序、图标尺寸、间距、类目、占比值、真实值和布局。
配置项 | 说明 |
顺序 | 支持按图例数据进行排序，包括数据返回顺序、从大到小、从小到大。 |
图表尺寸 | 支持自定义图例图标尺寸，3D饼图默认方形。 |
间距 | 支持调整图例图标与文字之间的间距。 |
类目 | 可调整类目文本的文字样式和偏移量 |
占比值 | 可控制占比数值的显隐及相关文本样式配置。 |
真实值 | 可控制真实数值的显隐及相关文本样式配置。 |
布局 | 支持调整图例列数、间距、位置和偏移。 |
3、饼图属性
饼图
配置项 | 说明 |
内外半径 | 饼图数据块的内外半径大小 |
等高 | 开启即可设置饼图数据块统一高度； 关闭则需设置饼图数据块最大高度。 |
*饼图 等高样式
当前值
配置项 | 说明 |
间距 | 可调节值与文本的间距 |
类目 | 可调整类目文本的文字样式和偏移量 |
占比 | 可调整占比数据的文字样式、小数位数和偏移量 |
真实值 | 可调整真实值的文字样式、偏移量和后缀内容 |
4、系列
当图表数据存在多类型展示需求时，组件默认将数据划分成多个系列，用户可通过对各系列数据进行自定义数据映射，从而完成对每个系列配置相应样式。
其中，数据系列操作支持：
：增加一个系列数据
：删除一个系列数据
：调整系列的显示格式（纵向展示、横向展示）
排序
支持按图例数据进行排序，包括数据返回顺序、从大到小、从小到大。
数据系列
配置项 | 说明 |
映射 | 映射中字段名对应数据中的系列字段，显示名是编辑页面中字段的变量名 |
颜色 | 改变指定系列的区域值颜色 |
*系列 - 数据映射 字段名和显示名
5、轮播动画
通过「开启」控制是否启用轮播动画。
配置项 | 说明 |
当前值 | 支持配置选中数据块的动画增长高度及透明度 |
间隔时长 | 设置轮播间隔时长 |
交互方式 | 提供三种交互方式：点击、悬停或无。当点击或悬停对应数据块时，将会停止轮播，且仅显示当前数据信息。 |
*交互方式 点击
*交互方式 悬停
二、数据
组件数据格式
字段 | 说明 |
s | 文本 |
value | 值 |
*组件数据格式说明
JSON数据案例
[
{
"s": "系列一",
"value": 800
},
{
"s": "系列二",
"value": 400
},
{
"s": "系列三",
"value": 200
},
{
"s": "系列四",
"value": 100
},
{
"s": "系列五",
"value": 50
}
]数据配置项说明
配置项 | 说明 |
数据源 | 数据源类型、数据源选择等 |
数据过滤器 | 勾选启用数据过滤器，单击添加过滤器，可在设置数据源页面中配置数据过滤器，详情请参见数据过滤器使用说明 |
数据响应结果 | 展示数据请求的响应结果 |
自动更新 | 选中后可以设置数据请求时间间隔 |
数据对接详情
数据对接详情请见以下文档👇
三、交互
当前组件可通过载入动画、回调参数、自定义事件进行交互配置。
载入动画
所有组件均提供移入、移入(小)、划变三种组件载入动画。
载入动画选择无时，则组件没有载入动画。
载入动画仅在可视化应用预览、发布组件加载时显示。
配置项 | 说明 |
渐隐渐显 | 渐显渐隐 动效 |
速率 | 匀速、慢快慢(cubic-bezier(0.25,0.1,0.25,1))、低速开始、低速结束、低速开始和结束(cubic-bezier(0.42,0,0.58,1)) |
方向 | 动画方向 |
持续时间 | 载入动画持续时间，单位为ms |
延时 | 载入动画延时长，单位为ms |
回调参数
回调参数即为全局性的参数变量，用于控制组件之间参数的传递，可通过设置回调参数来实现数据驱动交互。
其中，字段值即参数变量，变量名即对字段值的重命名。
详细的回调参数教学👉 回调的使用
自定义事件
自定义事件支持通过数据驱动组件状态、或变更组件样式配置，也可自定义编辑复杂的条件逻辑。
详细的自定义事件教学👉自定义事件教学
• 散点图
一、样式
在样式中可以设置组件的基本属性、全局、坐标轴、系列和提示框。
1、基本属性
位置尺寸
位置包括组件的横坐标和纵坐标，单位为px；横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。
尺寸包括组件的宽度和高度，单位为px；可单击比例锁锁定组件宽高比，等比例调整组件的宽高，比例锁默认不锁定。
*尺寸调整不影响组件内容显示、组件动画。
*组件位置尺寸说明
默认隐藏
勾选之后在初始加载时组件默认隐藏且关闭回调触发，通常用来配合显隐控制，如【选项卡】组件进行显隐切换。
2、全局
在全局中支持配置组件边距、外间距、图例、数据动画等样式。
边距
图表距离整个组件四边（上、下、左、右）的边距。
*边距样式说明
外间距
曲线与图表外围的间距，取值范围0-1。
*外间距说明
图例
在图例中可以调整组件的文本样式、图标尺寸、间距、布局、点击交互和未选中样式。
a. 文本样式
可对文本样式按需修改
b. 图标尺寸
自定义图例图标尺寸，散点图默认圆点。
c. 间距
用来调整图例图标与文字之间的间距。
d. 布局
在「布局」中支持进一步调整图例列数、间距、位置和偏移。
配置项 | 说明 |
列数 | 图例的列数 |
间距 | 图例之间的行距以及列距 |
位置 | 图例的展示位置 |
偏移 | 通过x轴和y轴控制偏移量 |
e.点击交互
开启「点击交互」后，可通过点击标签筛选并显示对应数据，关闭该功能后无法进行点击交互。
同时，可在「未选中样式」中配置透明度来区分未选中时的样式。
*点击交互 - 未选中样式
*点击交互 - 效果演示
数据动画
默认开启状态，首次加载兼数据变化时可显性展示出数据更新的过程。
*数据动画 - 效果演示
3、坐标轴
组件坐标轴分为x轴、y轴、z轴，可通过「启用」来控制是否开启某一轴的数据。
如下图所示，当取消开启x轴后可以看到x轴和x轴的相关配置项消失。
*启用x轴
X轴
通过「启用」控制X轴显隐，可通过轴标签、轴线、刻度和网格线进行坐标轴样式配置：
配置项 | 说明 |
轴标签 | X轴的轴标签，可调整格式、文本样式、展示方式和偏移量 |
轴线 | X轴的轴线颜色和粗细 |
刻度 | X轴的刻度线的颜色、粗细、长度 |
网格线 | X轴的网格线样式 |
其中，X轴标签分为类目型和时间型两个不同维度：
类目型：以类目为单位，标签名由数据源提供。
时间型：以时间为单位，如下图 👇
注：展示标签的数量会根据原标签数量进行整除后展示,如果输入的数量不能被整出，则会出现不能如期按照输入数量进行展示的情况。（因为组件本身逻辑，在处理标签显示时，会整除后按间距调整数量分布，如果不能整除，则无法正确分配间距）
例如原标签数量为12，则可展示3、4、6个（可被整除）标签的的展示等。如果想展示输入数量的标签也可启动轮播。
Y轴
通过「启用」控制Y轴显隐，可通过轴标签、轴单位、轴线、刻度和网格线进行坐标轴样式配置：
配置项 | 说明 |
轴标签 | Y轴轴标签配置，包括数据范围、刻度模式、文本样式、数据格式化、后缀内容和偏移量 |
轴单位 | Y轴轴标签的单位，可调整单位内容、偏移量和文字样式 |
轴线 | Y轴的轴线，支持修改颜色和粗细 |
刻度 | Y轴的刻度线，可调整刻度线的颜色、粗细、长度 |
网格线 | Y轴的网格线样式 |
其中，Y轴标签支持以下刻度配置：
「数值范围」支持自定义输入，也支持系统选择，置空时系统根据数据中的最大/小值和指标点的个数自动计算；
「标签刻度」支持开启「刻度自适应」或设置「数量强制」和「步长强制」，非自适应情况下可自定义编辑标签、步长数量及小数位数；
*轴标签 两种刻度模式
Z轴
通过「启用」控制Z轴显隐，可通过轴标签、轴单位、轴线、刻度和网格线进行坐标轴样式配置：
配置项 | 说明 |
轴标签 | Z轴轴标签配置，包括数据范围、刻度模式、文本样式、数据格式化、后缀内容和偏移量 |
轴单位 | Z轴轴标签的单位，可调整单位内容、偏移量和文字样式 |
轴线 | Z轴的轴线，支持修改颜色和粗细 |
刻度 | Z轴的刻度线，可调整刻度线的颜色、粗细、长度 |
网格线 | Z轴的网格线样式 |
注意：当数据映射基于Z轴时，需在「系列」中将纵轴选择切换至Z轴。
4、系列
当图表数据存在多类型展示需求时，组件默认将数据划分成多个系列，用户可通过对各系列数据进行自定义数据映射，从而完成对每个系列配置相应样式。
其中，数据系列操作支持：
：增加一个系列数据
：删除一个系列数据
：调整系列的显示格式（纵向展示、横向展示）
数据系列
配置项 | 说明 |
映射 | 映射中字段名对应数据中的系列字段，显示名是编辑页面中字段的变量名 |
纵轴选择 | 当有多个维度的数据需要展示时，支持对不同的系列选择不同轴向展示(前提：需同时开启Y、Z坐标轴)。 |
半径 | 改变指定系列的散点半径 |
填充 | 改变指定系列的散点颜色 |
边框 | 改变指定系列的散点边框颜色、粗细 |
*系列 - 数据映射 字段名和显示名
5、提示框
悬停触发
支持鼠标焦点移入到对应的数据点后会显示当前对应的数据提示框。
*悬停触发 提示框效果
提示框
提示框整体分为两部分，提示框样式和框内数据：
组成 | 说明 |
提示框样式 | 提示框的样式，支持调整提示框的背景、尺寸、边距和偏移量 |
框内数据 | 提示框内的数据，支持修改标签、行高、数据的文字样式 |
行高 | 提示框内每个数据值间的行高 |
*框内数据 对应样式配置
二、数据
组件数据格式
字段 | 说明 |
x | 类目，即x轴文本 |
y | 值，即y轴数值 |
s | 系列 |
*组件数据格式说明
JSON数据案例
[
{
"x": 146,
"y": 40,
"s": "系列一"
},
{
"x": 147,
"y": 45,
"s": "系列一"
},
{
"x": 148,
"y": 48,
"s": "系列一"
},
{
"x": 150,
"y": 60,
"s": "系列一"
},
{
"x": 153,
"y": 54,
"s": "系列一"
},
{
"x": 155,
"y": 58,
"s": "系列一"
},
{
"x": 160,
"y": 70,
"s": "系列一"
},
{
"x": 165,
"y": 60,
"s": "系列一"
},
{
"x": 167,
"y": 64,
"s": "系列一"
},
{
"x": 171,
"y": 58,
"s": "系列一"
},
{
"x": 173,
"y": 62,
"s": "系列一"
},
{
"x": 175,
"y": 60,
"s": "系列一"
},
{
"x": 177,
"y": 66,
"s": "系列一"
},
{
"x": 179,
"y": 82,
"s": "系列一"
},
{
"x": 182,
"y": 77,
"s": "系列一"
},
{
"x": 184,
"y": 76,
"s": "系列一"
},
{
"x": 186,
"y": 81,
"s": "系列一"
},
{
"x": 187,
"y": 80,
"s": "系列一"
},
{
"x": 188,
"y": 88,
"s": "系列一"
},
{
"x": 147,
"y": 56,
"s": "系列二"
},
{
"x": 151,
"y": 70,
"s": "系列二"
},
{
"x": 153,
"y": 64.5,
"s": "系列二"
},
{
"x": 159,
"y": 70,
"s": "系列二"
},
{
"x": 160,
"y": 80,
"s": "系列二"
},
{
"x": 167,
"y": 79,
"s": "系列二"
},
{
"x": 170,
"y": 78,
"s": "系列二"
},
{
"x": 172,
"y": 72,
"s": "系列二"
},
{
"x": 175,
"y": 72,
"s": "系列二"
},
{
"x": 176,
"y": 59,
"s": "系列二"
},
{
"x": 178,
"y": 69,
"s": "系列二"
},
{
"x": 180,
"y": 72,
"s": "系列二"
},
{
"x": 182,
"y": 62,
"s": "系列二"
},
{
"x": 182,
"y": 62,
"s": "系列二"
},
{
"x": 183,
"y": 66,
"s": "系列二"
},
{
"x": 185,
"y": 65,
"s": "系列二"
},
{
"x": 186,
"y": 69,
"s": "系列二"
},
{
"x": 187,
"y": 70,
"s": "系列二"
}
]数据配置项说明
配置项 | 说明 |
数据源 | 数据源类型、数据源选择等 |
数据过滤器 | 勾选启用数据过滤器，单击添加过滤器，可在设置数据源页面中配置数据过滤器，详情请参见数据过滤器使用说明 |
数据响应结果 | 展示数据请求的响应结果 |
自动更新 | 选中后可以设置数据请求时间间隔 |
数据对接详情
数据对接详情请见以下文档👇
三、交互
当前组件可通过载入动画、回调参数、自定义事件进行交互配置。
载入动画
所有组件均提供移入、移入(小)、划变三种组件载入动画。
载入动画选择无时，则组件没有载入动画。
载入动画仅在可视化应用预览、发布组件加载时显示。
配置项 | 说明 |
渐隐渐显 | 渐显渐隐 动效 |
速率 | 匀速、慢快慢(cubic-bezier(0.25,0.1,0.25,1))、低速开始、低速结束、低速开始和结束(cubic-bezier(0.42,0,0.58,1)) |
方向 | 动画方向 |
持续时间 | 载入动画持续时间，单位为ms |
延时 | 载入动画延时长，单位为ms |
回调参数
回调参数即为全局性的参数变量，用于控制组件之间参数的传递，可通过设置回调参数来实现数据驱动交互。
其中，字段值即参数变量，变量名即对字段值的重命名。
详细的回调参数教学👉 回调的使用
自定义事件
自定义事件支持通过数据驱动组件状态、或变更组件样式配置，也可自定义编辑复杂的条件逻辑。
详细的自定义事件教学👉自定义事件教学
如遇其他使用问题，可扫描下方二维码，获取更多产品支持~
