# 占比饼图

占比饼图是饼图的一种,与基本饼图相比,占比饼图能够同时展示数据中一个或多个类目的预期目标和当前进度的真实值,以及当前进度占预期目标的百分比值。

# 属性

# 基础

  • 组件标题: 用于在图层中显示组件的名称。1.1+

  • 组件尺寸: 组件的宽度和高度,单位为px

  • 组件位置: 组件在大屏中的位置,通过横纵坐标来定义,单位为px

  • 背景颜色: 组件的背景颜色。

  • 系列颜色: 类目扇区的颜色。可添加选择颜色显示,默认情况下类目扇区的颜色为主题的颜色。

    系列颜色

# 系列

  • 阴影长度: 组件的阴影长度。

  • 阴影颜色: 组件的阴影颜色。

  • 宽度: 类目扇区的宽度。

  • 间隔: 类目扇区间的间隔。

  • 圆心坐标: 饼图的中心(圆心)坐标。可为px%

  • 饼图半径:

    • 顺时针: 是否开启顺时针。

    • 起始角度: 开始角度。

    • 最小角度: 最小的扇区角度,用于防止某个值过小导致扇区太小影响交互。

  • 普通状态样式:

    • 文本标签: 指占比饼图图形上的文本标签,可用于说明图形的一些数据信息,例如值、名称等。

      • 显示文本: 是否显示文本。

      • 内容格式器: 标签内容格式器,支持字符串模板和回调函数两种形式,字符串模板与回调函数返回的字符串均支持用 \n 换行。

        字符串模板变量

        • {a} : 系列名。

        • {b} : 数据名。

        • {c} : 数据值。

        • {d}: 百分比。

        示例:

        {b}: {d}
        

        回调函数

        可用参数为data。若想显示百分比,可在data.data.dataset中获取。

        示例:

        return data.name+':'+data.data.dataset.percent+"%"
        

        参数 data是 内容格式器需要的单个数据集。格式如下:

        {
            // 数据名,类目名
            name: string,
            // 传入的原始数据项
            data: Object,
            // 传入的数据值
            value: number|Array,
            // 百分比
            percent: number
        }
        
      • 位置: 标签的位置。

      • 引导线第一段: 引导线第一段长度。

      • 引导线第二段: 引导线第二段长度。

      • 字体颜色: 文本标签字体颜色。

      • 字体大小: 文本标签字体大小。

      • 字体粗细: 文本标签字体粗细。

      • 字体: 文本标签字体样式。

      系列颜色

  • 图形样式

    • 渐变色: 是否开启渐变色。

    • 起始颜色: 渐变色方向起始颜色。

    • 末端颜色: 渐变色方向末端颜色。

    • 渐变色方向: 渐变色方向。

    • 颜色: 图形整体颜色。

    • 描边颜色: 图形描边颜色。

    • 描边线宽: 图形描边宽度。

    • 描边类型: 图形描边类型。

    系列颜色

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

# 标题

系列颜色

  • 显示标题: 是否显示标题

  • 内容:

    • 标题

      • 主: 主标题内容。

      • 副: 副标题内容。

    • 超链接

      • 主: 主标题超链接。

      • 副: 副标题超链接。

  • 位置

    • 水平对齐

    • 垂直对齐

  • 外观

    • 内边距

    • 主副间隔

  • 主标题文本样式

    • 字体颜色: 主标题字体颜色。

    • 字体大小: 主标题字体大小。

    • 字体粗细: 主标题字体粗细。

    • 字体: 主标题字体样式。

  • 副标题文本样式

    • 字体颜色: 副标题字体颜色。

    • 字体大小: 副标题字体大小。

    • 字体粗细: 副标题字体粗细。

    • 字体: 副标题字体样式。

# 图形元素

系列颜色

  • 离左侧距离: 图形元素离左侧的距离。

  • 离上侧距离: 图形元素离上侧的距离。

  • 文字样式

    • 字体颜色: 图形元素字体颜色。

    • 字体大小: 图形元素字体大小。

    • 字体粗细: 图形元素字体粗细。

    • 字体: 图形元素字体样式。

# 图例

