本节主要讲解如何创建以及配置 Chart 图表对象,主要内容包括图表容器全局样式配置、绘图区、图表宽度自适应等相关内容。


图表容器


<div id="c1"></div>


实例化 Chart 对象时,绑定 dom 容器的方式有两种:


1. 传入 dom 容器的 id


const chart = new G2.Chart({
  container: 'c1',
  width: 1000,
  height: 500
});


2. 传入 dom 容器的 html 节点对象


const chart = new G2.Chart({
  container: document.getElementById('c1'),
  width: 1000,
  height: 500
});


注:为了兼容 G2 3.0 之前的版本,也可使用 id 属性代替 container,用法相同。


图表样式


1. 图表的宽高


创建 chart 对象时,需要指定图表的宽高,通过如下方式指定:


const chart = new G2.Chart({
  container: 'c1',
  width: 1000,
  height: 500
});


2. 图表的样式


图表样式包括画布背景、绘图区域背景以及内边框,分别对应如下属性:



用法如下,具体详见 API 文档:


const chart = new G2.Chart({
  container: 'c1',
  width: 1000,
  height: 500,
  padding: [ 20, 20, 95, 80 ] // 上,右,下,左
});


下图展示了 G2 的图表布局:


其他配置


图表宽度自适应


默认情况下,G2 图表的宽度需要用户手动设置 width 参数,当需要图表跟随图表容器宽度变化时,则需要开启 forceFit 属性,默认其值为  false,开启方式如下:


const chart = new G2.Chart({
  container: 'c1',
  forceFit: true,
  height : 400
});


此时,不需要设置 width 属性,即使设置了也不会生效。


另外还可以手动得调用自适应函数 chart.forceFit() 来响应页面变化。


chart.forceFit(); // 手动调用自适应函数


注意


图表动画


默认情况下,G2 的图表动画处于开启状态,可以通过如下两种方式关闭图表动画:


// 方式一: 设置 animate 属性
const chart = new G2.Chart({
  container: 'c1',
  width: 800,
  height : 400,
  animate: false // 关闭图表动画
});

// 方式二: 手动调用 animate 函数
chart.animate(false); // 关闭动画


单个几何标记(折线、面积图)的动画可以在 Geom 上设置