d3.js 集合 api——迹忆客-ag捕鱼王app官网

集合只是一个将多个元素组合成一个单元的对象。它也被称为容器。本章详细介绍了集合 api。

配置api

可以使用以下脚本配置 api。

集合 api 方法

集合 api 包含对象、映射、集合和嵌套。以下是最常用的集合 api 方法。

• objects api
• maps api
• sets api
• nests api

让我们详细介绍每个 api。

object api

object api 是重要的数据类型之一。它支持以下方法 -

• d3.keys(object) - 此方法包含对象属性键并返回属性名称数组。
• d3.values(object) - 此方法包含对象值并返回一个属性值数组。
• d3.entries(object) - 此方法用于返回包含指定对象的键和值的数组。每个条目都是一个具有键和值的对象。

让我们考虑以下代码。

d3.entries({one: 1})

这里，key 为 one，value 为 1。

   
      
   
   
      
d3 collection api
      
   

在浏览器控制台中显示结果如下

map api

映射包含基于键值对的值。每个键值对都称为一个条目。map 仅包含唯一键。基于键搜索、更新或删除元素很有用。让我们详细了解各种 maps 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() - 返回此映射中每个条目的键值对象数组。
• (x) map.each(function) - 此方法用于为地图中的每个条目调用指定的函数。
• (xi) map.empty() - 当且仅当此地图具有零个条目时才返回 true。
• (xii) map.size() - 返回此地图中的条目数。

示例

   
      
   
   
      
d3 collection api
      
   

同样，您也可以执行其他操作。

sets api

set 是一个不能包含重复元素的集合。它对数学集合抽象进行建模。让我们详细了解各种 sets api 方法。

• d3.set([array[, accessor]]) - 此方法用于创建一个新集合。数组用于添加字符串值。访问器是可选的。
• set.has(value) - 此方法用于检查集合是否具有指定值字符串的条目。
• set.add(value) - 用于将指定的值字符串添加到集合中。
• set.remove(value) - 用于删除包含指定值字符串的集合。
• set.clear() - 从此集合中删除所有值。
• set.values() - 此方法用于将值数组返回到集合。
• set.empty() - 当且仅当此集合具有零值时才返回 true。
• set.size() - 返回此集合中值的数量。

示例

   
      
   
   
      
d3 collection api
      
   

同样，我们也可以执行其他操作。

nested api

嵌套 api 包含数组中的元素并以分层树结构执行。让我们详细了解各种 nests api 方法。

• d3.nest() - 此方法用于创建一个新的嵌套。
• nest.key(key) - 此方法用于初始化新的键函数。此函数用于调用输入数组中的每个元素并返回组中的元素。
• nest.sortkeys(comparator) - 此方法用于对指定比较器中的键进行排序。函数定义为 d3.ascending 或 d3.descending。
• nest.sortvalues(comparator) - 此方法用于对指定比较器中的值进行排序。比较器函数对叶元素进行排序。
• nest.map(array) - 此方法用于应用指定的数组并返回嵌套映射。返回映射中的每个条目对应于第一个键函数返回的不同键值。条目值取决于注册的键功能的数量。
• nest.object(array) - 此方法用于将嵌套运算符应用于指定的数组并返回嵌套对象。
• nest.entries(array) - 此方法用于将嵌套运算符应用于指定的数组并返回键值条目数组。

示例

   
      
   
   
      
d3 nest api
      
   

上述代码执行结果如下