Creates a band for a specified value range on the GaugeAxis. Multiple bands can be assigned to a single GaugeAxis.
Example
var chart = AmCharts.makeChart("chartdiv",{
...
"axes": [
{
...
"bands": [
{
"startValue": 0,
"endValue": 100
}
]
}
]
});
Properties
| Property | Type | Default | Description |
|---|
| alpha | Number | | Opacity of band fill. Will use axis.bandAlpha if not set any. |
| balloonText | String | | When rolled-over, band will display balloon if you set some text for this property. |
| color | Color | | Color of a band. |
| endValue | Number | | End value of a fill. |
| gradientRatio | Array[Number] | [] | Example: [-0.2, 0, -0.2]. Will make bands to be filled with color gradients. Negative value means the color will be darker than the original, and positive number means the color will be lighter. |
| id | String | | Unique id of a band. |
| innerRadius | Number/String | | Inner radius of a band. If not set any, the band will end with the end of minor ticks. Set 0 if you want the band to be drawn to the axis center. |
| radius | Number/String | | Band radius. If not set any, the band will start with the axis outline. |
| startValue | Number | | Start value of a fill. |
| url | String | | Gauge band can be clickable and can lead to some page. |
Methods
| Name | Parameters | Returns | Description |
|---|
| setEndValue(value) | value | | Sets end value for the band. |
| setStartValue(value) | value | | Sets start value for the band. |
Events
| Name | Event object | Description |
|---|
| clickBand | {type: "clickBand", dataItem: GaugeBand, chart: Object, event: MouseEvent} | Dispatched when user clicks on a band. |
| rollOutBand | {type: "rollOutBand", dataItem: GaugeBand, chart: Object, event: MouseEvent} | Dispatched when user rolls-out of the band. |
| rollOverBand | {type: "rollOverBand", dataItem: GaugeBand, chart: Object, event: MouseEvent} | Dispatched when user rolls-over the band. |