|
|
@@ -3,15 +3,44 @@
|
|
|
|
|
|
## 使用方法
|
|
|
```
|
|
|
+// 首先安装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('<amap-key>').then(AMap=>{
|
|
|
+ // 可在此做一些初始化
|
|
|
+ this.setState({AMap});
|
|
|
+})
|
|
|
+// 在render中使用Map,注意其中参数refer类似react中ref,只支持函数,可以获得amap实例;options是参数,更新的参数也通过此处传下去,events是地图事件的回调,设置后将会被调用,可以触发属性的改变.
|
|
|
+// 一般地图组件都包含AMap, refer, options, events4个属性.
|
|
|
+// 注意, options和events中的函数和变量最好都为外面声明的,而不使用匿名的函数.否则容易触发事件的频繁移除及更新,耗费性能.
|
|
|
+<Map refer={} AMap={this.state.AMap} style={{width:1200, height:800}} options={{}} events={{}} >
|
|
|
+</Map>
|
|
|
+```
|
|
|
+或者直接下载,将源码添加进自己的项目中
|
|
|
+```
|
|
|
git clone https://github.com/windsome/react-amap-next
|
|
|
yarn install
|
|
|
npm start
|
|
|
```
|
|
|
+例子请参考`src/App.js`,
|
|
|
|
|
|
## 方案介绍
|
|
|
-1. `api.js`为amap相关的操作
|
|
|
-2. `Map.js`,`Marker.js`为UI组件,调用`api.js`相关方法生成及更新,遵循react生命周期函数
|
|
|
-3. `webservice.js`为地图webservice服务,与UI无关的操作均使用webservice进行
|
|
|
+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).
|
windsome.feng