Method Overview

Method Details

cloneScheme(scheme){ColorScheme}

Clones a color scheme object.

Parameter:

scheme ColorScheme The color scheme object to clone.

Returns:

Type	Description
ColorScheme	Returns a clone of the given color scheme object.

Example:

// clones the primary scheme returned from the getSchemes() method
var colorScheme = primaryScheme.clone();

flipColors(scheme){ColorScheme}

Flips the colors in reverse order of the input color scheme.

Parameter:

scheme ColorScheme The color scheme to reverse.

Returns:

Type	Description
ColorScheme	Returns the input color scheme with its colors in reverse order.

Example:

// reverses the order of colors in a primary scheme
// obtained from the getSchemes() method
var flippedScheme = colorSchemes.flipColors(primaryScheme);

getMatchingSchemes(theme, colors, geometryType, worldScale, view){ColorScheme[]}

Since: ArcGIS API for JavaScript 4.9

Returns all schemes matching the given color ramp.

Parameters:

theme String The name of the theme from which to get color schemes.

colors Color[] An array of colors used to match with schemes for the given theme.

geometryType String The geometry type of the layer for which the color scheme will be applied.

worldScale Boolean optional Indicates whether 3D volumetric symbols will be used in the visualization.

view SceneView optional The SceneView instance used to calculate the suggested sizes of the symbols. This is required for 3D visualizations.

Returns:

Type	Description
ColorScheme[]	An array of color schemes that match the given colors.

getSchemes(params){ColorSchemes}

Returns a primary scheme and secondary schemes defining symbol properties for data-driven color visualizions in a FeatureLayer. The basemap parameter determines the color schemes of the graphics used to visualize each feature. The geometryType determines which type of symbol to return.

Parameters:

params Object See the table below for details of each parameter that may be passed to this function. Specification: basemap String|Basemap The basemap to pair with the visualization. This value indicates the best symbol colors for visualizing features against the given basemap. geometryType String The geometry type of the features to visualize. Possible Values: point | multipoint | polyline | polygon | mesh theme String The theme determines which values will be emphasized in the continuous ramp and the map. Possible values are listed below. Value Description Example high-to-low High values are emphasized with strong colors. above-and-below Values centered around a given point (e.g. the average) are visualized with weak colors while other values are emphasized with strong colors. centered-on Values centered around a given point (e.g. the average) are emphasized with strong colors while other values are visualized with weak colors. extremes High and low values are emphasized with strong colors. All others are visualized with weak colors. view SceneView optional The SceneView instance in which the scheme will be used. This property is only applicable when the scheme will be used in conjunction with 3D symbols. worldScale Boolean optional Indicates if the size units of the scheme will be in meters. This should be true when the scheme is intended for 3D volumetric symbology. A view must be provided if this property is set to true.

Returns:

Type	Description
ColorSchemes	Returns an object containing the optimal color scheme to use for the given basemap and secondary schemes that may also be used.

Example:

// gets the primary scheme for the features of the given geometry type and basemap
var schemes = colorSchemes.getSchemes({
  basemap: map.basemap,
  geometryType: featureLayer.geometryType,
  theme: "extremes"
});

// the best default scheme for the layer, basemap, and theme
var primaryScheme = schemes.primaryScheme;

getThemes(basemap){Object[]}

Returns metadata for the available themes. If a basemap is provided, returns themes that look best with the given basemap.

Parameter:

basemap String|Basemap optional The Esri basemap string or object that will be used with the returned theme(s).

Returns:

Type

Description

Object[]

Returns an array of objects that describe various themes that pair well with the given basemap. See the table below for more details of the properties in this object. Property Type Description name String The name of the theme. label String The label identifying the theme in UI elements. description String Text describing the theme in the UI. basemaps String[] The Esri basemaps that pair well with the given theme.

Type Definitions

ColorSchemeColorSchemeForPoint|ColorSchemeForPolyline|ColorSchemeForPolygon|ColorSchemeForMesh

Properties defining the symbology scheme used to visualize features with attribute data-driven color.

ColorSchemeForMesh

Properties defining the symbology scheme used to visualize mesh features with attribute data-driven color.

Properties:

id String The unique id of the color scheme to usee in the visualization. The id is assigned based on the following template: <themeName>/<basemapName>/<schemeName>.

theme String Indicates which values will be emphasized in the continuous ramp and the map. Possible values are listed below. Value Description Example high-to-low High values are emphasized with strong colors. above-and-below Values centered around a given point (e.g. the average) are visualized with weak colors while other values are emphasized with strong colors. centered-on Values centered around a given point (e.g. the average) are emphasized with strong colors while other values are visualized with weak colors. extremes High and low values are emphasized with strong colors. All others are visualized with weak colors.

