层次布局

优质
小牛编辑
119浏览
2023-12-01

分层布局是一种抽象布局,不直接使用。但它允许在不同的分层布局中共享节点。请看下列例子: • Cluster -簇实体构成树状图。 • Pack -使用递归圆填充法创建一个分层布局。 • Partition -将节点树递归划分成辐射状或环状。 • Tree -将节点树整齐放置。 • Treemap -使用递归空间划分显示节点树。 虽然不是分层布局,但捆绑布局可以同分层共同使用。

d3.layout.hierarchy()

使用以下默认设置创建新的分层布局:默认排序顺序为值的降序排列;默认值访问器假定每个输入数据为一个含数值属性的对象;默认子访问器假定每个输入数据为一个含子数列的对象。

hierarchy(root)

运行分层布局,返回节点数组及指定的根节点。布局的输入参数为分层的根节点,输出返回值为一个数组,表示计算过的所有节点的位置。每个节点都有各自属性:  parent -父节点,在根节点时为空。  children -子节点数组,在叶节点时为空。  value -节点值,由值访问器返回。  depth -节点深度,从根节点计算,值从0开始。 此外,多数分层布局也会计算节点的x和y的位置;详见实现类。

hierarchy.links(nodes)

指定节点数组返回一个对象数组,该数组表示每个节点中父节点同子节点之间的关系。叶节点没有任何关系。每个节点都是一个具有两个属性的对象:  源-父节点(如上述所示)。  目标-子节点。 该方法在获取一组关系描述时很有效果,通常与对角图形生成器共同使用。例如: svg.selectAll("path") .data(partition.links(nodes)) .enter().append("path") .attr("d",d3.svg.diagonal());

hierarchy.children([accessor])

如果accessor已经指定,则设定子访问器函数。如未指定,则返回当前子访问器函数,该函数将输入数据默认为带子数组的对象: functionchildren(d){ returnd.children; }

通常,使用d3.json可以方便地加载节点分层,并将输入分层表示为一个嵌套JSON对象。例如: { "name":"flare", "children":[ { "name":"analytics", "children":[ { "name":"cluster", "children":[ {"name":"AgglomerativeCluster","size":3938}, {"name":"CommunityStructure","size":3812}, {"name":"MergeEdge","size":743} ] }, { "name":"graph", "children":[ {"name":"BetweennessCentrality","size":3534}, {"name":"LinkDistance","size":5731} ] } ] } ] } 在分层中,子访问器在根节点首先被调用。如果访问器返回值为空,则该节点在布局遍历结束时被假定为叶节点。否则,访问器需要返回数据源数组,来表示子节点。参数node和depth都需要调用访问器。

hierarchy.sort([comparator])

如已指定comparator,则使用指定的comparator函数设定布局的同级节点节点顺序。如comparator未指定,则返回当前分组的排序顺序,默认值为按照输入数据的字符串名对节点的降序顺序排序:

functioncomparator(a,b){ returnb.value-a.value; }

为每对节点,调用comparator函数。零comparator禁用排序,使用树遍历顺序。comparator函数也可以通过d3.ascending或d3.descending实现。

hierarchy.value([value])

如果已经指定value,则用指定的函数设定值访问器。如果尚未指定value,则返回当前值访问器。默认访问器假定输入数据为一个具有数值属性的对象: functionvalue(d){ returnd.value; }

每次输入数据元素,都会调用值访问器,并且必须返回一个用以表示节点数值的数字。对于区域布局,如树图,该值用于设定每个节点值相应的面积。对于其他布局,该值对簇布局没有影响。

hierarchy.revalue(root)

对于一棵指定的树,从根开始重计算每个节点的值,但不需对子节点进行重新排序或重新计算。该方法可以用于对每个节点值进行重新计算,但又不必对分层做出任何结构改变。最初,该方法是用来支持sticky treemaps的。

  • 张烁译 20140430
  • 咕噜校对 2014-11-30 10:42:08