D3 (或者叫 D3.js )是一个基于 web 标准的 JavaScript 可视化库. D3 可以借助 SVG, Canvas 以及 HTML 将你的数据生动的展现出来. D3 结合了强大的可视化交互技术以及数据驱动 DOM 的技术结合起来, 让你可以借助于现代浏览器的强大功能自由的对数据进行可视化。
- API 参考
- API 参考 ( 原英文版 )
- d3-queue(v5.x.x中被移除)
- d3-request(v5.x.x中被移除)
- 理解数据绑定
- 数据绑定示例
- 发布说明
- 官方画廊
- Mike Bostock 的示例
- 教程
- 插件
- v3 与 v4
- d3.js on Stack Overflow
- d3-js Google Group
- 基于 d3js 的图论
D3 5.0 引入了很少的非向后兼容的改变.
D3 现在采用的是 Promises 来替代异步回调加载数据。 Promises 简化了异步代码结构，尤其是现代浏览器支持 async and await 操作。(在 Observable 中参考 introduction to promises 的介绍)。例如在 V4 中使用如下方式加载 CSV 文件:
d3.csv("file.csv", function(error, data) {
if (error) throw error;
console.log(data);
});在 V5 中基于 Promises 实现:
d3.csv("file.csv").then(function(data) {
console.log(data);
});要注意的是不需要重新抛出错误，因为 Promise 会自动 reject，并且需要的话可以使用 promise.catch。使用 await 的话代码会更简单：
const data = await d3.csv("file.csv");
console.log(data);由于采用了 promises，D3 现在使用 Fetch API 来代替 XMLHttpRequest: d3-request 模块由 d3-fetch 替代。Fetch 支持许多强大的特性，比如 streaming responses。D3 5.0 也不再使用 d3-queue，取而代之推荐 Promise.all 来处理批量异步任务，或者使用辅助库比如 p-queue 来 control concurrency(控制并发).
D3 不再提供 d3.schemeCategory20* 颜色方案。因为这些颜色有缺陷，可能会错误的暗示数据中的关系：色调相近的可能被认为是一个分组，而亮度可能被错认为是排序。作为替换，D3 5.0 使用 d3-scale-chromatic，它实现了 ColorBrewer 的方案设计，包括 categorical, diverging, sequential single-hue 和 sequential multi-hue 方案。这些颜色方案在连续式和分散式都是可用的。
D3 提供了通过 d3-contour 实现的 marching squares(生成二维轮廓的算法) 和 density estimation(密度估计). 并且添加了两个新的 d3-selection 方法：selection.clone 用来克隆已选择的节点，d3.create 用来创建分离的元素。 Geographic projections 也支持 projection.angle，一种由 Philippe Rivière 提出的梦幻般的新的多面体投影。
最后，D3 的 package.json 不再引用依赖的精确版本，解决了重复安装 D3 模块的问题。
如果使用 npm, 则可以通过 npm install d3 来安装. 此外还可以下载 最新版, 最新版支持 AMD、CommonJS 以及基础标签引入形式. 你也可以直接从 d3js.org, CDNJS, 或者 unpkg 加载. 比如:
«
<script src="https://d3js.org/d3.v5.js"></script>压缩版:
<script src="https://d3js.org/d3.v5.min.js"></script>你也可以单独使用 d3 中的某个模块, 比如单独使用 d3-selection:
<script src="https://d3js.org/d3-selection.v1.js"></script>D3基于 ES2015 modules 开发. 可以使用 Rollup, webpack 或者其他你偏爱的打包工具进行构建. 在一个符合 ES2015 的应用中导入 d3 或者 d3 的某些模块:
import {scaleLinear} from "d3-scale";或者导入 d3 的全部功能并且设置命名空间 (这里是 d3):
import * as d3 from "d3";在 Nodejs 环境中:
var d3 = require("d3");你也可以导入多个模块然后将这些模块集合到 d3 对象中, 此时使用 Object.assign:
var d3 = Object.assign({}, require("d3-format"), require("d3-geo"), require("d3-geo-projection"));D3 5+ 支持最新浏览器，比如 Chrome，Edge，Firefox 以及 Safari。D3 4 以及之前的版本支持 IE 9 以上的版本。D3 的一部分功能能在旧版的浏览器中运行，因为 D3 的核心功能对浏览器的要求比较低。例如 d3-selection 使用 Level 1 级 Selectors API，但是可以通过预先加载 Sizzle 来实现兼容。现代浏览器对 SVG 和 CSS3 Transition 的支持比较好。所以 D3 不支持更低级别的浏览器，如果你的浏览器不支持这些标准，那么对不起了，老铁。
D3 也可以运行在 Node 和 Web workers 中. 在 Node 环境中使用 DOM 的时候，必须要提供自己的 DOM 实现。推荐使用 JSDOM，为了避免定义全局 document，建议将 DOM 传递给 d3.select 或者将 NodeList 传递给 d3.selectAll, 如下：
var d3 = require("d3"),
jsdom = require("jsdom");
var document = jsdom.jsdom(),
svg = d3.select(document.body).append("svg");在支持 ES 模块化 的环境中，你可以将 d3 作为一个命名空间来导入 D3 的全部功能:
import * as d3 from "d3";如果你不想导入全部模块，则分配命名空间的时候要和 d3 进行区分:
import * as d3 from "d3";
import * as d3GeoProjection from "d3-geo-projection";出于这个原因，应该优先考虑 D3 模块中的原有变量名，可以按需导入：
import {select, selectAll} from "d3-selection";
import {geoPath} from "d3-geo";
import {geoPatterson} from "d3-geo-projection";如果你使用打包工具，则确保已经配置好正确的入口，可以参考 resolve.mainFields
由于浏览器的安全限制，不能直接读取本地文件。在本地开发的时候，必须要运行一个服务器环境而不是使用file://, 推荐使用 Nodejs 的http-server，安装方法:
npm install -g http-server运行:
http-server & 然后会在当前目录启动一个 http://localhost:8080 的服务。
每个子仓库中包含三个 .md 文件:
- README.md 文件是翻译后的中文版
- README_EN.md 文件是翻译时参照的英文版
- README_ORIGIN.md 文件是源仓库文档
更新时, 首先将 README_ORIGIN.md 与官网文档进行同步, 然后将 README_EN.md 和 README_ORIGIN.md 进行比对, 将 diff 更新至 README.md, 同时将 README_EN.md 与 README_ORIGIN.md 进行同步.
| 🐧 | 214175619 | |
|---|---|---|
| 📧 | xs.wei@foxmail.com |