colors Color[] The continuous color ramp that will be applied to the visualization.

noDataColor Color The color of the symbol used to indicate features with no data and features that are out of range.

colorsForClassBreaks Object[] Predefined classed color schemes to use for the visualization. Specification: colors Color[] An array of hex color strings. Each color is assigned to a specific break in classed color visualizations. numClasses Number The number of classes used in the classed color visualization.

opacity Number The opacity of the symbol.

ColorSchemeForPoint

Properties defining the symbology scheme used to visualize point features with attribute data-driven color.

Properties:

id String The unique id of the color scheme to usee in the visualization. The id is assigned based on the following template: <themeName>/<basemapName>/<schemeName>.

theme String Indicates which values will be emphasized in the continuous ramp and the map. Possible values are listed below. Value Description Example high-to-low High values are emphasized with strong colors. above-and-below Values centered around a given point (e.g. the average) are visualized with weak colors while other values are emphasized with strong colors. centered-on Values centered around a given point (e.g. the average) are emphasized with strong colors while other values are visualized with weak colors. extremes High and low values are emphasized with strong colors. All others are visualized with weak colors.

colors Color[] The continuous color ramp that will be applied to the visualization.

noDataColor Color The color of the symbol used to indicate features with no data and features that are out of range.

colorsForClassBreaks Object[] Predefined classed color schemes to use for the visualization. Specification: colors Color[] An array of hex color strings. Each color is assigned to a specific break in classed color visualizations. numClasses Number The number of classes used in the classed color visualization.

outline Object Properties for defining the outline of the symbol. Specification: color Color The outline color of the symbol. width Number The width of the symbol in pixels or points.

size Number The default size of the symbol in pixels or points.

opacity Number The opacity of the symbol.

ColorSchemeForPolygon

Properties defining the symbology scheme used to visualize polygon features with attribute data-driven color.

Properties:

id String The unique id of the color scheme to usee in the visualization. The id is assigned based on the following template: <themeName>/<basemapName>/<schemeName>.

theme String Indicates which values will be emphasized in the continuous ramp and the map. Possible values are listed below. Value Description Example high-to-low High values are emphasized with strong colors. above-and-below Values centered around a given point (e.g. the average) are visualized with weak colors while other values are emphasized with strong colors. centered-on Values centered around a given point (e.g. the average) are emphasized with strong colors while other values are visualized with weak colors. extremes High and low values are emphasized with strong colors. All others are visualized with weak colors.

colors Color[] The continuous color ramp that will be applied to the visualization.

noDataColor Color The color of the symbol used to indicate features with no data and features that are out of range.

colorsForClassBreaks Object[] Predefined classed color schemes to use for the visualization. Specification: colors Color[] An array of hex color strings. Each color is assigned to a specific break in classed color visualizations. numClasses Number The number of classes used in the classed color visualization.

outline Object Properties for defining the outline of the symbol. Specification: color Color The outline color of the symbol. width Number The width of the symbol in pixels or points.

opacity Number The opacity of the symbol.

ColorSchemeForPolyline

Properties defining the symbology scheme used to visualize polyline features with attribute data-driven color.

Properties:

id String The unique id of the color scheme to usee in the visualization. The id is assigned based on the following template: <themeName>/<basemapName>/<schemeName>.

theme String Indicates which values will be emphasized in the continuous ramp and the map. Possible values are listed below. Value Description Example high-to-low High values are emphasized with strong colors. above-and-below Values centered around a given point (e.g. the average) are visualized with weak colors while other values are emphasized with strong colors. centered-on Values centered around a given point (e.g. the average) are emphasized with strong colors while other values are visualized with weak colors. extremes High and low values are emphasized with strong colors. All others are visualized with weak colors.

colors Color[] The continuous color ramp that will be applied to the visualization.

noDataColor Color The color of the symbol used to indicate features with no data and features that are out of range.

colorsForClassBreaks Object[] Predefined classed color schemes to use for the visualization. Specification: colors Color[] An array of hex color strings. Each color is assigned to a specific break in classed color visualizations. numClasses Number The number of classes used in the classed color visualization.

width Number The default width of the symbol in pixels or points.

opacity Number The opacity of the symbol.

ColorSchemes

The return object of the getSchemes() method.

Properties:

primaryScheme ColorScheme The color scheme best suited for the given basemap and geometry type.

secondarySchemes ColorScheme[] Additional color schemes that may be used to visualize data of the given geometry type overlaid on the given basemap.

basemapId String The ID of the basemap associated with the given schemes.