基本饼图
文档基于基本饼图v1.4.21版本
组件说明
基本饼图以饼状图的形式切割展示不同系列的数据，可设置不同系列数据展示颜色来区分数据之前的占比差别。
效果案例
*基本饼图 效果案例
一、样式
在样式中可以设置组件的基本属性、全局和饼图属性和系列。
1、基本属性
位置尺寸
位置包括组件的横坐标和纵坐标，单位为px；横坐标为组件左上角距离页面左边界的像素距离，纵坐标为组件左上角距离页面上边界的像素距离。
尺寸包括组件的宽度和高度，单位为px；可单击比例锁锁定组件宽高比，等比例调整组件的宽高，比例锁默认不锁定。
基本柱状图组件尺寸不影响组件内容显示、组件动画。
*组件位置尺寸说明
默认隐藏
勾选之后在初始加载时组件默认隐藏且关闭回调触发，通常用来配合显隐控制，如【选项卡】组件进行显隐切换。
2、全局
边距
基本柱状图表距离整个组件四边（上、下、左、右）的边距
*边距样式说明
数值标签
偏移距离 | 饼图外部标签偏移距离。 |
线长 | 饼图与饼图外部标签之间连接线线长度。 |
布局 | 标签布局方式，分为上下和水平两种方式。 |
偏移 | 饼图外部标签X轴和Y轴偏移距离。 |
类目 | 在类目中可设置类目数值标签字体样式，包括字体样式/字体大小/颜色/加粗/倾斜/字距/行距/文本溢出设置。 |
占比值 | 在占比值中可设置占比值数值标签字体样式，包括小数位数/字体样式/字体大小/颜色/加粗/倾斜/字距/行距。 |
真实值 | 开启真实值后，除了会显示占比值外还会显示系列真实值。在此可设置真实值后缀内容/字号和偏移量；在文本样式中可设置真实值字体样式/字体大小/颜色/加粗/倾斜/字距/行距。 |
图例
顺序 | 图例排列顺序，分数据返回顺序/从大到小/从小到达三种顺序，其中数据返回顺序是指按在数据中的顺序进行展示。 |
图标尺寸 | 图例图标尺寸，可设置宽度和高度。 |
间距 | 图例图标与图标对应数值的间距。 |
类目 | 即图例右侧“系列一系列二”系列配置，可设置体样式/字体大小/颜色/加粗/倾斜/字距/行距。 |
占比值 | 即图例右侧“系列一系列二”系列对应占比值配置，在占比值中可设置占比值数值标签字体样式，包括小数位数/字体样式/字体大小/颜色/加粗/倾斜/字距/行距。 颜色跟随：颜色是否跟随图例颜色 |
真实值 | 开启真实值后，除了会显示占比值外还会显示系列真实值。在此可设置真实值后缀内容/字号和偏移量；在文本样式中可设置真实值字体样式/字体大小/颜色/加粗/倾斜/字距/行距。 |
布局 | 图例的布局样式，可设置图例列数、图例间距、图例位置和图例整体偏移量。 |
3、饼图属性
图形
用来设置饼图样式。
半径：饼图半径。
类玫瑰图：开启后，饼图整体将会以玫瑰图形式展现。
角度
在此项可设置饼图起始和结束角度，如下图所示起始角度设置为71，结束角度设置为305。
如开启反向则会反向展示。
*角度配置说明
描边
饼图间系列和整体范围描边样式。
宽度：描边线条的宽度。
颜色：描边线条颜色。
4、系列
首先说明顺序：顺序即为按在数据中设定的顺序展示系列值，可选择按照数据返回顺序、从大到小和从小到大。
基本饼图用系列代表不同维度数据，点击
即可增加一个维度数据，
即可删除一个系列数据。
增加一个系列后进行如下配置：
映射 | 字段名和显示名之间的映射。 |
颜色 | 对应系列显示颜色。 |
5、提示框
悬停触发
鼠标悬浮到对应系列上时，显示提示框。
提示框
字段 | 说明 |
提示框样式 | 柱状图的提示框，支持调整提示框的背景、尺寸、边距和偏移量 |
行高 | 每个数据值间的行高 |
框内数据 | 提示框内的数据，支持修改X轴标签、数据名称、数据值的文字样式 |
背景 | 可以上传图片设置提示框的背景 |
二、数据
组件数据格式
字段 | 说明 |
s | 类目 |
y | 值 |
JSON数据案例
[
{
"s": "系列一",
"y": 67
},
{
"s": "系列二",
"y": 34
},
{
"s": "系列三",
"y": 18
},
{
"s": "系列四",
"y": 9
},
{
"s": "系列五",
"y": 6
}
]数据配置项说明
配置项 | 说明 |
数据源 | 数据源类型、数据源选择等 |
数据过滤器 | 勾选启用数据过滤器，单击添加过滤器，可在设置数据源页面中配置数据过滤器，详情请参见数据过滤器使用说明 |
数据响应结果 | 展示数据请求的响应结果 |
自动更新 | 选中后可以设置数据请求时间间隔 |
数据对接详情
数据对接详情请见以下文档👇
三、交互
载入动画
所有组件均提供移入、移入(小)、划变三种组件载入动画。
载入动画选择无时，则组件没有载入动画。
载入动画仅在可视化应用预览、发布组件加载时显示。
载入动画配置项：
配置项 | 说明 |
渐隐渐显 | 启用是 |
速率 | 匀速、慢快慢(cubic-bezier(0.25,0.1,0.25,1))、低速开始、低速结束、低速开始和结束(cubic-bezier(0.42,0,0.58,1)) |
方向 | 动画方向 |
持续时间 | 载入动画持续时间，单位为ms |
延时 | 载入动画延时长，单位为ms |
回调参数
回调参数即为全局性的参数变量，用于控制组件之间参数的传递，可通过设置回调参数来实现数据驱动交互。
其中，字段值即参数变量，变量名即对字段值的重命名。
详细的回调参数教学👉 回调的使用
自定义事件
自定义事件为「交互事件」的增强模块，支持通过数据驱动组件状态、或变更组件样式配置，也可自定义编辑复杂的条件逻辑；
详细的自定义事件教学👉自定义事件教学
欢迎您在评论区留下您对该组件的意见，管理员会及时回复您，如长时间未回复欢迎您搜索钉钉群：33782396或者扫描以下二维码添加微信群 说出您的想法，采纳后将送出定制礼品。
也可以通过问卷来向我们反馈需求：https://jinshuju.net/f/XyCXU0