Skip to content

React component that wraps the ArcGIS JS API 4.x SceneView

License

Notifications You must be signed in to change notification settings

Esri/react-sceneview

Repository files navigation

DEPRECATED

This project is no longer actively maintained.


react-sceneview

A simple Esri SceneView react component that builds on the ArcGIS API for JavaScript.

Table of Contents

Installing

$ npm install --save react-sceneview

Then, just import to your React component:

import { SceneView, Scene } from 'react-sceneview';

Examples

import React from 'react';
import { render } from 'react-dom';
import { SceneView, Scene, Webscene } from 'react-sceneview';

render(
  <SceneView id="sceneview">
    <Scene>
      <Webscene  portalItem={{ id: '34859cee6739438d93262a5aa91bf834' }} />
    </Scene>
  </SceneView>,
  document.getElementById('root'),
);

Add a WebScene and/or individual layers:

<SceneView id="sceneview">
  <Scene>
    <Layer id="buildings" layerType="scene" url={SCENE_LAYER_URL} />
    <Layer id="districts" layerType="feature" url={FEATURE_LAYER_URL} />
  </Scene>
</SceneView>

Supports various features such as UI widgets, custom basemaps, selection, highlights, definitionExpression, etc...

<SceneView id="sceneview" onClick={handleSelect}>
  <UI.Zoom position="top-left" />
  <Scene>
    <CustomBasemap portalItem={{ id: 'ae53cf192181425ab999e8a19e41a6dc' }} />
    <Layer id="1" url={URL1} layerType="scene" selectable highlight={selection} />
    <Layer id="2" url={URL2} layerType="feature" definitionExpression="Scenario IN (1,2)" />
    <Layer id="3" url={URL3} layerType="feature" visible={false} />
  </Scene>
</SceneView>

Dynamically add and remove layers:

  <SceneView
    id="sceneview"
  >
    <Scene>
      {layers.map(({ layerId, ...layerSettings }) => (
        <Layer
          key={layerId}
          id={layerId}
          {...layerSettings}
        />
      ))}
    </Scene>
  </SceneView>

Supports client-side graphics: dynamically add and remove graphics from feature layer.

<SceneView id="sceneview">
  <Scene>
    <Layer
      id="points"
      layerType="feature"
      geometryType="polygon"
      fields={fields}
      objectIdField="OID"
    >
      {graphics.map(graphic => (
        <Graphic geometry={graphic.geometry} attributes={graphic.attributes} symbol={graphic.symbol} />
      )}
    </Layer>
  </Scene>
  <DrawingTool onDraw={handleDrawUpdate} />
</SceneView>

Props

SceneView

Name Type Default Description
id string Unique id of this sceneview. This id is used to handle hot module reloading and other component refreshes.
environment object Environment parameters of the sceneview.
goTo       object Sets the view to a given target camera or geometry.
onClick function Callback fired after a click in the SceneView. Returns hit test results.
onMouseMove function Callback fired after a mouse move (hover) in the SceneView. Returns hit test results.
onCameraChange function A callback fired after the camera has been changed. Returns the new camera object.

Scene

Name Type Default Description
basemap string gray-vector Specifies a basemap for the map. One of ['streets', 'satellite', 'hybrid', 'topo', 'gray', 'dark-gray', 'oceans', 'national-geographic', 'terrain', 'osm', 'dark-gray-vector', 'gray-vector', 'streets-vector', 'topo-vector', 'streets-night-vector', 'streets-relief-vector', 'streets-navigation-vector'].
ground string world-elevation Specifies the surface properties for the map.
initialViewProperties object This object contains properties such as viewpoint, spatialReference, viewingMode, and environment that should be applied to the SceneView when the scene loads.

Layer

Name Type Default Description
id string Unique id used to reference the layer.
url string URL of scene or feature layer. If omitted, a layer source is required.
visible       bool true Indicates if the layer is visible in the SceneView.
selectable bool false Indicates if features on this layer are returned in onClick and onMouseMove events, as well as from the selection tools.
highlight array [] Feature object ids to be highlighted (usually selection).
definitionExpression string The SQL where clause used to filter features on the client.
renderer object The renderer assigned to the layer, supplied as an Auto-casting object.
rendererJson object The renderer assigned to the layer, supplied as a JSON object generated from a product in the ArcGIS platform.
labelingInfo object The label definition for this layer, specified as an array of LabelClass.
labelsVisible bool false Indicates whether to display labels for this layer.
refresh number Change value to refresh the layer.
outFields array Attribute fields which will be exposed (e.g., through selection callbacks).

If using client-side graphics, the following props are required:

Name Type Default Description
geometryType string Geometry type when using client-side graphics.
fields array Attribute fields when using client-side graphics.
objectIdField string Object id field when using client-side graphics.

Graphic

Name Type Default Description
geometry object The geometry that defines the graphic's location.
attributes array Name-value pairs of fields and field values associated with the graphic.
symbol object The Symbol for the graphic.

CustomBasemap

Name Type Default Description
portalItem object The portal item (WebMap or WebScene) containing the custom base map.

CustomElevationLayer

Name Type Default Description
url string URL pointing to the Elevation layer resource on an ArcGIS Image Server.

UI.Zoom, UI.Compass, UI.NavigationToggle

Name Type Default Description
position string Position of the UI widget. One of ['top-left', 'top-right', 'bottom-right', 'bottom-left']. Default is 'top-left'.

Issues

Find a bug or want to request a new feature? Please let us know by submitting an issue.

Contributing

Esri welcomes contributions from anyone and everyone. Please see our guidelines for contributing.

Licensing

Copyright 2019 Esri

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's license.txt file.