快速上手

五分钟上手 G2

获取 G2

<script> 标签引入的方式。

  1. 你可以下载 JS 文件 点此下载 到本地，然后通过 <script> 标签引入到页面上。

  2. 也可以直接引入 cdn 上的文件：

<script src="https://a.alipayobjects.com/g/datavis/g2/2.2.1/g2.js"></script>

npm install

npm install g2
// usage
var G2 = require('g2');

引入 G2

G2 的引入方式很简单，只需要像普通的 JavaScript 库一样用 script 标签引入即可。

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <!-- 引入 G2 文件 -->
    <script src="https://a.alipayobjects.com/g/datavis/g2/2.2.1/g2.js"></script>
  </head>
  <body></body>
</html>

创建图表容器

标注 DOM 容器上的 ID，用于绘制图表。

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

绘制图表

完成以上简单的两步之后，就可以进行简单的图表绘制：

  1. 创建 Chart 图表，指定图表所在的容器 ID、指定图表的宽高、边距等信息；
  2. 载入图表数据源；
  3. 使用图形语法进行图表的绘制；
  4. 渲染图表。

完整的代码如下：

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <title>柱状图</title>
    <!-- 引入 G2 文件 -->
    <script src="https://a.alipayobjects.com/g/datavis/g2/2.2.1/g2.js"></script>
  </head>
  <body>
    <!-- 创建图表容器 -->
    <div id="c1"></div>
    <script>
      var data = [
        {genre: 'Sports', sold: 275},
        {genre: 'Strategy', sold: 115},
        {genre: 'Action', sold: 120},
        {genre: 'Shooter', sold: 350},
        {genre: 'Other', sold: 150},
      ]; // G2 对数据源格式的要求，仅仅是 JSON 数组，数组的每个元素是一个标准 JSON 对象。
      // Step 1: 创建 Chart 对象
      var chart = new G2.Chart({
        id: 'c1', // 指定图表容器 ID
        width : 800, // 指定图表宽度
        height : 400 // 指定图表高度
      });
      // Step 2: 载入数据源
      chart.source(data, {
        genre: {
          alias: '游戏种类' // 列定义，定义该属性显示的别名
        },
        sold: {
          alias: '销售量'
        }
      });
      // Step 3：创建图形语法，绘制柱状图，由 genre 和 sold 两个属性决定图形位置，genre 映射至 x 轴，sold 映射至 y 轴
      chart.interval().position('genre*sold').color('genre')
      // Step 4: 渲染图表
      chart.render();
    </script>
  </body>
</html>

这样就可以绘制出一张漂亮的柱状图了，如下图所示：

想要了解 G2 更多的细节，请查看 G2 的教程。