Hide Table of Contents
View Gauge sample in sandbox
Gauge

Description

Version 3.0 of the ArcGIS API for JavaScript introduced the Gauge dijit. One of the goals in introducing this widget is to streamline the process of building dashboard-like apps.

The object passed to the Gauge constructor can optionally include several parameters. It is recommended to supply as many of these as possible. If an app is using multiple gauges referencing the same feature layer, only one of the gauges should be created using the options.layer parameter.

This sample shows how to use a single Gauge widget with a single feature layer.

Code

<!DOCTYPE html>
  <html>
  <head>
  <title>Gauge</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <meta name="viewport" content="initial-scale=1, maximum-scale=1,user-scalable=no">

  <link rel="stylesheet" href="https://js.arcgis.com/3.46/esri/css/esri.css">
  <style>
      html, body, #map { height: 100%; width: 100%; margin: 0; padding: 0; }
      #dashboard { 
        background:rgba(56,56,56,.5);
        color: #fff;
        font-family: arial;
        height: auto; 
        overflow: hidden;
        padding: 5px;
        position: absolute;
        right: 30px;
        text-align: center;
        top: 30px;
        width: 300px;
        z-index: 40;
        border-radius: 4px;
        border: 1px solid rgb(56,56,56);
      }
      #dashboardWidgets {
        background: #fff;
        color: #888;
        margin: 0 auto;
        text-align: left;
      }
  </style>

  <script>var dojoConfig = { parseOnLoad: true };</script>
  <script src="https://js.arcgis.com/3.46/"></script>
  <script>
    var map;
    
    require([
      "esri/map",
      "esri/layers/FeatureLayer",
      "esri/layers/GraphicsLayer",
      "esri/symbols/SimpleMarkerSymbol",
      "esri/graphic",
      "esri/dijit/Gauge",
      "dojo/domReady!"
      ], function (Map, FeatureLayer, GraphicsLayer, SimpleMarkerSymbol, Graphic, Gauge) {
       

      map = new Map("map",{
        basemap: "oceans",
        center: [-50.6, 46.1],
        zoom: 4,
        slider: false
      });

     var featuresUrl = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Hurricanes/MapServer/0";


      var fl = new FeatureLayer(featuresUrl, {
          "id": "hurricanes",
          "mode": FeatureLayer.MODE_ONDEMAND, 
          "outFields": ["OBJECTID", "WINDSPEED", "DAY", "EVENTID"]
      });

      fl.on("load",createGauge);
      map.addLayer(fl);

      function createGauge(fl){
        // create JSON and pass it to the Gauge ctor
        var gaugeParams = {
          "caption": "Hurricane windspeed.",
          "color": "#c0c",
          "dataField": "WINDSPEED", // name of the attribute used for the gauge value
          "dataFormat": "value",
          "dataLabelField": "EVENTID",
          "layer": fl.layer,
          "maxDataValue": 120, // gauge max value, not used when dataFormat is "percentage" 
          "noFeatureLabel": "No name",
          "title": "Atlantic Hurricanes(2000)",
          "unitLabel": " MPH"
        };

        var gauge = new Gauge(gaugeParams, "gaugeDiv");
        gauge.startup();

        //Set up mouse over highlighting
        var hGraphics = new GraphicsLayer({id:"highlights"});
        map.addLayer(hGraphics);

        var highlight = new SimpleMarkerSymbol().setColor(gaugeParams.color).setSize(12);

        fl.layer.on("mouse-over", function(e){
          hGraphics.clear();
          hGraphics.add(new Graphic(e.graphic.geometry, highlight));
        });
      }

    });
  </script>

  </head>

  <body>
    <div id="map">
       <div id="dashboard">
         <span style='text-align:center;'>Dashboard</span>
         <div id="dashboardWidgets">
            <div id="gaugeDiv"></div>
         </div>
       </div>
    </div>
  </body>
  </html>
 
          
Show Modal