ruixue0702 / d3js_doc

d3js v4 中文版文档

d3js中文参考文档

仅供参考，以原英文版为准

---

• 介绍

• d3 4.X与3.X的不同

• 示例

• 插件

• 英文教程

• DEMO

• Mike Bostock的案例

• 官方画廊

文档参考

• Arrays (Statistics, Search, Transformations, Histograms)(数组、 静态方法、查找类方法、变换类方法、直方图)

• Axes(坐标轴)

• Brushes(刷子)

• Chords(弦图)

• Collections(Object,Maps,Sets,Nests)(集合、对象、map、嵌套)

• Colors(颜色)

• Delimiter-Separated Values(d3-dsv)(dsv模块)

• Dispatches(事件调度)

• Dragging(拖拽)

• Easings(过渡类型)

• Forces(力学仿真模拟)

• Number Formats(数值格式化)

• Geographies(地理)

• Hierarchies(层次结构布局)

• Interpolators(插值器)

• Paths(Canvas和SVG之间互转)

• Polygons(二维多边形)

• Quadtrees(四叉树)

• Queues(队列)

• Random Numbers(随机数)

• Requests(数据请求)

• Scales (Continuous, Sequential, Quantize, Ordinal)(比例尺)

• Selections (Selecting, Modifying, Data, Events, Control, Local Variables, Namespaces)(选择集)

• Shapes (Arcs, Pies, Lines, Areas, Curves, Symbols, Stacks)(形状)

• Time Formats(日期时间)

• Time Intervals(时间间隔)

• Timers(定时器)

• Transitions(过渡)

• Voronoi Diagrams(Voronoi图)

• Zooming(缩放)

安装

如果使用npm，则可以通过npm install d3来安装。此外还可以下载最新版，最新版支持AMD、CommonJS以及vanilla环境。可以使用Rollup创建自定义的库文件包，也可以直接从d3js.org引用：

<script src="https://d3js.org/d3.v4.js"></script>

压缩版:

<script src="https://d3js.org/d3.v4.min.js"></script>

你也可以单独使用d3中的某个模块，比如,单独使用d3-selection：

<script src="https://d3js.org/d3-selection.v1.min.js"></script>

如果要使用某个固定的版本，则考虑CNDJS 或 unpkg

支持环境

D3支持“现代”浏览器，也就是除IE8及以下的浏览器。D3针对Firefox，Chrome，Safari，Opera，IE9 +，Android和iOS进行测试，D3的一部分功能能在旧版的浏览器中运行，因为D3的核心功能对浏览器的要求比较低：JavaScript和 W3C DOM API。D3使用 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");

本地开发

由于浏览器的安全限制，不能直接读取本地文件。在本地开发的时候，必须要运行一个服务器环境而不是使用file://, 推荐使用Nodejs的http-server，安装方法:

npm install -g http-server

运行:

http-server & 

然后会在当前目录启动一个 http://localhost:8080 的服务。