D3.js中文版api-接口文档

D3.js中文版api-接口文档2014-09-2311:47:03阅读25477次Api参考此文档翻译自APIReference（英语），版本为2013-9-9。不能保证文档的同步更新，因此，需要了解最新的开发特性，请移步英文版API参考。d3库所提供的所有API都在d3命名空间下。d3库使用语义版本命名法（semanticversioning）。你可以用d3.version查看当前的版本信息。d3(核心部分)选择集d3.select-从当前文档中选择一系列元素。d3.selectAll-从当前文档中选择多项元素。selection.attr-设置或获取指定属性。selection.classed-添加或删除选定元素的CSS类（CSSclass）。selection.style-设置或删除CSS属性。style优先级高于attr。selection.property-设置或获原生的属性值（rawproperty）。selection.text-设置或获取选定元素的标签体文本内容。selection.html-设置或获取选定元素的HTML内容（类似innerHTML）selection.append-创建并添加新元素到选定元素后。selection.insert-创建并添加新元素到选定元素前。selection.remove-从当前文档对象中删除选定的元素。selection.data-设置或获取一组元素的绑定数据（getorsetdataforagroupofelements,whilecomputingarelationaljoin.）selection.enter-返回缺失元素的占位对象（placeholder），指向绑定的数据中比选定元素集多出的一部分元素。selection.exit-返回多余元素的元素集，即选择元素中比绑定数据多出的一部分。(关于data,enter,exit原理的示例1,示例2,示例3)selection.datum-设置或获取单独元素的数据，不进行关联。（getorsetdataforindividualelements,withoutcomputingajoin.）selection.filter-根据绑定的数据过滤选择集。selection.sort-根据绑定的数据对选择的元素进行排序。selection.order-对文档中的元素重排序以匹配选择集。selection.on-添加或删除事件监听器。selection.transition-启动一个过渡效果（返回Transition对象），可以理解为动画。selection.interrupt-立即停止所有正在进行的动画动作。selection.each-为每个选择的元素集调用指定的函数。selection.call-为当前选择的元素集调用指定的函数。selection.empty-测试选择集是否为空。selection.node-返回选择集中的第一个元素。selection.size-返回选择集中的元素个数。selection.select-选择所选的元素中的第一个子元素组成新的选择集。selection.selectAll-选择所选的元素中的多个子元素组成新的选择集。d3.selection-选择集对象原型（可通过d3.selection.prototype为选择集增强功能）。d3.event-获取当前交互的用户事件。d3.mouse-获取鼠标的相对某元素的坐标。d3.touches-获取相对某元素的触控点坐标。过渡效果d3.transition-开始一个动画过渡。简单教程transition.delay-指定每个元素过渡的延迟时间（单位：毫秒ms）。transition.duration-指定每个元素过渡的持续时间（单位：毫秒ms）。transition.ease-指定过渡的缓冲函数。transition.attr-平滑过渡到新的attr属性值（起始属性值为当前属性）。transition.attrTween-在不同attr属性值之间平滑过渡（起始属性值可在过渡函数中设置,甚至整个过渡函数都可以自定义）。transition.style-平滑过渡到新的style属性值。transition.styleTween-在不同style属性值之间平滑过渡。transition.text-在过渡开始时设置文本内容。transition.tween-使某个属性过渡到一个新的属性值，该属性可以是非attr或非style属性，比如text。transition.select-选择每个当前元素的某个子元素进行过渡。transition.selectAll-选择每个当前元素的多个子元素进行过渡。transition.filter-通过数据筛选出当前元素中的部分元素进行过渡。transition.transition-当前过渡结束后开始新的过渡。transition.remove-过渡结束后移除当前元素。transition.empty-如果过渡为空就返回true。如果当前元素中没有非null元素，则此过渡为空。transition.node-返回过渡中的第一个元素。transition.size-返回过渡中当前元素的数量。transition.each-遍历每个元素执行操作。不指定触发类型时，立即执行操作。当指定触发类型为'start'或'end'时,会在过渡开始或结束时执行操作。transition.call-以当前过渡为this执行某个函数。d3.ease-定制过渡的缓冲函数。ease-缓冲函数。缓冲函数可让动画效果更自然，比如elastic缓冲函数可用以模拟弹性物体的运动。是一种插值函数的特例。d3.timer-开始一个定制的动画计时。功能类似于setTimeout，但内部用requestAnimationFrame实现，更高效。d3.timer.flush-立刻执行当前没有延迟的计时。可用于处理闪屏问题。d3.interpolate-生成一个插值函数，在两个参数间插值。差值函数的类型会根据输入参数的类型（数字、字符串、颜色等）而自动选择。interpolate-插值函数。输入参数在[0,1]之间。d3.interpolateNumber-在两个数字间插值。d3.interpolateRound-在两个数字间插值，返回值会四舍五入取整。d3.interpolateString-在两个字符串间插值。解析字符串中的数字，对应的数字会插值。d3.interpolateRgb-在两个RGB颜色间插值。d3.interpolateHsl-在两个HSL颜色间插值。d3.interpolateLab-在两个L*a*b*颜色间插值。d3.interpolateHcl-在两个HCL颜色间插值。d3.interpolateArray-在两个数列间插值。d3.interpolateArray([0,1],[1,10,100])(0.5);//returns[0.5,5.5,100]d3.interpolateObject-在两个object间插值。d3.interpolateArray({x:0,y:1},{x:1,y:10,z:100})(0.5);//returns{x:0.5,y:5.5,z:100}d3.interpolateTransform-在两个2D仿射变换间插值。d3.interpolateZoom-在两个点之间平滑地缩放平移。示例d3.interpolators-添加一个自定义的插值函数.数据操作(WorkingwithArrays)d3.ascending-升序排序函数.d3.descending-降序排序函数.d3.min-获取数组中的最小值.d3.max-获取数组中的最大值.d3.extent-获取数组的范围(最小值和最大值).d3.sum-获取数组中数字之和.d3.mean-获取数组中数字的算术平均值.d3.median-获取数组中数字的中位数(相当于0.5-quantile的值).d3.quantile-获取排好序的数组的一个分位数(quantile).d3.bisect-通过二分法获取某个数在排好序的数组中的插入位置(同d3.bisectRight).d3.bisectRight-获取某个数在排好序的数组中的插入位置(相等的值归入右边).d3.bisectLeft-获取某个数在排好序的数组中的插入位置(相等的值归入左边).d3.bisector-自定义一个二分函数.d3.shuffle-洗牌，随机排列数组中的元素.d3.permute-以指定顺序排列数组中的元素.d3.zip-将多个数组合并成一个数组的数组，新数组的的第i个元素是原来各个数组中第i个元素组成的数组.d3.transpose-矩阵转置，通过d3.zip实现.d3.pairs-返回临近元素对的数组，d3.pairs([1,2,3,4]);//returns[[1,2],[2,3],[3,4]].d3.keys-返回关联数组(哈希表、json、object对象)的key组成的数组.d3.values-返回关联数组的value组成的数组.d3.entries-返回关联数组的key-value实体组成的数组,d3.entries({foo:42});//returns[{key:foo,value:42}].d3.merge-将多个数组连成一个，类似于原生方法concat.d3.merge([[1],[2,3]]);//returns[1,2,3].d3.range-获得一个数列.d3.range([start,]stop[,step])d3.nest-获得一个nest对象，将数组组织成层级结构.示例：nest.key-为nest层级结构增加一个层级.nest.sortKeys-将当前的nest层级结构按key排序.nest.sortValues-将叶nest层级按value排序.nest.rollup-设置修改叶节点值的函数.nest.map-执行nest操作,返回一个关联数组(json).nest.entries-执行nest操作,返回一个key-value数组.如果nest.map返回的结果类似于{foo:42},则nest.entries返回的结果类似于[{key:foo,value:42}].d3.map-将javascript的object转化为hash,屏蔽了object的原型链功能导致的与hash不一致的问题。map.has-map有某个key就返回true.map.get-返回map中某个key对应的value.map.set-设置map中某个key对应的value.map.remove-删除map中的某个key.map.keys-返回map中所有key组成的数组.map.values-返回map中所有value组成的数组.map.entries-返回map中所有entry（key-value键值对）组成的数组.类似于{foo:42}转化成[{key:foo,value:42}]map.forEach-对map中每一个entry执行某个函数.d3.set-将javascript的array转化为set,屏蔽了array的object原型链功能导致的与set不一致的问题。set中的value是array中每个值转换成字符串的结果。set中的value是去重过的。set.has-返回set中是否含有某个value.set.add-添加某个value.set.remove-删除某个value.set.values-返回set中的值组成的数组.se