Type class
AmLegend is the class that displays legend of the chart. Legend to the chart should be added using chart.addLegend(legend) method. For example:
var chart = new AmCharts.AmSerialChart(); var legend = new AmCharts.AmLegend(); chart.addLegend(legend);
In case legend is used with AmMap, you should provide data to the legend:
legend.data = [{title:"first", color:"#CC0000"}, {title:"second", color:"#00CC00"}]
However in most cases ValueLegend is more useful for AmMap.
Inheritance
AmLegend does not extend any other symbol.
AmLegend is extended by StockLegend
.
Properties
align # |
Type Default Alignment of legend entries. Possible values are: "left", "center", "right". |
---|---|
autoMargins # |
Type Default Used if chart is Serial or XY. In case true, margins of the legend are adjusted and made equal to chart's margins. |
backgroundAlpha # |
Type Default Opacity of legend's background. Value range is 0 - 1 |
backgroundColor # |
Type Default Background color. You should set backgroundAlpha to >0 vallue in order background to be visible. |
borderAlpha # |
Type Default Opacity of chart's border. Value range is 0 - 1. |
borderColor # |
Type Default Color of legend's border. You should set borderAlpha >0 in order border to be visible. |
bottom # |
Type In case legend position is set to "absolute", you can set distance from bottom of the chart, in pixels. |
color # |
Type Text color. Will use chart's color if not set. |
data # |
Type This can be used by AmMap only. You can pass array of objects with title, color, markerType values, for example: [{title: "One", color: "#3366CC"},{title: "Two", color: "#FFCC33"}] |
equalWidths # |
Type Default Specifies if each of legend entry should be equal to the most wide entry. Won't look good if legend has more than one line. |
fontSize # |
Type Font size. Will use chart's font size if not set. |
horizontalGap # |
Type Default Horizontal space between legend item and left/right border. |
labelText # |
Type Default The text which will be displayed in the legend. Tag [[title]] will be replaced with the title of the graph. |
left # |
Type In case legend position is set to "absolute", you can set distance from left side of the chart, in pixels. |
marginBottom # |
Type Default Bottom margin. |
marginLeft # |
Type Default Left margin. This property will be ignored if chart is Serial or XY and autoMargins property of the legend is true (default). |
marginRight # |
Type Default Right margin. This property will be ignored if chart is Serial or XY and autoMargins property of the legend is true (default). |
marginTop # |
Type Default Top margin. |
markerBorderAlpha # |
Type Default Marker border opacity. |
markerBorderColor # |
Type Marker border color. If not set, will use the same color as marker. |
markerBorderThickness # |
Type Default Thickness of the legend border. The default value (0) means the line will be a "hairline" (1 px). In case marker type is line, this style will be used for line thickness. |
markerDisabledColor # |
Type Default The color of the disabled marker (when the graph is hidden). |
markerLabelGap # |
Type Default Space between legend marker and legend text, in pixels. |
markerSize # |
Type Default Size of the legend marker (key). |
markerType # |
Type Default Shape of the legend marker (key). Possible values are: "square", "circle", "line", "dashedLine", "triangleUp", "triangleDown", "bubble", "none". |
maxColumns # |
Type Maximum number of columns in the legend. If Legend's position is set to "right" or "left", maxColumns is automatically set to 1. |
position # |
Type Default Position of a legend. Possible values are: "bottom", "top", "left", "right" and "absolute". In case "absolute", you should set left and top properties too. (this setting is ignored in Stock charts). In case legend is used with AmMap, position is set to "absolute" automatically. |
reversedOrder # |
Type Default Specifies whether legend entries should be placed in reversed order. |
right # |
Type In case legend position is set to "absolute", you can set distance from right side of the chart, in pixels. |
rollOverColor # |
Type Default Legend item text color on roll-over. |
rollOverGraphAlpha # |
Type Default When you roll-over the legend entry, all other graphs can reduce their opacity, so that the graph you rolled-over would be distinguished. This style specifies the opacity of the graphs. |
showEntries # |
Type Default You can use this property to turn all the legend entries off. |
spacing # |
Type Default Horizontal space between legend items, in pixels. |
switchable # |
Type Default Whether showing/hiding of graphs by clicking on the legend marker is enabled or not. In case legend is used with AmMap, this is set to false automatically. |
switchColor # |
Type Default Legend switch color. |
switchType # |
Type Default Legend switch type (in case the legend is switchable). Possible values are "x" and "v". |
textClickEnabled # |
Type Default If true, clicking on the text will show/hide balloon of the graph. Otherwise it will show/hide graph/slice, if switchable is set to true. |
top # |
Type In case legend position is set to "absolute", you can set distance from top of the chart, in pixels. |
useMarkerColorForLabels # |
Type Default Labels will use marker color if you set this to true. |
useMarkerColorForValues # |
Type Default Specifies if legend values should be use same color as corresponding markers. |
valueAlign # |
Type Default Alignment of the value text. Possible values are "left" and "right". |
valueText # |
Type Default The text which will be displayed in the value portion of the legend. You can use tags like [[value]], [[open]], [[high]], [[low]], [[close]], [[percents]], [[description]]. |
valueWidth # |
Type Default Width of the value text. |
verticalGap # |
Type Default Vertical space between legend items also between legend border and first and last legend row. |
Methods
addListener( |
Returns Adds event listener to the object. type - string like 'clickLabel' (should be listed in 'events' section of this class or classes which extend this class). handler - function which is called when event happens |
---|---|
removeListener( |
Returns Removes event listener from the legend object. |
Events
#clickLabel |
Param Dispatched when legend label is clicked. |
---|---|
#clickMarker |
Param Dispatched when legend marker is clicked. |
#hideItem |
Param Dispatched when user clicks on a legend item marker and hides corresponding object. |
#rollOutItem |
Param Dispatched when user rolls-out of the legend item label (or whole item, if switchable is set to false). |
#rollOverItem |
Param Dispatched when user rolls-over the legend item label (or whole item, if switchable is set to false). |
#rollOverMarker |
Param Dispatched when user rolls-over the legend item marker. |
#showItem |
Param Dispatched when user clicks on a legend item marker and shows corresponding object. |
Adapters
AmLegend does not have any adapters.