## 项目目标 此项目是对高德地图的react封装,相比较于react-amap,集成更原生化,更简单. 用最react的方式使用高德地图AMap. ## 使用方法 ``` // 首先安装react-amap-next yarn add react-amap-next // 加载所需组件 import { loadMap } from './lib/api'; //加载高德地图方法,如果与redux配合,可以写在action/reducer中 import Map from 'react-amap-next/lib/Map'; //加载Map import Marker from 'react-amap-next/lib/Marker'; // 在componentDidMount中加载js loadMap('').then(AMap=>{ // 可在此做一些初始化 this.setState({AMap}); }) // 在render中使用Map,注意其中参数refer类似react中ref,只支持函数,可以获得amap实例;options是参数,更新的参数也通过此处传下去,events是地图事件的回调,设置后将会被调用,可以触发属性的改变. // 一般地图组件都包含AMap, refer, options, events4个属性. // 注意, options和events中的函数和变量最好都为外面声明的,而不使用匿名的函数.否则容易触发事件的频繁移除及更新,耗费性能. ``` 或者直接下载,将源码添加进自己的项目中 ``` git clone https://github.com/windsome/react-amap-next yarn install npm start ``` 例子请参考`src/App.js`, ## 方案介绍 1. `api.js`为amap相关的操作,主要包含高德js的加载及各种组件的创建及更新方法. 2. `webservice.js`为地图webservice服务,与UI无关的操作均使用webservice进行 3. `Map.js`为根节点地图组件,其他所有子UI组件都必须作为其一级子元素.遵循react生命周期函数,主要使用`componentDidMount`, `componentDidUpdate`进行创建和更新的处理. 4. `Marker.js`为标记点组件 5. `MassMarks`为海量点组件,此组件是一个layer图层,因为比traffic, sattelite复杂,需要设置很多属性,所以独立成一个组件.其他图层也可以参考设置成独立组件 6. `Polygon.js`为多边形控件,可以用来画行政区域图 7. `Polyline.js`为多折点线组件,可以用来模拟汽车行驶轨迹 8. 其他组件,有待添加. ## 注意事项 1. `loadScript.js`是用来加载js和css的,希望能确保加载文件的唯一性,可以参考requirejs的实现机制改掉. 2. 与`react-amap`的不同之处,加载高德地图js与`Map`,`Marker`等组件是分离的. ## 反馈 We are always open to [your feedback](https://github.com/windsome/react-amap-next/issues). ## 更新计划 ## 团队协作