react-amap-next

项目目标

此项目是对高德地图的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('<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相关的操作,主要包含高德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.

更新计划

团队协作