# 轮播饼图

轮播饼图是饼图的一种，与其他类别的饼图相比，轮播饼图支持以轮播的方式展示各类别的占比或数值，支持自定义展示百分比值或实际数值，支持自定义类别配置，能够更加形象智地在大屏中展示数据的占比或变化情况。

# 属性

# 基础

基本属性： 同组件管理 -> 属性 -> 基本属性
系列颜色： 扇区的颜色。可添加选择颜色显示，默认情况下图表扇区的颜色为主题的颜色。

# 系列

系列名称： 用于提示框的显示。
南丁格尔玫瑰图模式： 是否展示成南丁格尔图，通过半径区分数据大小。
- 是：南丁格尔玫瑰图。
- 否：普通饼图。
- 半径： 扇区圆心角展现数据的百分比，半径展现数据的大小。
- 面积： 所有扇区圆心角相同，仅通过半径展现数据大小。
选择模式： 是否支持多个选中。
圆心坐标： 饼图的中心(圆心)坐标。可为px和%。
饼图半径： 饼图的半径。
- 内半径： 内半径设为 0 将显示成实心饼图形。
- 外半径： 外圈半径。
- 起始角度： 开始角度。
- 最小角度： 最小的扇区角度，用于防止某个值过小导致扇区太小影响交互。
普通状态样式：
- 文本标签： 指轮播饼图图形上的文本标签，可用于说明图形的一些数据信息，例如值、名称等。
  - 显示： 是否显示文本。
  - 内容格式器： 标签内容格式器，支持字符串模板和回调函数两种形式，字符串模板与回调函数返回的字符串均支持用 \n 换行。
    
    字符串模板变量
    - {a} : 系列名。
    - {b} : 数据名。
    - {c} : 数据值。
    - {d}: 百分比。
    示例：
```
{b}: {d}
```
    回调函数
    
    可用参数为data。
    
    示例：
```
return data.name;
```
    参数 data是内容格式器需要的单个数据资源。格式如下：
```
{
    // 数据名，类目名
    name: string,
    // 传入的原始数据项
    data: Object,
    // 传入的数据值
    value: number|Array,
    // 百分比
    percent: number
}
```
  - 位置： 标签的位置。
  - 文字距离： 文本标签与引导线的距离。
  - 文字旋转： 文本标签旋转角度。
  - 文字偏移： 文本标签水平或垂直偏移量。
  - 文字行高： 文本标签单行高度。
  - 标签对齐： 文本标签对齐方式。4.4+
  - 文字边距： 文本标签与边框距离。
  - 水平对齐： 文本标签水平对齐方式。
  - 垂直对齐： 文本标签垂直对齐方式。
  - 宽高： 文本标签的宽度与高度。
  - 超出宽度： 文本标签超出宽度处理方式。
  - 字体颜色： 文本标签字体颜色。
  - 字体大小： 文本标签字体大小。
  - 字体粗细： 文本标签字体粗细。
  - 字体： 文本标签字体样式。
图形样式
- 渐变色： 是否添加渐变色。
- 是：
  - 渐变色方向： 渐变色的方向，可为正下到正上，左下到右上，右上到左下。
  - 渐变色范围设置： 设置渐变色的颜色范围。
- 否：
  - 颜色： 控制扇区的颜色。
- 描边颜色： 图形描边颜色。
- 描边线宽： 图形描边宽度。
- 描边类型： 图形描边类型。

高亮状态样式： 鼠标放到扇区上时高亮的扇区和样式。其属性配置与普通状态样式相同。

标签布局： 见组件管理 -> 属性 -> 标签布局。4.3+
数据映射： 同饼图属性 -> 系列 -> 数据映射。3.0+
初始动画： 对组件动画的配置。
- 开启动画： 组件是否启用动画。
- 动画时长(ms)： 动画的时长。
- 缓动效果： 动画的缓动效果。

# 数据

# 静态数据

饼图模式

上图中的示例JSON代码如下：

[
  {
    "x": "类型一",
    "y": 33
  },
  {
    "x": "类型二",
    "y": 12
  },
  {
    "x": "类型三",
    "y": 27
  },
  {
    "x": "类型四",
    "y": 23
  },
  {
    "x": "类型五",
    "y": 40
  }
]

x：维度，各扇形的类目。
y：度量，各扇形的值，决定各扇形占整个饼图的百分比。

轮播饼图中需要单维度、单度量的数据，所以横轴、纵轴中只解析拖入的第一个字段，多余字段在图表中不解析。

# 数据资源

饼图模式

警告：

拖动到纵轴的字段为度量---> 数值类型。即在数据资源--->维度/度量列表中格式化为整型或浮点型。

# 交互

# 扇区选中事件

勾选启用，开启扇区选中事件。当单击轮播饼图的扇区时，绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值，触发数据请求，查询相关数据，更新组件。具体配置请参考组件交互。

# 扇区悬停事件 3.0+

勾选启用，开启扇区选中事件。当悬停轮播饼图的扇区时，绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值，触发数据请求，查询相关数据，更新组件。具体配置请参考组件交互。

# 扇区移出事件 3.0+

勾选启用，开启扇区选中事件。当移出轮播饼图的扇区时，绑定字段中数据会推送到变量中。关联此变量的组件将携带此变量值，触发数据请求，查询相关数据，更新组件。具体配置请参考组件交互。

# 数据响应

轮播饼图支持数据响应配置。

# 数据上卷、下钻

轮播饼图支持数据上卷、下钻功能。

# 节点编程

# 事件

扇区选中事件： 扇区单击触发事件。
- 抛出的参数： 扇区所携带的数据。
图表配置转换完成后： 图表 Option 配置转换完成后事件。
- 抛出的参数： 配置完成后的 Option 。
扇区悬停事件： 鼠标悬停到扇区时触发。3.0+
- 抛出的参数： 扇区所携带的数据。
扇区移出事件： 鼠标移出扇区时触发。3.0+
- 抛出的参数： 扇区所携带的数据。
图例切换事件： 图表图例切换时触发。3.0+
- 抛出的参数： 切换的图例名称及选中状态。

# 动作

导入图表配置： 可导入 Echarts 图表 Option 配置。
- 接收的参数： 修改后的 Option 。

设置图例： 设置图例的选中状态。3.0+

  {
    "类型一": true,
    "类型二": false,
    "类型三": false
  }

← 嵌套饼图占比饼图 →