基础饼图是移动组件中饼图的一种,支持图表内外多弧形扇区的标签展示,支持自定义多系列数据配置,能够清晰智能地展示各类别在环圈内的占比情况。本文介绍基础饼图各配置项的含义。

配置

  • 搜索配置:单击配置面板右上角的搜索配置,可在搜索配置对话框中输入您需要搜索的配置项名称,快速定位到该配置项,系统支持模糊匹配。详情请参见搜索组件配置
  • 图表图表面板
    • 自定义边距:饼图区域与组件上下左右四个边界之间的距离,单位默认px,可单击眼睛图标图标控制自定义边距的显隐。
    • 图例:基础饼图的图例样式,可单击眼睛图标图标控制图例的显隐。
      参数 说明
      点击过滤 打开开关,可在组件配置了多系列数据时,在组件预览或发布状态下使用移动端设备,单击组件内的某个系列的图例,即可切换当前系列为选中或者不选中状态,从而在可视化应用内过滤展示不同系列的数据;关闭开关,无法过滤切换展示不同系列数据,所有系列的图例数据同时显示。
      未选择颜色 未被选中状态时候的各系列的图例颜色。
      布局 图例的布局样式,可调整图例布局的位置和对齐方式。
      标记形状 图例的标记形状样式,可选圆形方形
      文本 图例的文本样式。
      • 字号:图例文本的大小。
      • 文字粗细:图例文字的粗细。
      • 颜色:图例文本的颜色。
      • 对齐方式:图例文本的对齐方式,可选居中对齐左对齐右对齐三种样式。
  • 坐标轴:组件坐标轴包括径向轴角度轴两种。 基础饼图
    • 径向轴
      半径
      参数 说明
      外半径 圆环最外侧到轴中心的距离,取值为所占组件高度的比例,取值范围为0~1。
      内半径 圆环最内侧到轴中心的距离,取值为所占组件高度的比例,取值范围为0~1。
    • 角度轴

      角度:组件起始角度和结束角度的值。

  • 扇区扇区面板
    • 扇区:单击右侧的加号图标垃圾桶图标图标,添加或删除一个扇区数据系列,单击右侧的横向排列图标竖向排列图标图标配置多个扇区的排列样式。
    • 扇区样式:此扇区下饼图的颜色。
  • 其他其他面板
    • 缓动动画:图表的动画效果样式,可单击眼睛图标图标开启或关闭动画效果。
      参数 说明
      缓动效果 动画的缓动效果,系统提供多种常见的动画缓动效果供您选择。
      入场动画时长 组件第一次渲染动画的时长,单位为ms。
      更新动画时长 组件数据更新时动画持续的时间,单位为ms。
    • 提示框:在预览或发布页面,鼠标悬浮或单击扇区时出现的提示框的样式。可单击眼睛图标图标开启或关闭提示框效果。提示框样式
      参数 说明
      显示名称 打开开关,提示框显示当前扇区的名称;关闭开关,提示框不显示扇区的名称。
      显示百分比 打开开关,提示框显示当前扇区的百分比值;关闭开关,提示框不显示扇区的百分比值。
      引导线 提示框引导线的样式。
      • 长度:引导线的长度值,取值范围0~1。
      • 宽度:引导线的宽度大小。
      • 颜色:引导线的颜色。
      文本 提示框内文本的字号大小和颜色。

数据

基础饼图数据面板上图中的示例JSON代码如下。
[
  {
    "name": "芳华",
    "value": 0.4
  },
  {
    "name": "妖猫传",
    "value": 0.2
  },
  {
    "name": "机器之血",
    "value": 0.18
  },
  {
    "name": "心理罪",
    "value": 0.15
  },
  {
    "name": "寻梦环游记",
    "value": 0.05
  },
  {
    "name": "其他",
    "value": 0.02
  }
]
表 1. 字段说明
字段 说明
name 各扇区的类别名称。
value 各扇区的值,决定各扇区块占整个基础饼图的百分比。
表 2. 配置项说明
配置项 说明
受控模式 打开开关,组件初始化状态下不请求数据,仅通过回调ID或蓝图编辑器配置的方法发起请求数据;关闭开关,可以使用自动更新请求数据。
自动更新请求 选中后可以设置动态轮询,还可以手动输入轮询的时间频次。清除后则不会自动更新,需要手动刷新页面,或通过蓝图编辑器和回调ID事件来触发请求更新数据。
数据源 单击配置数据源,可在设置数据源页面中修改数据源类型和数据查询代码、预览数据源返回结果以及查看数据响应结果。详情请参见配置组件数据
数据过滤器 单击添加过滤器,可在设置数据源页面中配置数据过滤器,详情请参见组件过滤器使用说明
数据响应结果 展示数据请求的响应结果。当数据源发生改变时,可单击右侧的刷新图标 图标,实时查看数据响应结果。

交互

选中启用,开启组件交互功能。当单击基础饼图的扇区块时,会触发数据请求,抛出回调值,动态加载不同扇区的数据。默认抛出数据中的namevalue值,具体配置请参见组件回调ID配置

蓝图编辑器交互配置

  1. 在移动端画布编辑器页面,右键单击图层栏内组件,选择导出到蓝图编辑器
  2. 单击页面左上角的蓝图图标图标。
  3. 在蓝图编辑器配置页面,单击导入节点栏内的基础饼图组件,在画布中可以看到如下图所示的基础饼图的蓝图编辑器配置参数。基础饼图蓝图参数
    • 事件
      事件 说明
      当基础饼图接口描述请求完成时 数据接口请求完成时返回并经过过滤器处理后抛出的事件,同时抛出处理后的JSON格式的数据。具体数据请参见上文的数据示例
      当基础饼图接口描述请求失败时 数据接口请求失败时(请求失败的情况可能是:网络问题或接口报错等)返回并经过过滤器处理后抛出的事件,同时抛出处理后的JSON格式的数据。具体数据请参见上文的数据示例
      当点击数据项时 当单击饼图的扇区块时抛出的事件,同时抛出该扇区对应的数据项。
    • 动作
      动作 说明
      请求基础饼图接口描述 重新请求服务端数据,上游数据处理节点或图层节点抛出的数据将作为参数。例如基础饼图配置了API数据源为http://api.test,传到请求基础饼图接口描述动作的数据为{ id: '1'},则最终请求接口为http://api.test?id=1
      导入基础饼图接口描述 按组件绘制格式处理数据后,导入组件,重新绘制。不需要重新请求服务端数据。具体数据请参见上文的数据示例