如何配置坐标轴

G2 的图表坐标轴配置方法如下:

chart.axis(dim, {
  title: null // 不展示标题
  // ...
});

参数 dim 为对应的数据维度。

坐标轴的组成

使用 G2 对坐标轴进行配置之前,需要了解 G2 的坐标轴的组成。

G2 生成的坐标轴由如下五部分组成:

  1. 标题 title
  2. 坐标轴线 line
  3. 文本 labels
  4. 刻度线 tickLine
  5. 网格 grid

image

通常的图表都有 x 轴和 y 轴,默认情况下,x 轴显示在图表的底部,y 轴显示在左侧(多个y轴时可以是显示在左右两侧)。通过为坐标轴配置 position 属性可以改变坐标轴的显示位置,具体可详见 api

1. 坐标轴标题 title

默认情况下,我们会为每条坐标轴生成标题,标题名默认为该轴对应数据字段的属性名。通过如下代码,用户可以配置标题的显示样式或者关闭标题显示。

chart.axis('xDim', {
  title: null // 不展示 xDim 对应坐标轴的标题
});

chart.axis('xDim', {
  title: {
    fontSize: '12', // 文本大小
    textAlign: 'center', // 文本对齐方式
    fill: '#999', // 文本颜色
    // ...
  }
});

当需要为坐标轴设置别名时,需要在列定义中为对应数据字段设置 alias 属性,如下所示,更多关于列定义的内容请查看列定义

chart.col('xDim', {
  alias: '这里设置标题的别名'
});

更多关于坐标轴 title 属性的配置请查看API文档相关内容 axis title

2. 坐标轴线 line

line 属性上进行坐标轴线的配置。

chart.axis('xDim', {
  line: {
    lineWidth: 2, // 设置线的宽度
    stroke: 'red', // 设置线的颜色
    lineDash: [3, 3] // 设置虚线
  }
});

上述代码效果如下图所示:

image

3. 坐标轴文本 labels

labels 的常用属性有:label、autoRotate。

(1) 不展示文本

chart.axis('xDim', {
  labels: null
});

(2) 配置文本显示样式

chart.axis('xDim', {
  labels: {
    autoRotate: true | false, // 文本是否允许自动旋转
    label: {
      textAlign: 'center', // 文本对齐方向,可取值为: left center right
      fill: '#404040', // 文本的颜色
      fontSize: '12', // 文本大小
      fontWeight: 'bold', // 文本粗细
      rotate: 30 // 文本旋转角度
    }
  }
});

(3)格式化坐标轴文本显示

formatter 属性定义回调函数,如下所示:

chart.axis('xDim', {
  // 使用 formatter 回调函数
  formatter: function(val) {
      return val + '元';
  }
});

在坐标轴上配置formatter仅在坐标轴上的文本有效,如果想要使得tooltip和图例上的信息也格式化掉,需要在列定义时指定格式化函数

chart.source(data, {
  xDim: {
    formatter: function(val) {
      return val + '元';
    }
  }
});

// 或者

chart.col('xDim', {
  formatter: function(val) {
      return val + '元';
  }
});

在线 demo

(4) 使用 html 自定义 label

在一些比较个性化的可视化需求里,通常会使用可视化隐喻,比如会使用人物照片来代替人物名字,使得可视化更直观,如下图所示:

这时可以通过为 labels 进行如下配置:

chart.axis('xDim', {
  labels: {
    custom: true, // 表示使用自定义 html 显示文本标签
    renderer: function(value){
      return '<img src="' +imageMap[value] + '" width="30px"/>';
    }
  }
});

完整代码

var data = [
  {"name":"John","vote":35654},
  {"name":"Damon","vote":65456},
  {"name":"Patrick","vote":45724},
  {"name":"Mark","vote":13654}
];
var imageMap = {
  'John': 'https://zos.alipayobjects.com/rmsportal/mYhpaYHyHhjYcQf.png',
  'Damon': 'https://zos.alipayobjects.com/rmsportal/JBxkqlzhrlkGlLW.png',
  'Patrick': 'https://zos.alipayobjects.com/rmsportal/zlkGnEMgOawcyeX.png',
  'Mark': 'https://zos.alipayobjects.com/rmsportal/KzCdIdkwsXdtWkg.png'
}

