AreasSettings is a class which defines the default settings for all MapArea objects.
var map = AmCharts.makeChart("mapdiv",{
...
"areasSettings": {
"alpha": 0.5
}
});
| Property | Type | Default | Description |
|---|---|---|---|
| accessibleLabel | String | [[title]] [[value]] [[description]] | Text which screen readers will read if user rolls-over the area or sets focus using tab key (this is possible only if tabIndex property of AreasSettings or individual area is set to some number). Text is added as aria-label tag. Note - not all screen readers and browsers support this. |
| adjustOutlineThickness | Boolean | true | By default the map will adjust area outlines when zooming in/out so that they will always stay of the same width. This however loads CPU quite a lot. If you set it to false, outlines will scale together with the areas. |
| alpha | Number | 1 | Opacity of areas. |
| autoZoom | Boolean | false | Specifies if the areas should be zoomed-in when user clicks on them, event if zoom properties are not set. |
| balloonText | String | [[title]] | Text which is displayed in a roll-over balloon. You can use the following tags: [[title]], [[description]], [[value]] and [[percent]]. To disable the balloons, set it to an empty string. |
| bringForwardOnHover | Boolean | true | Specifies if the area should change it's z-index to the most top when user hovers it. |
| color | Color | #FFCC00 | Color of the areas. |
| colorSolid | Color | #990000 | Color of area with highest value. Colors for areas with values less then highest will be colored with intermediate colors between color and colorSolid. Use colorSteps property of AmMap to change the number of intermediate colors. |
| descriptionWindowBottom | Number | Distance from the bottom side of map container to the description window. In case it is not set (also if descriptionWindowTop is not set), window will be placed near the mouse pointer. | |
| descriptionWindowHeight | Number | Height of a description window. | |
| descriptionWindowLeft | Number | Distance from the left side of map container to the description window. In case it is not set (also if descriptionWindowRight is not set), window will be placed near the mouse pointer. | |
| descriptionWindowRight | Number | Distance from the right side of map container to the description window. In case it is not set (also if descriptionWindowLeft is not set), window will be placed near the mouse pointer. | |
| descriptionWindowTop | Number | Distance from the top side of map container to the description window. In case it is not set (also if descriptionWindowBottom is not set), window will be placed near the mouse pointer. | |
| descriptionWindowWidth | Number | 250 | Width of a description window. |
| outlineAlpha | Number | 1 | Opacity of area's outline. |
| outlineColor | Color | #FFFFFF | Color of area's outline. |
| outlineThickness | Number | 1 | Thickness of area's outline. |
| rollOverColor | Color | Color of area when user rolls-over it. You can set this to "undefined" (no quotes) to make the area retain it's original color when hovered. | |
| rollOverOutlineAlpha | Number | Opacity of rolled-over area outline. | |
| rollOverOutlineColor | Color | #CC0000 | Color of area's outline when user rolls-over it. |
| rollOverOutlineThickness | Number | 1 | Thickness of rolled-over area outline. |
| selectable | Boolean | false | Specifies if areas are selectable, even no zoom/description/url is set. You can also override this setting for each individual area individually. |
| selectedColor | Color | #CC0000 | Color of area which is currently selected. You can set this to "undefined" (no quotes) to make the area retain it's original color when selected. |
| selectedOutlineColor | Color | Color of selected area's outline. | |
| selectedOutlineThickness | Number | Thickness of selected area outline. | |
| tabIndex | Number | In case you set it to some number, the map will set focus on areas (one by one) when user clicks tab key. When a focus is set, screen readers like NVDA Screen reader will read label which is set using accessibleLabel property of AreasSettings or individual area. If area is clickable, pressing Enter/Return while focus is set will select the area. Note, not all browsers and readers support this. | |
| unlistedAreasAlpha | Number | 1 | Opacity of all areas which are in the map svg file, but not listed as areas in DataSet. |
| unlistedAreasColor | Color | #DDDDDD | Color of all areas which are in the map svg file, but not listed as areas in DataSet. |
| unlistedAreasOutlineAlpha | Number | 1 | Opacity of all areas' outline which are in the map svg file, but not listed as areas in DataSet. |
| unlistedAreasOutlineColor | Color | #FFFFFF | Color of all areas' outline which are in the map svg file, but not listed as areas in DataSet. |