ArcGIS JS API Measurement widget change measurement units text?

Question

The ArcGIS Server JavaScript API has a Measurement widget, which reports the area or length of a shape drawn on the map.

The default metric labels use the American spelling of "Sq Kilometers" and "Kilometers", etc.

var measurement = new Measurement({
        map: map,
        defaultAreaUnit: units.SQUARE_KILOMETERS,
        defaultLengthUnit: units.KILOMETERS
}, dom.byId("measurementDiv"));


measurement.startup();

Is it possible to change the default text "Square Kilometers" shown by default to a custom text (like "km²")?

The Measurement widget doesn't seem to have any customisation options which would accomplish this.

Answer 1

You can change this string, like many other strings in the ArcGIS API for JavaScript, by taking advantage/overwriting the localizable strings.

This is documented at the bottom of the localization doc - https://developers.arcgis.com/javascript/3/jshelp/localization.html

require([..., "dojo/i18n!esri/nls/jsapi", ... ],
  function(..., bundle, ...) {
    bundle.widgets.measurement.NLS_area_sq_kilometers = "km<sup>2</sup>";
    // or bundle.widgets.measurement.NLS_area_sq_kilometers = "km2";
  }
);