Zhihao's Studio.

冷门但实用的d3.js内置函数

Word count: 1,261 / Reading time: 5 min
2014/11/15 Share

前言

在d3.js的API文档中,提供了很多内置的函数,但是有些很有用的内置函数却被无情的忽略了,这篇博客就来整理整理这些被遗忘却很实用的函数。希望整理过后,他们不再被遗忘。

selection.classed(name,【value】)

value参数可选,如果没有指定,则返回与name参数匹配的第一个非空元素是否绑定了指定的CSS类,true表示绑定,false表示未绑定。如果value指定了的话,就是为selection添加/删除CSS类。
这点与selection.attr(name,【value】)非常类似,但是相比而言,就冷门的多,恐怕没有多少人不知道selection.attr(name,【value】),但是有很多人真的不知道selection.classed(name,【value】)。
这个函数很实用,比如鼠标进入某些点,让这些点高亮以表示强调,但是移出去之后,让他们回复原来的样式就可以用这个函数,免去了重新设置样式的麻烦,甚至有时候恢复原来样式的时候,还需要判断,就更麻烦了。

transition.filter(selector)

过滤也有过渡,这点可能很多人都忽略了,比如设置动画结束时,索引为奇数的元素旋转30度。甚至可以自己定义规则,如第5、10、15个元素改变,其他的不变。

d3.interpolate(a,b)

返回一个介于a,b之间的默认插值器,插值器的类型取决于b的类型。
1)如果b是颜色类型,那么返回的是interpolateRgb插值器
2)如果是字符串类型,则返回interpolateString插值器
3)如果是数组类型,则返回interpolateArray插值器
4)如果是对象类型,且不能强制转换成字符串类型,则返回interpolateObject插值器
5)否则,返回interpolateNumber插值器

数组相关API

使用d3时,会有大量的数组操作,如果能合理运用d3提供的数组相关的函数,将会使得工作效率大大提高。

d3.ascending(a,b)

如果a\b,返回1,如果a=b,返回0.
在可视化元素需要有序的时候,这个函数很有用,可以帮助我们排好序。

d3.min(),d3.max(),d3.extent()

前两个函数知道的人应该不少,但是最后一个却相对冷门,它可以直接返回数组自然排序的最小值和最大值,省的同时调用前面两个函数了。

d3.sum(),d3.mean(),d3.median(),d3.quantile()

基本的求和、平均数、中位数、p分位数,都帮你实现好了,之前还傻乎乎的自己去实现了,虽然不难,但是代码会很难看。

d3.shuffle(array)

用Fisher-Yates shuffle算法把传入的数组随机排序。这样想得到乱序的时候会不会比较高大上呢?嘿嘿。

d3.keys(object),d3.values(object)

keys返回一个包含指定对象(关联数组)中所有属性名称的数组。这点很有用,比如用d3.csv()读文件的时候,想要滤掉一些无关的dimension,比如id等等,用这个函数就很有用。

d3.map(),d3.set()

映射与集合是很常见的数据结构,但是不是所有js版本中都有默认的实现的,但是d3提供了。昨天在做项目的时候就遇到了这个问题,最后是借用了d3提供的map与set解决了。

d3.merge(arrays)

合并指定参数arrays为一个数组,与内置的concat类似,不过处理二维数组的时候,它会更方便。

d3.zip(arrays),d3.pairs(arrays)

d3.zip(【1,2】,【3,4,5】)返回【【1,3】,【2,4】】有啥用自己体会。
d3.pairs(【1,2,3,4】)返回【【1,2】,【2,3】,【3,4】】

d3.transpose(matrix)

转置二维矩阵用的。

brush

作为一个可视化系统,怎么能没有brush!实现brush的功能非常简单,构造刷子之前,需要制定x/y比例尺和空的范围。绘制的刷子可以重新调整大小和位置。
关于brush的使用,请看前面的博客(associate brush)。

时间的计数

d3.time.dayOfYear(date) 返回参数date是一年里的第几天,1月1日是第0天。
weekOfYear….等等函数也是有的,需要用的时候可以查查API,省的写闰年的判断,嘿嘿。

布局

Stack(layers【,index】),让我记忆最深,之前做一个项目的时候,就不知道有这东西存在,愣是自己实现了一遍,麻烦不说,对不对可能还一定.

地理

地理的API这块我很陌生,没有什么机会做这方面的项目,所以用的很少,后面有机会再来补充.

几何

同样陌生的还有几何这部分的内容,比如四叉树/凸包/多边形/泰森多边形,记住这部分有就可以了,后面用过之后再来补充.

行为

由zoom和drag两部分组成,很重要却很简单的内容,希望好好掌握。

CATALOG
  1. 1. 前言
  2. 2. selection.classed(name,【value】)
  3. 3. transition.filter(selector)
  4. 4. d3.interpolate(a,b)
  5. 5. 数组相关API
    1. 5.1. d3.ascending(a,b)
    2. 5.2. d3.min(),d3.max(),d3.extent()
    3. 5.3. d3.sum(),d3.mean(),d3.median(),d3.quantile()
    4. 5.4. d3.shuffle(array)
    5. 5.5. d3.keys(object),d3.values(object)
    6. 5.6. d3.map(),d3.set()
    7. 5.7. d3.merge(arrays)
    8. 5.8. d3.zip(arrays),d3.pairs(arrays)
    9. 5.9. d3.transpose(matrix)
  6. 6. brush
  7. 7. 时间的计数
  8. 8. 布局
  9. 9. 地理
  10. 10. 几何
  11. 11. 行为