系列颜色

  • 显示图例: 是否显示图例。

  • 选中模式: 图例选择的模式,控制是否可以通过点击图例改变系列的显示状态。

  • 内容格式器: 用来格式化图例文本,支持字符串模板和回调函数两种形式。

    • 字符串模板: {name}

    • 回调函数:

      return data;
      
  • 位置

    • 排列方式: 图例列表的布局朝向。

    • 水平位置: 水平排列。

    • 垂直位置: 垂直排列。

  • 文字样式

    • 字体颜色: 图例字体颜色。

    • 字体大小: 图例字体大小。

    • 字体粗细: 图例字体粗细。

    • 字体: 图例字体样式。

# 提示框

系列颜色

  • 显示提示框: 是否显示提示框。

  • 提示模板 :提示框浮层内容格式器,支持字符串模板和回调函数两种形式。

    • 字符串模板

      模板变量有 {a}, {b}{c}{d}{e},分别表示系列名,数据名,数据值等。 在触发点坐标轴的时候,会有多个系列的数据,此时可以通过 {a0}, {a1}, {a2} 这种后面加索引的方式表示系列的索引。 不同图表类型下的 {a}{b}{c}{d} 含义不一样。 其中变量{a}, {b}, {c}, {d}在不同图表类型下代表数据含义为:

      • 折线(区域)图、柱状(条形)图、K 线图 : {a}(系列名称),{b}(类目值),{c}(数值), {d}(无)
      • 散点图(气泡)图 : {a}(系列名称),{b}(数据名称),{c}(数值数组), {d}(无)
      • 地图 : {a}(系列名称),{b}(区域名称),{c}(合并数值), {d}(无)
      • 饼图、仪表盘、漏斗图: {a}(系列名称),{b}(数据项名称),{c}(数值), {d}(百分比)
    • 回调函数

      return data;
      
  • 触发点:

    • 坐标轴: 坐标轴触发,主要在柱状图,折线图等会使用类目轴的图表中使用。

    • 数据项: 数据项图形触发,主要在散点图,饼图等无类目轴的图表中使用。

  • 提示外观

    • 背景颜色: 提示框浮层的背景颜色。

    • 边框颜色: 提示框浮层的边框颜色。

    • 边框宽度: 提示框浮层的边框宽。

    • 内边距: 提示框浮层内边距

  • 文本样式

    • 字体颜色: 提示框字体颜色。

    • 字体大小: 提示框字体大小。

    • 字体粗细: 提示框字体粗细。

    • 字体: 提示框字体样式。

# 工具栏

系列颜色

  • 显示工具栏: 是否显示工具栏。

  • 功能按钮

    • 保存为图片按钮

    • 还原按钮

    • 数据视图按钮

  • 位置朝向

    • 排列方式: 功能按钮的布局朝向。

    • 水平位置: 水平排列。

    • 垂直位置: 垂直排列。

  • 图标尺寸

    • 图标大小

    • 间隔

# 数据

# 静态数据

系列颜色

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

    {
        "name": "一月",
        "value": 74
    },
    {
        "name": "二月",
        "value": 40
    },
    {
        "name": "三月",
        "value": 25
    }
]

  • name: 维度,各类目扇形的名称。
  • value: 量度,各类目扇形的值,决定各类目扇形占总数据的百分比。

占比饼图中支持单维度、单量度也可以双量度的数据,所以横轴中只解析拖入的第一个字段,多余字段在图表中不解析。纵轴中只解析拖入的第一、第二个字段,多余字段在图表中不解析。

提示

当数据为单量度时,占比饼图的目标总值为数据总值。当数据为双量度时,占比饼图的目标总值为第二个字段的值。

# 数据资源

系列颜色

提示:

使用数据资源后,若图表里的数据没有全部显示,请前往系列-间隔中调整类目扇区的间隔,直到数据全部显示。

警告:

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

# 交互

# 扇区选中事件

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

# 数据响应

占比饼图支持数据响应配置。

# 数据上卷、下钻

占比饼图支持数据上卷、下钻功能。

# 节点编程

# 事件

  • 扇区选中事件: 扇区单击触发事件。

    • 抛出的参数: 扇区所携带的数据。
  • 图表配置转换完成后: 图表 Option 配置转换完成后事件。

    • 抛出的参数: 配置完成后的 Option 。

# 动作

  • 导入图表配置: 可导入 Echarts 图表 Option 配置。

    • 接收的参数: 修改后的 Option 。