highcharts-Highmaps 动态传入城市名称

做前端按地区（地图）分布监控数据展示用了 HIGHMAPS JAVASCRIPT MAPS 控件，很好很强大。

基础实现是这样的：调用插件动态传入需要展示的数据（data），插件会在地图数据（mapdata）中找到对应的区域，把值丢进去，然后在页面上渲染展示带有数据的区域数据分布地图。

mapdata 数据结构（已简化）：

[
    {'hc-key' : 'cn-sh', 'name' : '上海'},
    {'hc-key' : 'cn-zj', 'name' : '浙江'}
]

data 数据结构：

[
    { 'hc-key' : 'cn-sh', 'value' : 113 },
    { 'hc-key' : 'cn-zj', 'value' : 44 }
]

（这里值得注意的是，value 值不能带上引号如：'value' : '44' 就会导致插件报错无法渲染。）

插件通过 data 里的这个 hc-key 值去 mapdata （该数据存放在一个 js 文件内） 捞对应的区域信息详情，其中就包括地区的中文名称信息如：上海。就是这里出了一点小麻烦，我的中文名称可能会发生变动，譬如有时候是「上海」，但可能下一次下下次又会是 「上海 1」 ，「上海 2」。

常规思路是直接改数据源，重新加载数据源就好了。可是这个 mapdata 如我前面所说，是存在文件里的，那么一个人必须是疯了才会想去在前端动态修改保存一个文件吧，所以这条路不用想就直接跳过。
再想一下既然 data 里的 value 能进去 mapdata ，那么 name 一样也能进去。于是就这么愉快的决定，前端动态传 data 的时候根据需要带上（或不带则还是使用 mapdata 里默认的名称） name 属性。

解决方案：

动态传入 data 的数据结构：

[
    { 'hc-key' : 'cn-sh', 'value' : 113, 'name' : '上海' },
    { 'hc-key' : 'cn-zj', 'value' : 44 }
]

接下来就是改造插件，能够接受我传入的 name 属性，在插件中（highmaps.js）找到 mapdata 数据渲染之前这段：

   if (mapData) {
 2　　　　　　...

                if (options.allAreas) {

                    data = data || [];

                    // Registered the point ...
                    if (joinBy[1]) {
                        each(data, function (point) {
                            dataUsed.push(point[joinBy[1]]);
                        });
                    }

                    // 放这里 o(≧v≦)o

                    // Add those map points ...
                    dataUsed = '|' + dataUsed.join('|') + '|'; 
19　　　　　　　　　　　　...
                }
            }

在 「// 放这里 o(≧v≦)o 」 这个位置加入下面这个赋值改写 mapdata 的 name 属性的方法：

each(data, function (dataItem) {
　　if (dataItem["name"]) {
　　　　each(mapData, function (mapdataItem) {
　　　　　　mapdataItem.name = mapdataItem[joinBy[0]] == dataItem[joinBy[0]] ? dataItem.name : mapdataItem.name;
5　　　　});
6　　}
});

搞定。