Wiki中文

D3.js 是基于数据驱动文档工作方式的一款JavaScript函数库,主要用于网页作图、生成互动图形,是最流行的可视化库之一,它被很多其他的表格插件所使用。D3使你有能力借助HTML,SVG和CSS来生动地可视化各种数据。D3不需要你使用某个特定的框架,它的重点在于对现代主流浏览器的兼容,同时结合了强大的可视化组件,以数据驱动的方式去操作DOM。

资源

浏览器支持

D3支持的主流浏览器不包括IE8及以前的版本。D3测试了Firefox、Chrome、Safari、Opera和IE9。D3的大部分组件可以在旧的浏览器运行。D3核心库的最低运行要求:支持JavaScript和W3C DOM API。对于IE8,建议使用兼容性库Aight库。D3采用的是Selectors API的第一级标准,你要是考虑兼容性可以预加载Sizzle库。你得使用主流的浏览器以便可以支持SVG和CSS3的转场特效。D3不是一个兼容的层,所以并不是所有的浏览器都支持这些标准。

安装

下载最新的版本,并在你的代码中引用它:

或者, 采用\<script>标签在你的页面中动态引用最新的发布版本。方法:在你的页面代码中插入如下代码:

<script src="http://d3js.org/d3.v3.min.js"></script>

如果你想获得包括测试在内的所有资源,如下连接:

从git命令行获取:

git clone git://github.com/mbostock/d3.git

当你本地开发时,注意有的浏览器或许强制限制读取本地文件系统之外的文件。如果你在本地使用d3.xhr,其中包括(d3.json et al.),你必须有一个本地的Web服务器。比如,有可以运行Python内置的服务器:

python -m SimpleHTTPServer 8888 &

如果是Python 3+

python -m http.server 8888 &

当本地服务器运行起来时,即可访问 http://localhost:8888/.

如果你使用D3去开发你的可视化展现作品,那么D3的资源库是支持你修改完代码后立即查看改动的效果的,这个可以在你的浏览器或者开发的软件客户端进行相应查看。

D3支持异步调用模块的API使用。举个例子,如果你使用 RequireJS,那么以下操作是被允许的:

require.config({paths: {d3: "http://d3js.org/d3.v3.min"}});

require(["d3"], function(d3) {
  console.log(d3.version);
});

另外,如果你想扩展D3的功能,修改bug或者运行测试,你应该创建自己的D3资源库分支,同时安装Node.js。从资源库的根目录,可以安装D3的依赖库:

npm install d3

接着运行测试, 使用命令:

make test

修改

如果你想对D3进行修改的话,单击本页右上角的 "Fork" 按钮来fork你自己的D3项目,然后在命令行中输入如下命令来克隆到本地

git clone git://github.com/username/d3.git