快速上手

阅读时间约 2 分钟

声明式

F2 4.0 开始,我们将以声明式编写图表,声明式可以让你的代码更直观和简介,避免了复杂的 API 调用,而且我们也采用了 JSX 语法,不仅方便使用,还可以很方便地和 React、Vue 这些框架结合

组件化

为了构建复杂的可视化图表,组件是一种不可或缺的能力,在 F2 里,我们也参考 React 的设计模式,内置了一套完善的组件能力,能简单方便地分装自己的组件

快速开始

下面示例是以非 React 为演示的,如果项目已经是 React, 可以参考 如何在 React 中使用

配置 jsx transform

可见详细介绍:配置 jsx transform

安装

通过 npm 安装

npm install @antv/f2 --save

一分钟上手

1. 创建 canvas 标签

在页面上创建一个 <canvas>

<canvas id="myChart" width="400" height="260"></canvas>

2. 编写代码

// F2 对数据源格式的要求,仅仅是 JSON 数组,数组的每个元素是一个标准 JSON 对象。
const data = [
  { genre: 'Sports', sold: 275 },
  { genre: 'Strategy', sold: 115 },
  { genre: 'Action', sold: 120 },
  { genre: 'Shooter', sold: 350 },
  { genre: 'Other', sold: 150 },
];

// 获取 canvas context
const context = document.getElementById('myChart').getContext('2d');
const { props } = (
  <Canvas context={context} pixelRatio={window.devicePixelRatio}>
    <Chart data={data}>
      <Axis field="genre" />
      <Axis field="sold" />
      <Interval x="genre" y="sold" color="genre" />
      <Tooltip />
    </Chart>
  </Canvas>
);

const canvas = new Canvas(props);
canvas.render();

完成上述两步之后,保存文件并用浏览器打开,一张柱状图就绘制成功了:

更多示例

更多的示例直接查看 Demo