Now Package More

    TypeScript icon, indicating that this package has built-in type declarations

    1.0.0 • Public • Published

    Calcite Components React

    A set of React components that wrap Calcite Components. An application using this package is provided in the calcite-components-examples repo.


    npm install --save @esri/calcite-components-react

    This package includes the compatible version of the main component library as a dependency, so no need to install @esri/calcite-components separately.

    Choose a build

    There are two builds that are provided by the standard calcite-components package.

    Custom Elements build

    Custom Elements is the recomended build when using frontend frameworks, such as React. To use this build, you will need to set the path to the calcite-components assets. You can either use local assets, which will be explained in a subsequent step, or assets hosted on a CDN.

    import { setAssetPath } from "@esri/calcite-components/dist/components";
    // Local assets
    // CDN hosted assets
    // setAssetPath("");

    Next, you need to import each component you use from the standard calcite-component package's custom elements build. This will automatically define the custom elements on the window. Then import the same components from calcite-components-react.

    import "@esri/calcite-components/dist/components/calcite-button";
    import "@esri/calcite-components/dist/components/calcite-icon";
    import "@esri/calcite-components/dist/components/calcite-slider";
    import {
    } from "@esri/calcite-components-react";

    Dist build

    When using the Dist build, you'll need to manually define the custom elements on the window. You can also choose between local and CDN hosted assets.

    import { defineCustomElements } from "@esri/calcite-components/dist/loader";
    // Local assets
    // CDN hosted assets
    // defineCustomElements(window, {
    //   resourcesUrl: ""
    // });

    Since you manually defined the custom elements on the window, you only need to import the individual components from calcite-components-react.

    import {
    } from "@esri/calcite-components-react";

    Import stylesheet

    Import the global stylesheet into your app (only do this once):

    import "@esri/calcite-components/dist/calcite/calcite.css";

    Copy Assets

    Some components (icon, date-picker) rely on assets being available at a particular path. If using assets locally, you'll need to copy these over to your public folder. Something like:

    cp -r node_modules/@esri/calcite-components/dist/calcite/assets/* ./public/assets/

    Why not just use the web components directly?

    Because React uses a synthetic event system, the custom events emitted from calcite components won't work with JSX in React. For example, say you want to update some value when the calcite-slider component changes. When using the standard web components, you need to save a ref to the element, and add a listener:

    const sliderEl = useRef(null);
    const [sliderValue, setSliderValue] = useState(50);
    function onUpdate(event) {
    // need to access the dom node to set custom event listeners for props that aren't strings / numbers
      (_) => {
        sliderEl.current.addEventListener("calciteSliderUpdate", onUpdate);

    Using calcite-components-react, these events are connected for you:

    const [sliderValue, setSliderValue] = useState(50);
    <CalciteSlider onCalciteSliderUpdate={(e) => setSliderValue(} />;

    If you're using TypeScript, you'll also get increased type safety for your event listeners, props, etc.


    We welcome contributions to this project. See the main calcite-components for an overview of contribution guidelines.


    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.

    See use restrictions at

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





    npm i @esri/calcite-components-react

    DownloadsWeekly Downloads






    Unpacked Size

    71 kB

    Total Files


    Last publish


    • kit12303
    • jordantsanz
    • allieraney
    • robert.vo
    • noahmulfinger
    • ssylvia
    • paulcpederson
    • jgravois
    • patrickarlt
    • nixta
    • odoe
    • jwasilgeo
    • tomwayson
    • benstoltz
    • dbouwman
    • thollingshead
    • hhkaos
    • dpaddock
    • esri_dev
    • driskull
    • jamin415
    • katelynseitz
    • jpurusho
    • rlibed
    • mtschudi
    • ajturner
    • gavinr
    • kellyhutchins
    • mjuniper
    • john4818
    • pr3tori4n
    • gbrown-gis
    • haoliang
    • macandcheese
    • jcfranco
    • alan0002
    • richgwozdz
    • rweber.esri
    • vivzhang
    • juliannemarik
    • drspacemanphd