mirror of
https://github.com/zhigang1992/DefinitelyTyped.git
synced 2026-06-07 19:59:00 +08:00
Merge pull request #24125 from rimig/rimig/react-map-gl
Add types for react-map-gl
This commit is contained in:
Armando Aguirre
257
types/react-map-gl/index.d.ts
vendored
Normal file
257
types/react-map-gl/index.d.ts
vendored
Normal file
@@ -0,0 +1,257 @@
|
||||
// Type definitions for react-map-gl 3.2
|
||||
// Project: https://github.com/uber/react-map-gl#readme
|
||||
// Definitions by: Robert Imig <https://github.com/rimig>
|
||||
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
|
||||
// TypeScript Version: 2.6
|
||||
|
||||
import * as React from "react";
|
||||
import * as MapboxGL from "mapbox-gl";
|
||||
import * as GeoJSON from "geojson";
|
||||
|
||||
export interface Viewport {
|
||||
bearing: number;
|
||||
isDragging: boolean;
|
||||
latitude: number;
|
||||
longitude: number;
|
||||
pitch?: number;
|
||||
startBearing?: number;
|
||||
startDragLngLat?: number[];
|
||||
startPitch?: number;
|
||||
zoom: number;
|
||||
}
|
||||
|
||||
export interface StaticMapProps {
|
||||
/**
|
||||
* Mapbox API access token for MapboxGL.
|
||||
* Required when using Mapbox vector tiles/styles Mapbox WebGL context creation option.
|
||||
* Useful when you want to export the canvas as a PNG
|
||||
*/
|
||||
mapboxApiAccessToken: string;
|
||||
|
||||
/** The Mapbox style. A string url or a MapboxGL style object (regular JS object or Immutable.Map). */
|
||||
mapStyle?: string; // TODO can also be immutable map
|
||||
|
||||
/** The width of the map. */
|
||||
width: number;
|
||||
/** The height of the map. */
|
||||
height: number;
|
||||
/** The latitude of the center of the map. */
|
||||
|
||||
latitude: number;
|
||||
/** The longitude of the center of the map. */
|
||||
longitude: number;
|
||||
/** The tile zoom level of the map. Bounded implicitly by default minZoom and maxZoom of MapboxGL. */
|
||||
|
||||
zoom: number;
|
||||
/** Specify the bearing of the viewport */
|
||||
bearing?: number;
|
||||
/** Specify the pitch of the viewport */
|
||||
pitch?: number;
|
||||
/** Altitude of the viewport camera. Default 1.5 "screen heights" */
|
||||
altitude?: number; // Note: Non-public API, see https://github.com/mapbox/mapbox-gl-js/issues/1137
|
||||
|
||||
/**
|
||||
* Whether the map is visible.
|
||||
* Unmounting and re-mounting a Mapbox instance is known to be costly.
|
||||
* This option offers a way to hide a map using CSS style.
|
||||
*/
|
||||
visible?: boolean;
|
||||
|
||||
/**
|
||||
* Equivalent to Mapbox's preserveDrawingBuffer option.
|
||||
* If true, the map's canvas can be exported to a PNG using map.getCanvas().toDataURL().
|
||||
*/
|
||||
preserveDrawingBuffer?: boolean;
|
||||
|
||||
/** Show attribution control or not. */
|
||||
attributionControl?: boolean;
|
||||
|
||||
/**
|
||||
* If mapStyle is assigned an Immutable object, when the prop changes,
|
||||
* StaticMap can diff between the two values and call the appropriate Mapbox API such as
|
||||
* addLayer, removeLayer, setStyle, setData, etc.
|
||||
*
|
||||
* This allows apps to update data sources and layer styles efficiently.
|
||||
* In use cases such as animation or dynamic showing/hiding layers, style diffing prevents the map
|
||||
* from reloading and flickering when the map style changes.
|
||||
*
|
||||
* There are known issues with style diffing. As stopgap, use this option to prevent style diffing.
|
||||
*/
|
||||
preventStyleDiffing?: boolean;
|
||||
|
||||
/**
|
||||
* This prop is experimental.
|
||||
* If true, when the map component is unmounted, instead of calling remove on the Mapbox map instance, save it for later reuse.
|
||||
* This will avoid repeatedly creating new Mapbox map instances if possible.
|
||||
* Applications that frequently mount and unmount maps may try this prop to help work around a mapbox-gl resource leak issue that can lead to a browser crash in certain situations.
|
||||
*/
|
||||
resuseMaps?: boolean;
|
||||
|
||||
/**
|
||||
* A callback run when the map emits a load event.
|
||||
*/
|
||||
onLoad?: () => void;
|
||||
|
||||
/**
|
||||
* A callback run when the map emits an error event.
|
||||
*/
|
||||
onError?: () => void;
|
||||
}
|
||||
|
||||
export class StaticMap extends React.Component<StaticMapProps> {
|
||||
/**
|
||||
* Returns the Mapbox instance if initialized. The Map instance will have full access to MapboxGL's API.
|
||||
*/
|
||||
getMap(): MapboxGL.Map;
|
||||
|
||||
/**
|
||||
* Use Mapbox's queryRenderedFeatures API to find features at point or in a bounding box.
|
||||
* If the parameters argument is not specified, only queries the layers with the interactive property in the layer style.
|
||||
*/
|
||||
queryRenderedFeatures(geometry?: MapboxGL.PointLike | MapboxGL.PointLike[], parameters?: { layers?: string[], filter?: any[] }): Array<GeoJSON.Feature<GeoJSON.GeometryObject>>;
|
||||
}
|
||||
|
||||
export interface InteractiveMapProps extends StaticMapProps {
|
||||
/** Max zoom level */
|
||||
maxZoom?: number;
|
||||
/** Min zoom level */
|
||||
minZoom?: number;
|
||||
/** Max pitch in degrees */
|
||||
maxPitch?: number;
|
||||
/** Min pitch in degrees */
|
||||
minPitch?: number;
|
||||
|
||||
/** Scroll to zoom */
|
||||
scrollZoom?: boolean;
|
||||
/** Drag to pan */
|
||||
dragPan?: boolean;
|
||||
/** Drag to rotate */
|
||||
dragRotate?: boolean;
|
||||
/** Double click to zoom */
|
||||
doubleClickZoom?: boolean;
|
||||
/** Enable multitouch zoom. */
|
||||
touchZoom?: boolean;
|
||||
/** Enable multitouch rotate. */
|
||||
touchRotate?: boolean;
|
||||
/** Radius to detect features around a clicked point */
|
||||
clickRadius?: number;
|
||||
|
||||
/**
|
||||
* Callback that is fired when the user interacted with the map.
|
||||
* The object passed to the callback contains viewport properties such as longitude, latitude, zoom etc.
|
||||
*
|
||||
* If the map is intended to be interactive, the app use this prop to listen to map updates and update the props accordingly.
|
||||
*/
|
||||
onViewportChange?: (viewport: Viewport) => void;
|
||||
|
||||
/**
|
||||
* Called when the map is hovered over.
|
||||
* event - The mouse event.
|
||||
* lngLat - The coordinates of the pointer
|
||||
* features - The features under the pointer, using Mapbox's
|
||||
* queryRenderedFeatures API:
|
||||
* https://www.mapbox.com/mapbox-gl-js/api/#Map#queryRenderedFeatures
|
||||
* To make a layer interactive, set the `interactive` property in the
|
||||
* layer style to `true`. See Mapbox's style spec
|
||||
* https://www.mapbox.com/mapbox-gl-style-spec/#layer-interactive
|
||||
*/
|
||||
onHover?: (event: any, lngLat: number[], features: any) => void;
|
||||
|
||||
/**
|
||||
* Called when the map is clicked.
|
||||
* queryRenderedFeatures API:
|
||||
* https://www.mapbox.com/mapbox-gl-js/api/#Map#queryRenderedFeatures
|
||||
* To make a layer interactive, set the `interactive` property in the
|
||||
* layer style to `true`. See Mapbox's style spec
|
||||
* https://www.mapbox.com/mapbox-gl-style-spec/#layer-interactive
|
||||
*/
|
||||
onClick?: (event: any, lngLat: number[], features: any) => void;
|
||||
|
||||
/** Accessor that returns a cursor style to show interactive state */
|
||||
getCursor?: () => any;
|
||||
}
|
||||
|
||||
export class InteractiveMap extends React.Component<InteractiveMapProps> {
|
||||
_map: MapboxGL.Map;
|
||||
|
||||
/** Returns the Mapbox Map Instance */
|
||||
getMap(): MapboxGL.Map;
|
||||
}
|
||||
|
||||
/**
|
||||
*
|
||||
* React Map Overlays
|
||||
*
|
||||
*/
|
||||
|
||||
export interface BaseControlProps {
|
||||
/** Event handling */
|
||||
captureScroll?: boolean;
|
||||
/** Stop map pan & rotate */
|
||||
captureDrag?: boolean;
|
||||
/** Stop map click */
|
||||
captureClick?: boolean;
|
||||
/** Stop map double click */
|
||||
captureDoubleClick?: boolean;
|
||||
}
|
||||
|
||||
export class BaseControl<T extends BaseControlProps> extends React.Component<T> { }
|
||||
|
||||
/**
|
||||
* Allows applications to overlay data on top of maps using a HTML container.
|
||||
*/
|
||||
export class HTMLOverlay extends BaseControl<HTMLOverlayProps> { }
|
||||
|
||||
export interface HTMLRedrawOptions {
|
||||
/** width {Number} - width of the viewport */
|
||||
width: number;
|
||||
/** height {Number} - height of the viewport */
|
||||
height: number;
|
||||
/** project {Function} - get screen position [x, y] from geo coordinates [lng, lat] */
|
||||
project: (lnglat: number[]) => number[];
|
||||
/** unproject {Function} - get geo coordinates [lng, lat] from screen position [x, y] */
|
||||
unproject: (xy: number[]) => number[];
|
||||
}
|
||||
|
||||
export interface HTMLOverlayProps extends BaseControlProps {
|
||||
/**
|
||||
* Called every time the map updates.
|
||||
*/
|
||||
redraw: (opts: HTMLRedrawOptions) => void;
|
||||
/** Additional css styles of the div container. */
|
||||
style?: React.CSSProperties;
|
||||
}
|
||||
|
||||
/**
|
||||
* Allows applications to overlay data on top of maps using a canvas.
|
||||
*/
|
||||
export class CanvasOverlay extends BaseControl<CanvasOverlayProps> { }
|
||||
|
||||
export interface CanvasRedrawOptions extends HTMLRedrawOptions {
|
||||
/** ctx {CanvasRenderingContext2D} - rendering context of the canvas */
|
||||
ctx: CanvasRenderingContext2D;
|
||||
}
|
||||
|
||||
export interface CanvasOverlayProps extends BaseControlProps {
|
||||
/**
|
||||
* Called every time the map updates.
|
||||
*/
|
||||
redraw: (opts: CanvasRedrawOptions) => void;
|
||||
}
|
||||
|
||||
/**
|
||||
* Allows applications to overlay data on top of maps using a SVG container.
|
||||
*/
|
||||
export class SVGOverlay extends BaseControl<SVGOverlayProps> { }
|
||||
|
||||
// tslint:disable-next-line:no-empty-interface
|
||||
export interface SVGRedrawOptions extends HTMLRedrawOptions { }
|
||||
|
||||
export interface SVGOverlayProps extends BaseControlProps {
|
||||
/**
|
||||
* Called every time the map updates.
|
||||
*/
|
||||
redraw: (opts: SVGRedrawOptions) => void;
|
||||
/** Additional css styles of the svg container. */
|
||||
style?: React.CSSProperties;
|
||||
}
|
||||
124
types/react-map-gl/react-map-gl-tests.tsx
Normal file
124
types/react-map-gl/react-map-gl-tests.tsx
Normal file
@@ -0,0 +1,124 @@
|
||||
import * as React from "react";
|
||||
import {
|
||||
Viewport,
|
||||
StaticMapProps,
|
||||
InteractiveMapProps,
|
||||
InteractiveMap,
|
||||
CanvasOverlay,
|
||||
SVGOverlay,
|
||||
HTMLOverlay,
|
||||
HTMLOverlayProps,
|
||||
CanvasRedrawOptions,
|
||||
HTMLRedrawOptions,
|
||||
SVGOverlayProps,
|
||||
SVGRedrawOptions,
|
||||
StaticMap
|
||||
} from 'react-map-gl';
|
||||
import * as MapboxGL from "mapbox-gl";
|
||||
|
||||
interface MyMapState {
|
||||
viewport: Viewport;
|
||||
}
|
||||
|
||||
class MyMap extends React.Component<{}, MyMapState> {
|
||||
state: MyMapState = {
|
||||
viewport: {
|
||||
bearing: 0,
|
||||
isDragging: false,
|
||||
latitude: 0,
|
||||
longitude: 0,
|
||||
zoom: 3,
|
||||
}
|
||||
};
|
||||
|
||||
private map: MapboxGL.Map;
|
||||
|
||||
render() {
|
||||
return (
|
||||
<div>
|
||||
<InteractiveMap
|
||||
{...this.state.viewport}
|
||||
mapboxApiAccessToken="pk.test"
|
||||
height={400}
|
||||
width={400}
|
||||
ref={this.setRefInteractive}
|
||||
>
|
||||
<CanvasOverlay
|
||||
redraw={(opts: CanvasRedrawOptions) => {
|
||||
const {
|
||||
ctx,
|
||||
height,
|
||||
project,
|
||||
unproject,
|
||||
width,
|
||||
} = opts;
|
||||
const xy: number[] = unproject(project([20, 20]));
|
||||
ctx.clearRect(0, 0, width, height);
|
||||
}}
|
||||
/>
|
||||
<CanvasOverlay
|
||||
redraw={(opts: CanvasRedrawOptions) => {}}
|
||||
captureScroll={true}
|
||||
captureDrag={true}
|
||||
captureClick={true}
|
||||
captureDoubleClick={true}
|
||||
/>
|
||||
<SVGOverlay
|
||||
redraw={() => {}}
|
||||
/>
|
||||
<SVGOverlay
|
||||
redraw={(opts: SVGRedrawOptions) => {
|
||||
const {
|
||||
height,
|
||||
project,
|
||||
unproject,
|
||||
width,
|
||||
} = opts;
|
||||
const xy: number[] = unproject(project([20, 20]));
|
||||
}}
|
||||
captureScroll={true}
|
||||
captureDrag={true}
|
||||
captureClick={true}
|
||||
captureDoubleClick={true}
|
||||
/>
|
||||
<HTMLOverlay
|
||||
redraw={() => {}}
|
||||
/>
|
||||
<HTMLOverlay
|
||||
redraw={(opts: HTMLRedrawOptions) => {
|
||||
const {
|
||||
height,
|
||||
project,
|
||||
unproject,
|
||||
width,
|
||||
} = opts;
|
||||
const xy: number[] = unproject(project([20, 20]));
|
||||
}}
|
||||
style={{
|
||||
border: "2px solid black"
|
||||
}}
|
||||
captureScroll={true}
|
||||
captureDrag={true}
|
||||
captureClick={true}
|
||||
captureDoubleClick={true}
|
||||
/>
|
||||
</InteractiveMap>
|
||||
<StaticMap
|
||||
{...this.state.viewport}
|
||||
mapboxApiAccessToken="pk.test"
|
||||
height={400}
|
||||
width={400}
|
||||
ref={this.setRefStatic}
|
||||
/>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
private readonly setRefInteractive = (el: InteractiveMap) => {
|
||||
this.map = el.getMap();
|
||||
}
|
||||
|
||||
private readonly setRefStatic = (el: StaticMap) => {
|
||||
this.map = el.getMap();
|
||||
}
|
||||
}
|
||||
25
types/react-map-gl/tsconfig.json
Normal file
25
types/react-map-gl/tsconfig.json
Normal file
@@ -0,0 +1,25 @@
|
||||
{
|
||||
"compilerOptions": {
|
||||
"module": "commonjs",
|
||||
"lib": [
|
||||
"es6",
|
||||
"dom"
|
||||
],
|
||||
"jsx": "react",
|
||||
"noImplicitAny": true,
|
||||
"noImplicitThis": true,
|
||||
"strictNullChecks": true,
|
||||
"strictFunctionTypes": true,
|
||||
"baseUrl": "../",
|
||||
"typeRoots": [
|
||||
"../"
|
||||
],
|
||||
"types": [],
|
||||
"noEmit": true,
|
||||
"forceConsistentCasingInFileNames": true
|
||||
},
|
||||
"files": [
|
||||
"index.d.ts",
|
||||
"react-map-gl-tests.tsx"
|
||||
]
|
||||
}
|
||||
1
types/react-map-gl/tslint.json
Normal file
1
types/react-map-gl/tslint.json
Normal file
@@ -0,0 +1 @@
|
||||
{ "extends": "dtslint/dt.json" }
|
||||
Reference in New Issue
Block a user