areaSettings

Deprecated

Use the "area" type element of the layers array.

An object specifying options for the map areas.

Type: Object

The map areas usually represent geographical objects, such as countries, continents, etc. The appearance of these areas is specified by the options of the areaSettings configuration object. If these options are defined on the first level of the areaSettings object, they are applied to all the map areas at once. However, you can specify several of these options for certain areas exclusively. See the customize option description to learn how.

borderColor

Deprecated

Use the borderColor option instead.

Specifies a color for the area border.

Type: String
Default Value: '#9d9d9d'

This option supports the following colors.

  • Hexadecimal colors
  • RGB colors
  • RGBA colors (not supported in Internet Explorer 8)
  • Predefined/cross-browser color names
  • Predefined SVG colors (not supported in Internet Explorer 8)

borderWidth

Deprecated

Use the borderWidth option instead.

Specifies the width of the area border in pixels.

Type: Number
Default Value: 1

color

Deprecated

Use the color option instead.

Specifies a color for an area.

Type: String
Default Value: '#d2d2d2'

This option supports the following colors.

  • Hexadecimal colors
  • RGB colors
  • RGBA colors (not supported in Internet Explorer 8)
  • Predefined/cross-browser color names
  • Predefined SVG colors (not supported in Internet Explorer 8)

colorGroupingField

Deprecated

Use the colorGroupingField option instead.

Specifies the field that provides data to be used for coloring areas.

Type: String
Default Value: undefined

If you need for the color of a specific map area to depend on the value of one of its attributes, assign the name of this attribute to the colorGroupingField option. The attribute must contain numeric values. After that, specify groups into which attribute values must be classified. For this purpose, assign an array to the colorGroups option. Each group in this array will be assigned a color from the palette.

View Demo

colorGroups

Deprecated

Use the colorGroups option instead.

Allows you to paint areas with similar attributes in the same color.

Type: Array
Default Value: undefined

If you have specified the field that provides area-coloring data, you need to specify groups into which this data must be classified. For this purpose, assign an array of numbers to the colorGroups option. Each pair of numbers in this array defines a range of data values.

For example, imagine that the colorGroups array contains four items: [0, 1, 2, 3]. This array specifies three ranges, or groups: 0-1, 1-2 and 2-3. Thus, data values will be split up into three groups. Each group will be assigned a color from the palette in order to paint the corresponding areas. Areas of those data values that do not match neither group will be drawn in a default color.

View Demo

customize

Deprecated

Use the customize option instead.

Specifies the function that customizes each area individually.

Type: function(area)
Function parameters:
area: Area

The area to be customized.

Return Value: Area configuration

A configuration object for the area.

Cannot be used in themes.

When implementing a function for this option, use the fields of the Area object. To access this object, use the function's parameter or the this object.

The customize function should return the object that contains options to be changed for a certain area. These options are listed below.

View Demo

hoveredBorderColor

Deprecated

Use the hoveredBorderColor option instead.

Specifies a color for the area border when the area is hovered over.

Type: String
Default Value: '#303030'

This option supports the following colors.

  • Hexadecimal colors
  • RGB colors
  • RGBA colors (not supported in Internet Explorer 8)
  • Predefined/cross-browser color names
  • Predefined SVG colors (not supported in Internet Explorer 8)
NOTE
Make sure that the hoverEnabled option is set to true, so that the hoveredBorderColor option takes effect.

hoveredBorderWidth

Deprecated

Use the hoveredBorderWidth option instead.

Specifies the pixel-measured width of the area border when the area is hovered over.

Type: Number
Default Value: 1

hoveredColor

Deprecated

Use the hoveredColor option instead.

Specifies a color for an area when this area is hovered over.

Type: String
Default Value: '#d2d2d2'

This option supports the following colors.

  • Hexadecimal colors
  • RGB colors
  • RGBA colors (not supported in Internet Explorer 8)
  • Predefined/cross-browser color names
  • Predefined SVG colors (not supported in Internet Explorer 8)
