F2 快速上手

    1. <!-- 引入本地脚本 -->
    2. <script src="./f2.js"></script>

    你也可以直接通过 @antv/f2">unpkg 下载。

    成功安装完成之后,即可使用 或 进行引用。

    1. const F2 = require('@antv/f2');

    在 F2 引入页面后,我们就已经做好了创建第一个图表的准备了。

    1. 创建 <canvas> 标签

    在页面上创建一个 并指定 :

    2. 编写图表绘制代码

    创建 标签后,我们就可以进行简单的图表绘制:

    • 创建 Chart 图表对象,指定图表 ID、指定图表的宽高、边距等信息;
    • 使用图形语法进行图表的绘制;
    • 渲染图表。
    1. // F2 对数据源格式的要求,仅仅是 JSON 数组,数组的每个元素是一个标准 JSON 对象。
    2. const data = [
    3. { genre: 'Sports', sold: 275 },
    4. { genre: 'Strategy', sold: 115 },
    5. { genre: 'Action', sold: 120 },
    6. { genre: 'Shooter', sold: 350 },
    7. { genre: 'Other', sold: 150 },
    8. ];
    9.  
    10. // Step 1: 创建 Chart 对象
    11. const chart = new F2.Chart({
    12. pixelRatio: window.devicePixelRatio // 指定分辨率
    13. });
    14.  
    15. // Step 2: 载入数据源
    16. chart.source(data);
    17.  
    18. // Step 3:创建图形语法,绘制柱状图,由 genre 和 sold 两个属性决定图形位置,genre 映射至 x 轴,sold 映射至 y 轴
    19. chart.interval().position('genre*sold').color('genre');
    20.  
    21. // Step 4: 渲染图表
    22. chart.render();

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

    更多的示例直接查看

    为了更好服务用户,F2 会将 URL 和版本信息发送回 AntV 服务器(H5 环境下):

    除了 URL 与 F2 版本信息外,不会收集任何其他信息,一切为了能对 F2 的运行情况有更多了解,以更好服务于用户。如有担心,可以通过下面的代码关闭:

    1. // 关闭 F2 的体验改进计划打点请求
    2. F2.track(false)