var chart = new G2.Chart({
  id : 'c2',
  width : 600,
  height : 250
});
chart.source(data, {
  vote: {
    min: 0
  }
});
chart.legend(false);
chart.axis('name', {
  title: null,
  labels: {
    custom: true,
    renderer: function(value){
      return '<img src="' +imageMap[value] + '" style="width:30px;"/>';
    }
  },
  tickLine: null
});
chart.interval().position('name*vote').color('name', ['#7f8da9', '#fec514', '#db4c3c', '#daf0fd']).size(20).label('name');
chart.render();

4. 坐标轴刻度线 tickLine

在 tickLine 上可以配置坐标轴刻度线的长短(value)、颜色(stroke)、粗细(lineWidth),或者控制它的展示(tickLine: null,不展示刻度线)。

chart.axis('xDim', {
  tickLine: {
    lineWidth: 2,
    value: 10,
    stroke: 'red'
  }
});
  • value 可以设置负值,使得tickLine的方向相反

image

5. 网格 grid

默认情况下,G2 会为 y 坐标轴生成网格线,而 x 轴不展示网格线。网格线相关的配置属性有 grid gridAlign,只要为坐标轴配置 grid 属性即可展示网格线。

grid 属性中配置网格显示的样式,如下代码所示:

chart.axis('xDim', {
  grid: {
    line: {
      stroke: '#d9d9d9',
      lineWidth: 1,
      lineDash: [4, 4]
    }
  }
});

gridAlign 属性用于设置栅格线同刻度线(tickLine)的对齐方式,可选择值如下:

chart.axis('xDim', {
  gridAlign: 'start' || 'middle'
});

其他配置

1. 设置坐标轴显示范围

每一种坐标轴范围的选择都会导致最后可视化结果的不同,坐标轴显示范围的设置需要在列定义中配置:

// 方式 1
chart.source(data, {
  xDim: {
    type: 'linear',
    min: 0,
    max: 1000
  }
});
// 方式 2
chart.col('xDim', {
  type: 'linear',
  min: 0,
  max: 1000
});

2. 设置坐标轴刻度线个数

默认的坐标轴刻度线个数是 5 个,通过列定义,用户可以自定义坐标轴刻度线的个数。

chart.source(data, {
  xDim: {
    type: 'timeCat', // 声明该数据的类型
    tickCount: 9
  }
});

3. 设置坐标轴刻度线间距

对于连续类型的数据,G2 还支持设置坐标轴刻度线的间距(tickInterval 属性),同样需要在列定义中进行配置,但是需要说明的是,tickInterval 为原始数据值的差值,并且 tickCounttickInterval 不可以同时声明。

chart.source(data, {
  xDim: {
    type: 'linear',
    tickInterval: 1000
  }
});

4. 坐标系两端保留一定的空白

对于分类数据的坐标轴两边默认会留下一定的空白,连续数据的坐标轴的两端没有空白刻度

坐标轴

是否两端有空白是列定义里面 range 属性决定的,分类列的 range 的默认值是 [1 / (count - 1), 1 - 1 / (count - 1)],可以修改这个值达到改变空白大小的目的

chart.source(data, {
  xDim: {
    type: 'cat',
    range: [0, 1]
  }
});

坐标轴在其他坐标系下的显示

不同的坐标系下坐标轴的显示不一样,默认的配置项也不同

  • 极坐标下的坐标轴上默认不显示title,栅格线有圆形和多边形两种
  • theta坐标系、map、helix 默认不显示坐标轴
  • polar 坐标系发生transpose时也不显示坐标轴

相关实例

1. 坐标轴标题设置别名

image

2. 个性化坐标轴显示样式

image

3. 格式化坐标轴文本显示

image