2021SC@SDUSC“F2移动端可视化方案”源码分析(六)——Node端
作者:互联网
Node 端渲染 F2
虽然 F2 默认基于 Html5 Canvas 进行图表绘制,但是对于当前运行时环境来说,只要能够提供和 Html5 Canvas 上下文环境一样的上下文接口,一样也能使用 F2 进行图表绘制。
下面的表格给出了各个运行环境下可使用的 F2 的功能对比:
-- | Html5 | Node | 小程序(微信&&小程序) |
图表绘制 | ✔︎ | ✔︎ | ✔︎ |
Legend 组件 | ✔︎ | ✔︎ | ✔︎ |
Tooltip 组件 | ✔︎ | ✔︎ | |
事件(Tooltip、Legend 上的事件交互) | ✔︎ | ✔︎ | |
动画 | ✔︎ | ✔︎ |
Node 端渲染说明
将 F2 运行于 node 的后台服务上,可以提供强大的服务端渲染可视化图表的能力,这种能力可以应用于生成离线报表、图文 pdf 等场景。
目前 F2 在 node 环境中能够提供完整的图表绘制能力,但无法提供事件、交互以及动画功能(所以在试验官网 demo 时请删除 chart.tooltip() 以及 .animate() 相关的代码哦)。具体的使用方法如下:
- 首先安装模块,node-canvas
该模块提供了在 node 中实现 canvas 渲染的能力,结合该模块,就可以实现 F2 在 node 端的图表渲染了
npm install canvas
- 引入 F2,这里需要说明的是:node 端不支持动画、事件以及 Tooltip,所以在引入 F2 时请选择按需引入以避免上述模块的引入,这样也能够使得 F2 的代码体量更小巧。为了使用更便利,建议将以下代码封装成通用模块。
const F2 = require('@antv/f2/lib/core'); // 引入核心包
require('@antv/f2/lib/geom/'); // 几何标记对象
require('@antv/f2/lib/geom/adjust/'); // 数据调整
require('@antv/f2/lib/coord/polar'); // 极坐标系
require('@antv/f2/lib/component/axis/circle'); // 极坐标系下的弧长坐标轴
require('@antv/f2/lib/scale/time-cat'); // timeCat 类型的度量
require('@antv/f2/lib/component/guide'); // 加载 guide 组件
const Guide = require('@antv/f2/lib/plugin/guide'); // Guide 插件
const Legend = require('@antv/f2/lib/plugin/legend'); // Legend 插件
F2.Chart.plugins.register([ Legend, Guide ]); // 注册以上插件
- 创建一个 canvas 对象
const Canvas = require('canvas');
const canvas = Canvas.createCanvas(400, 267);
- 使用 F2 绘制图表,需要注意的是在创建 Chart 对象时传入的属性,下面两种方式 width 和 height 属性都是必须设置的
// 第一种方式直接传入 canvas
const chart = new F2.Chart({
el: canvas, // 将第三步创建的 canvas 对象传入
width: 400, // 必选,图表宽度,同 canvas 的宽度相同
height: 267 // 必选,图表高度,同 canvas 的高度相同
});
// 第二种方式传入上下文环境
const chart = new F2.Chart({
context: canvas.getContext('2d'), // 将第三步创建的 canvas 对象的上下文传入
width: 400, // 必选,图表宽度,同 canvas 的宽度相同
height: 267 // 必选,图表高度,同 canvas 的高度相同
});
下面是 F2 在 node 端绘制饼图的完整代码:
const fs = require('fs');
const path = require('path');
const Canvas = require('canvas'); // 引入 node canvas
// 引入 F2: start
const F2 = require('@antv/f2/lib/core'); // 引入核心包
require('@antv/f2/lib/geom/'); // 几何标记对象
require('@antv/f2/lib/geom/adjust/'); // 数据调整
require('@antv/f2/lib/coord/polar'); // 极坐标系
require('@antv/f2/lib/component/axis/circle'); // 极坐标系下的弧长坐标轴
require('@antv/f2/lib/scale/time-cat'); // timeCat 类型的度量
require('@antv/f2/lib/component/guide'); // 加载 guide 组件
const Guide = require('@antv/f2/lib/plugin/guide'); // Guide 插件
const Legend = require('@antv/f2/lib/plugin/legend'); // Legend 插件
F2.Chart.plugins.register([ Legend, Guide ]); // 注册以上插件
// 引入 F2: end
const canvas = Canvas.createCanvas(375, 260); // 创建 canvas 对象
// 使用 F2 绘制饼图
function drawPie() {
const data = [
{ name: '芳华', percent: 0.4, a: '1' },
{ name: '妖猫传', percent: 0.2, a: '1' },
{ name: '机器之血', percent: 0.18, a: '1' },
{ name: '心理罪', percent: 0.15, a: '1' },
{ name: '寻梦环游记', percent: 0.05, a: '1' },
{ name: '其他', percent: 0.02, a: '1' }
];
const chart = new F2.Chart({
el: canvas,
width: 375,
height: 260,
padding: [ 45, 'auto', 'auto' ]
});
chart.source(data, {
percent: {
formatter(val) {
return val * 100 + '%';
}
}
});
chart.legend({
position: 'right'
});
chart.coord('polar', {
transposed: true,
radius: 0.85
});
chart.axis(false);
chart.interval()
.position('a*percent')
.color('name', [ '#1890FF', '#13C2C2', '#2FC25B', '#FACC14', '#F04864', '#8543E0' ])
.adjust('stack')
.style({
lineWidth: 1,
stroke: '#fff',
lineJoin: 'round',
lineCap: 'round'
});
chart.render();
}
drawPie();
canvas.createPNGStream().pipe(fs.createWriteStream(path.join(__dirname, 'pie.png'))) // 导出图片
不同设备分辨率适配方案
适配方案很简单,假设当前设备的像素比为 2,那么在创建 F2 图表的时候,设置下 pixelRatio
属性即可:
const chart = new F2.Chart({
el: canvas,
width: 375,
height: 260,
padding: [ 45, 'auto', 'auto' ],
pixelRatio: 2
});
这里我们设置的画布宽高为 375 260,在设置了 pixelRatio: 2
后生成的图表宽高会相应放大 2 倍,尺寸为 750 520,这个时候在显示图片时,将图片的实际显示大小设置为 375 * 260,就可以保证图片的清晰显示了,如下图所示:
- 屏幕分辨率: 2
- 图片实际大小:750 * 520
- 图片的样式(显示大小):
style="width: 375px;height: 260px;"
标签:F2,2021SC,lib,require,antv,canvas,f2,源码 来源: https://blog.csdn.net/NEKOY/article/details/121736842