NOTE
Make sure that the hoverEnabled option is set to true, so that the hoveredColor option takes effect.

hoverEnabled

Deprecated

Use the hoverEnabled option instead.

Specifies whether or not to change the appearance of an area when it is hovered over.

Type: Boolean
Default Value: true

If this option is set to true, you can specify colors for the hovered area and its border using the hoveredColor and hoveredBorderColor options, respectively.

label

Deprecated

Use the label option instead.

Configures area labels.

Type: Object

An area label is a text that accompanies a map area. Usually, an area label displays the name of a certain geographical object, such as a country, a continent, etc.

Texts for area labels are provided by one of the fields of the attributes object. This object must be declared in the map data source, while the required field must be assigned to the dataField option of the label object.

If you have provided data for area labels, enable them on your map by assigning true to the enabled option of the label object.

In addition, you can change the appearance of area labels using the label | font object.

View Demo

palette

Deprecated

Use the palette option instead.

Specifies the name of the palette or a custom range of colors to be used for coloring a map.

Type: Array|String
Default Value: 'Default'
Accepted Values: 'Default' | 'Soft Pastel' | 'Harmony Light' | 'Pastel' | 'Bright' | 'Soft' | 'Ocean' | 'Vintage' | 'Violet'

A palette defines a range of colors that are used to paint areas on a map. This range is divided into segments using the value assigned to the paletteSize option. Each segment contributes a color into a resulting array of colors. The more of these segments, the greater the variety of colors in this array. All available palettes are listed in the accepted values.

In order to apply a palette to a map, follow the next steps.

  • Assign the name of the required palette (or an array of two colors) to the palette option.
  • Use the paletteSize option to define how many colors should be produced from the palette or array specified in the previous step.
  • Specify the index of the color from the colors array, which should be used for coloring an area, using the paletteIndex field of the object returned by the customize callback function.

View Demo

paletteSize

Deprecated

Use the paletteSize option instead.

Specifies the number of colors in a palette.

Type: Number
Default Value: 0

Assign a number that is greater than 0 to this option in order to use palettes.

selectedBorderColor

Deprecated

Use the selectedBorderColor option instead.

Specifies a color for the area border when the area is selected.

Type: String
Default Value: '#303030'

This option supports the following colors.

  • Hexadecimal colors
  • RGB colors
  • RGBA colors (not supported in Internet Explorer 8)
  • Predefined/cross-browser color names
  • Predefined SVG colors (not supported in Internet Explorer 8)

selectedBorderWidth

Deprecated

Use the selectedBorderWidth option instead.

Specifies the pixel-measured width of the area border when the area is selected.

Type: Number
Default Value: 2

selectedColor

Deprecated

Use the selectedColor option instead.

Specifies a color for an area when this area is selected.

Type: String
Default Value: '#d2d2d2'

This option supports the following colors.

  • Hexadecimal colors
  • RGB colors
  • RGBA colors (not supported in Internet Explorer 8)
  • Predefined/cross-browser color names
  • Predefined SVG colors (not supported in Internet Explorer 8)

selectionMode

Deprecated

Use the selectionMode option instead.

Specifies whether single or multiple areas can be selected on a vector map.

Type: String
Default Value: 'single'
Accepted Values: 'single' | 'multiple' | 'none'

Several options and methods are connected with the selection operation. To specify whether single or multiple areas can be selected at a time, use the selectionMode option. To determine whether a certain area is selected when the widget is created, use the isSelected field of the object returned by the customize callback function.

At runtime, you can do the following operations.

  • Obtain the current selection state of an area using its selected() method.

  • Change the current selection state of an area using its selected(state) method. Pass true or false to this method.

  • Deselect all the selected areas using the clearAreaSelection() method of the map instance.

The change of the selection state invokes the callback function assigned to the onAreaSelectionChanged option. Within this function you can handle the selection event in the manner you require.