d3 + geojson in node

d3.js本来主要是用于用“数据驱动dom”，在浏览器端，接收后端数据，数据绑定，渲染出svg。

即使是在ng中用，也是会由框架打包，供客户端下载。

那么，如果用所谓后端渲染，发布静态的svg，那就要在node里用d3。

几个遇到的点：

1 d3+jsdom实现后端渲染svg

node和前端的区别，就是没有全局window.document 这个对象。d3选择器无从选起。

1 创建jsdom对象

const { JSDOM } = require("jsdom");

const my_jsdom = new JSDOM(
        `
        <html>
        <head>
            <link rel="stylesheet" type="text/css" href="style.css">
        </head>
        <body>
        </body>
        </html>
        `, {
            resources: 'usable'
        }
      ); 

反引号中是一个空白网页模板，用过flask的jinja2 和ng的 templates的不会陌生，模拟浏览器里的window.document全局对象。

2 导入d3模块，并让d3获得这个模拟的网页。

//按需导入d3
var d3 = Object.assign({}, require("d3-selection"), require("d3-selection-multi"), require("d3-geo"));
//导入模拟的geojson数据
import {default as gdf} from './mock_polygon_gdf.json';

//让d3绑定到模拟的网页
const d3n = d3.select(my_jsdom.window.document);

 const svg = d3n.select('body')
                .insert('svg','records')
                .attr('width', 2400)
                .attr('height', 3000);
                 .append('g')
                 .selectAll('path')
                 .data(gdf['features'])
                  .enter()
                  .append('path')
                  .attr("d", d3.geoPath()

写这么长，是想说明，注意绑定当前网页后的对象命名为d3n, 不要和开始导入的d3库混淆。

在浏览器里，d3是通过html里写另外一个<script>引入d3.min.js  直接都导入好了，而且是直接d3.select('body')的。

在node这里加了一步，而且后面主要是用d3n来做后面的工作。

前面导入的d3库对象，也是有用的。比如后面的d3.geoPath()方法

经过这样的d3一顿绑定，svg画好了。还差最后一步：

3把网页输出成string，保存到.html文件

const content = my_jsdom.serialize();

fs.writeFile('${fpath}/${fname}.html', content, { encoding: "utf8", flag: "w" }, (err) =>{ 
  if (err) { 
    throw err; 
  } 
});

2. 按需分模块导入d3 子module

d3发展到v4 v5之后，功能膨胀，体积变大，除了集中发布的d3 还分离成若干独立子组件，可以按需加载。

而且，有些子组件并没有打包到d3中，必须自己手动安装，按需加载

根据d3官网，node中按需加载是这样的：https://github.com/d3/d3/blob/master/README.md

In Node:

var d3 = require("d3");

You can also require individual modules and combine them into a d3 object using Object.assign:

var d3 = Object.assign({}, require("d3-format"), require("d3-geo"), require("d3-geo-projection"));

用Object.assign() 打包成一个d3对象

3 一次为selection添加多个attr

特别是不知道attr具体名字，但attr的{name:value}都在需要绑定的数据中的时候

要用到独立于d3的子组件d3-selection-multi

按上面的方式，分组导入（我只用到3个，d3-selection必选，d3-geo是为了绑定geojson）

var d3 = Object.assign({}, require("d3-selection"), require("d3-selection-multi"), require("d3-geo"));

这样就可以:

    const enter = g.selectAll('path')
    .data(gjson['features'])
    .enter()
    .append('path')
    .attrs(
            (d)=> Object.assign({id: (d) => d['id']}, d['properties'])
            );

通过assign拼接，把id 和 properties中的全部属性，都作为dom node的 attribute 一句话给添加好。这确实是比用py里的svgwrite方便很多的，很优雅，要是py里能这么调用d3，该多好啊！

 

4 绑定geojson格式数据

用d3-geo，把一切geometry统统转成svg里的path， 且path的 d字段自动完成，非常优雅。https://github.com/d3/d3-geo#paths

尤其是polygon ->path，  避免自己去 写d M L Z 多次拼接，虽然自己写代码也不长，但是毕竟能偷懒就偷懒：

    const enter = g.selectAll('path')
                          .data(gjson['features'])
                          .enter()
                          .append('path')
                          .attr("d", d3.geoPath());

通过数据绑定，enter新增数据，添加path，直接一句搞定。

5 d3选择集上消失的update()方法,改用merge()

《精通D3.js》里介绍的data数据绑定后，都是enter() update() exit()三件套。

但现在，v5了，selection上没有update（）方法了。

官网有人报issue

https://github.com/d3/d3-selection/issues/176

给出的答案是用merge，确实更优雅了

把enter和update合并处理了

// Perform the data join and obtain the update selection.
const option = d3.select("#mySelect")
  .selectAll("option")
  .data(optionsData);

// Append the entering nodes, and obtain the enter selection.
const enter = option.enter().append("option");

// Merge entering and updating nodes to apply some operations to both.
enter.merge(option)
    .property("value", d => d.value)
    .text(d => d.label);

// Remove the exiting nodes.
option.exit().remove();