// Typical usage
var slider = new UnivariateColorSizeSlider({
  statistics: stats,  // object generated from summaryStatistics()
  visualVariables: [ sizeVV, colorVV ]  // size visual variable generated from a univariateColorSize method
}, "sliderDiv");

Property Overview

Property Details

containerString|HTMLElement

The ID or node representing the DOM element containing the widget.

Note that once set, this property cannot be modified afterwards.

declaredClassStringreadonly

The name of the class. The declared class name is formatted as esri.folder.className.

handlesVisibleBoolean

Indicates whether to show the handles of the slider that may be dragged by the user. See the image in the class description to see where handles are typically placed.

Default Value: true

histogramHistogramResult

The histogram associated with the data represented on the slider. This may be generated using the histogram statistics function.

See also:

• histogramVisible

• histogram

Example:

histogram({
  layer: featureLayer,
  field: "fieldName"
}).then(function(histogram){
  // set the histogram to the slider
  slider.histogram = histogram;
});

histogramVisibleBoolean

Indicates whether to show the histogram in the slider UI. See the image in the class description to see where the histogram is typically placed.

Default Value: true

histogramWidthNumber

The width of the histogram in pixels.

Default Value: 100

labelsVisibleBoolean

Indicates whether to show labels in the slider UI. See the image in the class description to see where labels are typically placed.

Default Value: true

maxSizeNumberreadonly

The size in points or pixels with which features will be represented at or above the maxValue.

maxValueNumber

The maximum value or upper bound of the slider. This value overrides the max property of the statistics, but may not be smaller than the upper value of the values array.

This property may be set programmatically or by the user in the widget's UI.

Example:

slider.maxValue = 150;

minSizeNumberreadonly

The size in points or pixels with which features will be represented at or below the minValue.

minValueNumber

The minimum value or lower bound of the slider. This value overrides the min property of the statistics, but may not be greater than the lower value of the values array.

This property may be set programmatically or by the user in the widget's UI.

Example:

slider.minValue = 0.15;

statisticsSummaryStatisticsResult

The summary statistics of the data represented in the slider. This is an object that may be generated from the summaryStatistics statistics function. The min and max values in this object determine the minValue and maxValue of the slider if values for those properties are not already provided.

Example:

univariateColorSize.createVisualVariables({
  layer: featureLayer,
  field: "fieldName",
  basemap: map.basemap
}).then(function(response){
  // set the histogram to the slider
  slider.statistics = statistics;
});

statisticsVisibleBoolean

Indicates whether to show the average of the dataset in the slider UI. See the image in the class description to see where this symbol is typically placed. Hover over this symbol to view the average in the tooltip.

Default Value: true

ticksVisibleBoolean

Indicates whether to show tick marks next to the slider handles. See the image in the class description to see where ticks are typically placed.

Default Value: true

valuesNumber[]readonly

Represents the data values corresponding to the handles on the slider. It is an array of numbers indicating the minDataValue and the maxDataValue of the visual variables represented by the slider.

visibleBoolean

Indicates whether the widget is visible.

Default Value: true

Example:

// Hides the widget in the view
widget.visible = false;

visualVariablesObject[]

The size and color visual variables represented by the slider. Since this slider represents univariate visualizations, both color and size visual variables must represent data from the same field or expression and be conicident. In other words, the lower stop or bound of the color visual variable must match the lower bound (or minDataValue) of the size visual variable. The same is true of the upper bounds of both visual variables.

These must be set initially on the slider for it to render in the view. Both visual variables may be created manually (see snippet below) or generated from the univariateColorSize helper methods. New coincident color and size visual variables are created each time the user slides the handles.

Example:

slider.visualVariables = [{
  type: "color",
  field: "count",
  stops: [
    { value: 0, color: "#eee8d6" },
    { value: 20, color: "#bcadda" },
    { value: 40, color: "#9a85dd" },
    { value: 60, color: "#7062b9" },
    { value: 80, color: "#453e94" }
  ]
}, {
  type: "size",
  field: "count",  // same field as color visual variable
  minSize: "6px",
  maxSize: "50px",
  minDataValue: 0,  // matches the value of the lower stop
  maxDataValue: 80  // matches the value of the upper stop
}];

Method Overview

Method Details

destroy()

Destroys the widget instance. Call this method when the widget is no longer needed by the application.

Example:

widget.destroy();

Event Overview

Event Details

data-change

Fires on each handle value change (on slide) and change to the minValue or maxValue of the slider.

Example:

slider.on("data-change", function(){
  var renderer = layer.renderer.clone();
  renderer.visualVariables = slider.visualVariables;
  layer.renderer = renderer;
});

data-value-change

Fires on each change to the minValue or maxValue of the slider. This event is useful for updating the Legend when the upper and lower bounds of the stops are altered.

Example:

slider.on("data-value-change", function(){
  // execute your code here
});

handle-value-change

Fires when a handle value changes either by typing a new value or on slide end.

See also:

• Sample: Generate a continuous color and size visualization

Example:

slider.on("handle-value-change", function(){
  // set the new visual variables on the renderer for immediate feedback
  var renderer = layer.renderer.clone();
  renderer.visualVariables = slider.visualVariables;
  layer.renderer = renderer;
});