D3.js的基础部分之数组的处理 映射(Map)(v3版本)

映射(Map)

 

映射(Map)是十分常见的一种数据结构，由一系列键(key)和值(value)组成的。每个key对应一个value，根据key可以获取和设定value,也可以根据key来查询value。

 

上面那个图展示了一个映射，该映射以每个值得id作为键，每个键对应一个值。

 

 

d3.map()能构建映射，包括以下方法:

d3.map([object][,key]) 　　　　　　  

//构造映射。第一个参数是源数组，第二个参数用于指定映射的key。

 

map.has(key) 　　　　　　　　　　

//如果指定的key存在，则返回true。反之，返回false。

 

map.get(key) 　　　　　　　　　　 

//如果指定的key存在，则返回该key的value。否则返回undefined。

 

map.set(key.value) 　　　　　　　   

//对指定的key设定value,如果该key已经存在，则新value会覆盖旧value。如果该key不存在，则会添加一个新的value。

 

map.remove(key) 　　　　　　　　 

//如果指定的key存在，则将此key和value删除，并返回true。如果不存在，则返回false。

 

map.keys() 　　　　　　　　　　   

 //以数组的形式返回该map所有的key。

 

map.values() 　　　　　　　　　　 

//以数组的形式返回该map所有的value。

 

map.entries()　　　　　　　　 　　 

//以数组形式返回该map所有的key和value。

 

map.forEach(function)　　　　　　  

//分别对该映射中的每一项调用function函数，function函数传入两个参数:key和value。分别代表每一项的key和vallue。

 

map.empty() 　　　　　　　　　　 

//如果该映射为空，返回true。否则返回false。

 

map.size() 　　　　　　　　　　     

//返回该映射的大小。

 

接下来我们参照上图来构建一个映射，并分别调用上述函数。

 

//用于构建映射的数组
        var dataList = [
            {id:1000,color:"red"},
            {id:1001,color:"green"},
            {id:1002,color:"blue"}
        ]

        //以数组dataList构建映射，并以其中各项的id作为键
        var map = d3.map(dataList,function(d){return d.id})

        //打印一下各方法的返回值
        console.log(map.has(1001))      //返回true
        console.log(map.has(1003))      //返回false

        console.log(map.get(1001))      //返回{id: 1001, color: "green"}
        console.log(map.get(1003))      //返回undefined

        //将1001键的值设置为{id:1001,color:"yellow"}
        map.set(1001,{id:1001,color:"yellow"})
        console.log(map.get(1001))      //返回值{id: 1001, color: "yellow"}
        
        // 将1003键的值设置为{id:1003,color:"white"}
        map.set(1003,{id:1003,color:"white"})
        console.log(map.get(1003))      //返回值{id: 1003, color: "white"}

        map.remove(1001) 
        console.log(map.has(1001))      //返回值false

        console.log(map.keys())         //返回值 ["1000", "1002", "1003"]
        console.log(map.values())       //返回值[
                                        //          {id:1000,color:"red"},
                                        //          {id:1002,color:"blue"},
                                        //          {id:1003,color:"white"}
                                        //      ]
                                        
        console.log(map.entries())      //返回值[
                                        //         {key: "1000", value:{id: 1000, color: "red"}}
                                        //         {key: "1002", value:{id: 1002, color: "blue"}}
                                        //         {key: "1003", value:{id: 1003, color: "white"}}
                                        //      ]

        //该循环会进行三次，键一次为1000，1002,1003
        map.forEach(function(key,value){
            console.log(key)            //返回值依次为 1000、1002、1003
            console.log(value)          //返回值依次为 {id: 1000, color: "red"}、{id: 1002, color: "blue"}、{id: 1003, color: "white"}
        })

        console.log(map.empty())        //返回值false
        console.log(map.size())         //返回值3

映射还是很好理解的。唯一要注意的是，以上代码中，值(value)是包含键(key)的，即值是{id:1001,color:"yellow"}而不是{color:"yellow"}。使用set()设定的时候尤其要留意。键(key)是在构建映射时，由function(d){return d.id}指定的，当然也可以指定别的不相关的值，不一定要使用id。