react-mapbox-gl

react-mapbox-gl

Based on mapbox-gl-js this library aim to bring the api to a React friendly way with some additional extra behavior. The library include the following elements :

• ReactMapboxGl
• Layer
• Feature
  • Layer type properties symbol display a mapbox point
  • Layer type properties line display a lineString
  • Layer type properties fill display a polygon
• ZoomControl

It will include as well:

• Popup (Currently working on it)

How to start

npm install react-mapbox-gl --save

Import the component :

// ES6 way
import ReactMapboxGl, { Layer, Feature } from "react-mapbox-gl";

// ES5
var ReactMapboxGl = require("react-mapbox-gl");
var Layer = ReactMapboxGl.Layer;
var Feature = ReactMapboxGl.Feature;

Examples

• See the example to display a big amount of markers : London cycle example
• See the example to display all the availables shapes : All shapes example

Run the examples

• Clone the repository
• Install the dependencies: npm install
• Run the example : npm run example
  • Default port: 8080

Change the example by replacing the example component in example/main.js file.

Notes

Mapbox throw a warning because react-mapbox-gl is using a compiled version of mapbox-gl which is necessary when using webpack for now as long as the sources files requires the node package fs to read the shaders.

API

ReactMapboxGl: React.Component

Display a mapbox webgl map

Render the children elements only when the style of the map is loaded

To use original mapbox API use onStyleLoad property, the callback will receive the map object as a first arguments, then you can add your own logic using mapbox gl API.

Properties

• style : String || Object (required) Mapbox map style
• accessToken : String (required) Mapbox access token.
• center : Array of Number Center the map at the position at initialisation
  • Re-center the map if the value change regarding the prev value or the actual center position flyTo
• zoom : Number Zoom level of the map at initialisation
  • Check the previous value and the new one, if the value changed update the zoom value flyTo
• scrollZoom: See mapbox scrollZoom
• containerStyle : Object The style of the container of the map
• hash : Boolean, Default : false See mapbox doc
• preserveDrawingBuffer: Boolean, Default : false See mapbox doc
• onClick: Function : Triggered whenever user click on the map
  • Function::(map: Object, event: Object)
• onStyleLoad: Function : Listener of mapbox event : map.on("style.load")
  • Function::(map: Object, event: Object)
• onMouseMove: Function : Listen the mouse moving on the map
• onMove: Function : Executed whenever the center of the map change
  • Function::(map: Object, event: Object)
• onMoveEnd: Function : Executed when the move of the map end
  • Function::(map: Object, event: Object)
• onMouseUp : Simple binding of mapbox mouseup event
  • Function::(map: Object, event: Object)
• onDrag : Simple binding of mapbox ondrag event
  • Function::(map: Object, event: Object)

Layer: React.Component

Create a new mapbox layer and create all the sources depending on the children components. All the childrens of a Layer object have to be a Feature component.

Properties

• id : String The id of the layer or generate an incremented number as id
• type : String The type of the features childs element
  • symbol for mapbox Point
  • line for mapbox LineString
  • fill for mapbox Polygon
• layout: Mapbox layout object passed down to mapbox addLayer method mapbox layout api
• paint: Mapbox paint object passed down to mapbox addLayer method mapbox paint api
• sourceOptions: Options object merged to the object used when calling GeoJSONSource method

Feature: React.Component

Display a feature on the map, can only be used when wrapped in a Layer component. The type of the feature is defined at the Layer level. If you want to create a new type, create an associated new layer.

Properties

• coordinates : Array of Number (required) Display the feature at the given position.
• onClick : Function Triggered when user click on the feature
  • Function::(args: Object)
    • args contain the feature object, the map object and the arguments passed by mapbox from the event click
• onHover : Function Triggered when the mouse hover the feature element
  • Function::(args: Object)
    • args contain the feature object, the map object and the arguments passed by mapbox from the event onmousemove
• onEndHover : Function Triggered at the end of the hover state
  • Function::(args: Object)
    • args contain the map object and the arguments passed by mapbox from the event onmousemove

ZoomControl: React.Component

A custom react zoom control component (This component is new and not tested yet, we advise to create your own component)

Properties

• onControlClick : Function triggered when user click on minus or plus button
  • Function::(map: Object, zoomDiff: Number)
• zoomDiff : Number The shift number passed to the callback onControlClick