D3.js 中的 Collection API

集合可以定义为将各种元素分组为单个单元的对象。它也被称为容器。 D3 的这一部分将帮助我们学习集合 API。

配置 API

我们可以借助如下所述的脚本来配置 API

集合 API 的方法

集合 API 具有 nests、sets、maps 和 objects。以下是集合 API 的四个重要且广泛使用的方法。

• Objects API
• Sets API
• Maps API
• Nests API

Objects API

集合 API 中的对象 API 是一种重要的数据类型。它为一些重要的方法提供支持，这些方法如下所示

1. d3.keys(object): 它具有对象的属性键，它将返回属性名称的数组。

请考虑以下示例。

示例

输出

2. d3.values(object): 它具有对象的值，它将返回属性名称的数组。

请考虑以下示例。

示例

输出

3. d3.entries(object): 它将返回任何具有指定对象的值和键的数组。所有条目都是带有值和键的对象。

请考虑以下示例。

示例

输出

Sets API

集合是不能包含重复项的任何组。它设计了数学集合抽象。

让我们讨论集合的各种 API 方法，如下所示

• d3.set([array[, accessor]]): 它用于创建任何新的集合。数组用于包含字符串值，其中 accessors 是可选的。
• set.has(value): 它用于检查集合是否包含任何指定字符串值的条目。
• set.add(value): 它将描述的字符串值包含到集合中。
• set.remove(value): 它可以用于删除可能添加任何指定字符串值的集合。
• set.clear(value): 它可以清除集合中的每一个值。
• set.values(value): 如果我们想获取集合的数组值，可以使用此方法。
• set.empty(value): 当集合仅包含零值时，它将返回一个 true 值。
• set.size(value): 它将返回集合的值的数目。

Maps API

以下是 MAP API

• d3.map([object[, key]]): 如果我们要设计任何新的地图，可以使用此方法。可以使用该对象复制每个可枚举属性。
• map.has(key): 它用于确保地图包含任何指定字符串键的条目。
• map.get(key): 如果我们要获取任何指定字符串键的值，可以使用此方法。
• map.set(key, value): 它用于将任何值设置为指定的字符串键。如果先前的地图具有与类似字符串键的条目，则新值将替换旧条目。
• map.remove(key): 它可以用于删除任何地图条目。如果未指定任何键，它将返回值 false。
• Map.clear(): 可以使用此方法从地图中删除所有条目。
• map.keys(): 它将返回地图中所有条目的字符串数组键。
• map.values(): 它将返回地图中所有条目的值数组。
• map.entries(): 它将返回所有地图条目的键值对象数组。
• map.each(function): 如果我们要将任何指定函数调用到地图中的所有条目，那么可以使用此方法。
• map.empty(): 如果地图包含零个条目，则它将返回值 true。
• map.size(): 它将返回地图中的条目数。

请考虑以下示例。

示例

输出

Nests API

嵌套 API 中的一些基本方法定义如下

• d3.nest(): 如果我们必须制作任何新的嵌套，那么可以使用此方法。
• nest.key(key): 可以使用此方法初始化任何新的键函数。
• nest.sortValues(comparator): 它用于对任何指定的比较器中的值进行排序。叶元素可以由比较器函数排序。
• nest.map(array): 它可以用于返回嵌套的映射和指定的数组。
• nest.object(array): 它可以用于返回嵌套对象，并对指定的数组使用任何嵌套运算符。
• nest.entries(array): 它将返回键值数组条目，并对任何指定的数组应用嵌套运算符。