Wondering what’s next for npm?Check out our public roadmap! »

    @arcgis/core

    4.19.3 • Public • Published

    @arcgis/core

    A minified, unbuilt version of the ArcGIS API for JavaScript ES modules.

    Features

    You can install these modules via npm and then use them directly in a framework such as React, Vue.js or Angular. Or, you can also create your own custom builds with Webpack or rollup.js.

    Sample applications can be found at github.com/jsapi-resources/.

    Get started

    Install the modules into your project:

    npm install @arcgis/core
    

    Configure CSS

    Set the CSS to the same version as the installed API modules. You can verify the installed API version by running npm list @arcgis/core. If you are working with local assets skip to the Manage assets locally section.

    The first example shows importing CSS for production API version 4.19.0:

    index.css

    @import "https://js.arcgis.com/4.19/@arcgis/core/assets/esri/themes/light/main.css";

    The second example shows importing CSS for next API version 4.19.0-next.20210324:

    index.css

    @import "https://cdn.jsdelivr.net/npm/@arcgis/core@4.19.0-next.20210324/assets/esri/themes/light/main.css";

    Working with assets

    For most local builds, the API's assets are automatically pulled from a CDN at runtime and there is no need for additional configuration. The assets include styles, images, web workers, wasm and localization files. Production versions of the API use the ArcGIS CDN, and next builds (e.g. 4.19.0-next.20210324) use jsDelivr, similar to the CSS example above.

    Manage assets locally

    If you need to manage the assets locally, copy them into your project from /node_modules/@arcgis/core/assets, and then set config.assetsPath to insure requests for assets are resolved correctly. A simple way to accomplish this is to configure an npm script that runs during your build process. For example, use npm to install ncp and configure a script in package.json to copy the folder.

    Here’s a React example:

    package.json

    {
      "scripts": {
        "start": "ncp ./node_modules/@arcgis/core/assets ./public/assets && react-scripts start",
        "build": "ncp ./node_modules/@arcgis/core/assets ./public/assets && react-scripts build",
      }
    }

    App.js

    import esriConfig from "@arcgis/core/config.js";
    esriConfig.assetsPath = "./assets"; 

    index.css

    @import "@arcgis/core/assets/esri/themes/light/main.css";

    For Angular, copy the asset files by configuring the architect/build/options/assets section of angular.json, for example:

    angular.json

    {
      "assets": [
        {
          "glob": "**/*",
          "input": "node_modules/@arcgis/core/assets",
          "output": "/assets/"
        }
      ]
    }

    app.component.ts

    import esriConfig from "@arcgis/core/config.js";
    esriConfig.assetsPath = "./assets"; 

    app.component.css

    @import "@arcgis/core/assets/esri/themes/light/main.css";

    For other installations, consider using this npm script as a starting point:

    package.json

    {
      "script": {
        "copy": "cp -R ./node_modules/@arcgis/core/assets ./dist/assets"
      }
    }

    Windows users can use xcopy or ncp for any platform.

    Requirements

    Use of the ArcGIS API for JavaScript is subject to the terms described in the product-specific terms of use. Learn more about licensing here.

    Resources

    Issues

    Licensing

    COPYRIGHT © 2021 Esri

    All rights reserved under the copyright laws of the United States and applicable international laws, treaties, and conventions.

    This material is licensed for use under the Esri Master License Agreement (MLA), and is bound by the terms of that agreement. You may redistribute and use this code without modification, provided you adhere to the terms of the MLA and include this copyright notice.

    For additional information, contact: Environmental Systems Research Institute, Inc. Attn: Contracts and Legal Services Department 380 New York Street Redlands, California, USA 92373 USA

    email: contracts@esri.com

    Install

    npm i @arcgis/core

    DownloadsWeekly Downloads

    4,112

    Version

    4.19.3

    License

    SEE LICENSE IN copyright.txt

    Unpacked Size

    38.7 MB

    Total Files

    6878

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar