# 风向玫瑰图

风向玫瑰图也叫风向频率玫瑰图,它是根据某一地区多年平均统计的各个风向和风速的百分数值,并按一定比例绘制,一般多用 8 个或 16 个罗盘方位表示,由于形状酷似玫瑰花朵而得名。

# 属性

# 基础

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

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

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

  • 旋转角度: 组件的旋转角度。

  • 透明度: 组件的透明度。

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

  • 系列颜色: 扇形的颜色。支持颜色填充,默认情况下扇形的颜色为主题的颜色。

    系列颜色

# 系列

风向玫瑰图为单维度,多量度的图表,因此需要分别设置每个系列下的柱子属性。

  • 系列 1:

  • 类型: 柱状和折线的转换。

  • 堆叠名: 系列中堆叠名称相同者堆叠在一起。

  • 顺序: 控制图形的层级顺序。值小的图形会被值大的图形覆盖。

  • 柱设置: 该系列下柱子的颜色、边框设置,支持颜色填充和渐变填充两种方式。

    • 宽度: 柱子宽度,左右滑动或者输入值改变宽度,可为px%

    • 最小高度: 柱子的最小高度,可用于防止某数据项的值过小而影响交互。

    • 不同类目间距: 不同类目柱间距离,此属性应设置于坐标系中最后一个 bar 系列上才会生效,并且是对此坐标系中所有 bar 系列生效。

    • 同类目间距: 同类目柱间距离,此属性应设置于坐标系中最后一个 bar 系列上才会生效,并且是对此坐标系中所有 bar 系列生效。

    • 渐变色: 是否添加渐变色。

    • 是:

      • 渐变色方向: 渐变色的方向,可为正下到正上左下到右上右上到左下

      • 渐变色范围设置: 设置渐变色的颜色范围。

    • 否:

      • 颜色: 控制柱的颜色。
    • 描边颜色: 图形描边颜色。

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

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

    • 左上圆角: 左上圆角的弧度。

    • 右上圆角: 右上圆角的弧度。

    • 右下圆角: 右下圆角的弧度。

    • 左下圆角: 左下圆角的弧度。

  • 柱背景

    • 显示柱背景: 是否显示柱背景。

    • 渐变色: 柱背景的颜色是否渐变。

    • 是:

      • 渐变色方向: 渐变色的方向,可为正下到正上左下到右上右上到左下

      • 渐变色范围设置: 设置渐变色的颜色范围。

    • 否:

      • 颜色: 控制柱背景的颜色。
    • 描边颜色: 柱背景描边的颜色。

    • 描边线宽: 柱背景描边线的宽度。

    • 描边类型: 柱背景描边线的类型,可为实线虚线点线

  • 初始动画: 对组件动画的配置。

    • 开启动画: 组件是否启用动画。

    • 动画时长(ms): 动画的时长。

    • 缓动效果: 动画的缓动效果。

  • 折线设置: 该系列下折线的设置。

    • 平滑曲线: 折线是否为平滑曲线。

    • 线颜色: 折线的颜色。

    • 宽度: 折线的宽度。

    • 类型: 折线的类型。

  • 折线样式: 该系列下折线样式的设置。

    • 渐变色: 是否添加渐变色。

    • 是:

      • 渐变色方向: 渐变色的方向,可为正下到正上左下到右上右上到左下

      • 渐变色范围设置: 设置渐变色的颜色范围。

    • 否:

      • 颜色: 控制柱的颜色。
    • 拐点图形: 折线拐点处的图形。

    • 拐点大小: 折线拐点的大小。

    • 拐点描边: 折线拐点的描边颜色。

    • 描边线宽: 折线拐点的描边线宽。

    • 描边类型: 折线拐点的描边类型。

  • 文本标签: 指折线拐点处上的文本标签,可用于说明图形的一些数据信息,例如值、名称等。

    • 显示: 是否显示文本。

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

      字符串模板变量

      • {a} : 系列名。

      • {b} : 数据名。

      • {c} : 数据值。

        例如:

        {b}: {c}
        

      回调函数

      可用参数为data

      示例:

      return data.name;
      

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

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

    • 字体颜色: 修改字体的颜色。

    • 字体大小: 修改字体的大小。

    • 字体粗细: 修改字体的粗细,可为普通加粗更细,默认为普通

    • 字体: 修改字体的样式。

  • 初始动画: 对组件动画的配置。

    • 开启动画: 组件是否启用动画。

    • 动画时长(ms): 动画的时长。

    • 缓动效果: 动画的缓动效果。

  • 系列 2:系列 2 为另一条柱子的系列设置,配置与系列 1相同。

  • 系列 3:系列 3 为另一条柱子的系列设置,配置与系列 1相同。

# 角度轴

  • 顺时针: 是否顺时针。

  • 起始角度: 图形的起始角度。

  • 标签: 是否显示标签。

    内容格式器: 刻度标签的内容格式器,支持字符串模板和回调函数两种形式。

    字符串模板: 模板变量为{value}

    {value}kg
    
    • 回调函数

      可用参数:

      • data: 刻度默认文本。
      • index: 刻度索引。
      return data;
      
    • 距离轴线: 距离轴线的距离。

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

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

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

    • 字体: 标签字体样式。

    系列颜色

  • 轴线: 是否显示轴线。

    • 颜色: 轴线颜色。

    • 宽度: 轴线宽度。

    • 类型: 轴线类型。

  • 刻度: 是否显示刻度。

  • 刻度线和标签对齐: 是否要对齐。

  • 刻度线颜色: 刻度线的颜色。

  • 刻度线宽度: 刻度线的宽度。

  • 分割线: 是否显示分割线。
  • 颜色: 分割线颜色。

  • 宽度: 分割线宽度。

  • 类型: 分割线类型。

    系列颜色

# 径向轴

  • 径向轴名称: 径向轴名称。

  • 径向轴名称位置: 径向轴的名称位置。

  • 文本样式:

    • 字体颜色: 字体颜色。

    • 字体大小: 字体大小。

    • 字体粗细: 字体粗细。

    • 字体: 字体样式。

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

    • 显示: 是否显示标签。

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

        字符串模板变量

        • {a} : 系列名。

        • {b} : 数据名。

        • {c} : 数据值。

          例如:

          {b}: {c}
          

        回调函数

        可用参数为data

        示例:

        return data.name;
        

        参数 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代码如下:

[
  {
    "x": "一月",
    "y1": 1,
    "y2": 2,
    "y3": 1
  },
  {
    "x": "二月",
    "y1": 2,
    "y2": 4,
    "y3": 2
  },
  {
    "x": "三月",
    "y1": 3,
    "y2": 6,
    "y3": 3
  },
  {
    "x": "四月",
    "y1": 4,
    "y2": 1,
    "y3": 4
  },
  {
    "x": "五月",
    "y1": 3,
    "y2": 3,
    "y3": 1
  },
  {
    "x": "六月",
    "y1": 5,
    "y2": 2,
    "y3": 2
  },
  {
    "x": "七月",
    "y1": 1,
    "y2": 1,
    "y3": 5
  }
]
  • x: 维度,各柱的类目。

  • y1: 量度,系列 1 柱的值。

  • y2: 量度,系列 2 柱的值。

  • y3: 量度,系列 3 柱的值。

# 数据资源

饼图模式

# 交互

# 柱图单击交互事件

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

# 数据响应

风向玫瑰图支持数据响应配置。

# 数据上卷,下钻

风向玫瑰图支持数据上卷,下钻配置。

# 节点编程

# 事件

  • 柱图点击事件: 柱子单击触发事件。

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

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

# 动作

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

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