You are browsing a class reference for deprecated Version 2 of the JavaScript Charts.
Documentation for other versions: amCharts 4 (current) or amCharts 3.
AmGraph class displays all types of graphs - line, column, step line, smoothed line, ohlc and candlestick. Example:
var chart = new AmCharts.AmSerialChart(); var graph = new AmCharts.AmGraph(); graph.valueField = 'value'; graph.type = 'column'; graph.fillAlphas = 1; chart.addGraph(graph);
| Property | Type | Default | Description |
|---|---|---|---|
| alphaField | String | Name of the alpha field in your dataProvider. | |
| balloonColor | String | Value balloon color. Will use graph or data item color if not set. | |
| balloonText | String | [[value]] | Balloon text. You can use tags like [[value]], [[description]], [[percents]], [[open]], [[category]] |
| baloonFunction | Function | If you set some function, the graph will call it and pass GraphDataItem and AmGraph object to it. This function should return a string which will be displayed in a balloon. | |
| behindColumns | Boolean | false | Specifies if the line graph should be placed behind column graphs |
| bullet | String | none | Type of the bullets. Possible values are: "none", "round", "square", "triangleUp", "triangleDown", "bubble", "custom". |
| bulletAlpha | Number | 1 | Opacity of bullets. Value range is 0 - 1. |
| bulletBorderAlpha | Number | 1 | Bullet border opacity. |
| bulletBorderColor | String | Bullet border color. Will use lineColor if not set. | |
| bulletBorderThickness | Number | 2 | Bullet border thickness. |
| bulletColor | String | Bullet color. Will use lineColor if not set. | |
| bulletField | String | Name of the bullet field in your dataProvider. | |
| bulletOffset | Number | 0 | Bullet offset. Distance from the actual data point to the bullet. Can be used to place custom bullets above the columns. |
| bulletSize | Number | 8 | Bullet size. |
| bulletSizeField | String | Name of the bullet size field in your dataProvider. | |
| closeField | String | Name of the close field (used by candlesticks and ohlc) in your dataProvider. | |
| color | String | Color of value labels. Will use chart's color if not set. | |
| colorField | String | Name of the color field in your dataProvider. | |
| connect | Boolean | true | Specifies whether to connect data points if data is missing. The default value is true. |
| cornerRadiusTop | Number | 0 | Corner radius of column. It can be set both in pixels or in percents. The chart's depth and angle styles must be set to 0. The default value is 0. Note, cornerRadiusTop will be applied for all corners of the column, JavaScript charts do not have a possibility to set separate corner radius for top and bottom. As we want all the property names to be the same both on JS and Flex, we didn't change this too. |
| cursorBulletAlpha | Number | 1 | If bulletsEnabled of ChartCurosor is true, a bullet on each graph follows the cursor. You can set opacity of each graphs bullet. In case you want to disable these bullets for a certain graph, set opacity to 0. |
| customBullet | String | Path to the image of custom bullet. | |
| customBulletField | String | Name of the custom bullet field in your dataProvider. | |
| dashLength | Number | 0 | Dash length. If you set it to a value greater than 0, the graph line will be dashed. |
| descriptionField | String | Name of the description field in your dataProvider. | |
| fillAlphas | Number | 0 | Opacity of fill. Plural form is used to keep the same property names as our Flex charts'. Flex charts can accept array of numbers to generate gradients. Although you can set array here, only first value of this array will be used. |
| fillColors | String/Array | Fill color. Will use lineColor if not set. | |
| fillColorsField | String | Name of the fill colors field in your dataProvider. | |
| fillToGraph | AmGraph | You can set another graph here and if fillAlpha is >0, the area from this graph to fillToGraph will be filled (instead of filling the area to the X axis). | |
| fontSize | Number | Size of value labels text. Will use chart's fontSize if not set. | |
| gradientOrientation | String | vertical | Orientation of the gradient fills (only for "column" graph type). Possible values are "vertical" and "horizontal". |
| hidden | Boolean | false | Specifies whether the graph is hidden. Do not use this to show/hide the graph, use hideGraph(graph) and showGraph(graph) methods instead. |
| hideBulletsCount | Number | 0 | If there are more data points than hideBulletsCount, the bullets will not be shown. 0 means the bullets will always be visible. |
| highField | String | Name of the high field (used by candlesticks and ohlc) in your dataProvider. | |
| includeInMinMax | Boolean | true | Whether to include this graph when calculating min and max value of the axis. |
| labelColorField | String | Name of label color field in data provider. | |
| labelPosition | String | top | Position of value label. Possible values are: "bottom", "top", "right", "left", "inside", "middle". Sometimes position is changed by the chart, depending on a graph type, rotation, etc. |
| labelText | String | Value label text. You can use tags like [[value]], [[description]], [[percents]], [[open]], [[category]]. | |
| legendAlpha | Number | Legend marker opacity. Will use lineAlpha if not set. Value range is 0 - 1. | |
| legendColor | String | Legend marker color. Will use lineColor if not set. | |
| legendValueText | String | Legend value text. You can use tags like [[value]], [[description]], [[percents]], [[open]], [[category]] You can also use custom fields from your dataProvider. If not set, uses Legend's valueText. | |
| lineAlpha | Number | 1 | Opacity of the line (or column border). Value range is 0 - 1. |
| lineColor | String | Color of the line (or column border). If you do not set any, the color from [[AmCoordinateChart | |
| lineColorField | String | Name of the line color field (used by columns and candlesticks only) in your dataProvider. | |
| lineThickness | Number | 1 | Specifies thickness of the graph line (or column border). |
| lowField | String | Name of the low field (used by candlesticks and ohlc) in your dataProvider. | |
| markerType | String | Legend marker type. You can set legend marker (key) type for individual graphs. Possible values are: "square", "circle", "line", "dashedLine", "triangleUp", "triangleDown", "bubble". | |
| maxBulletSize | Number | 50 | Specifies size of the bullet which value is the biggest (XY chart). |
| minBulletSize | Number | 0 | Specifies minimum size of the bullet (XY chart). |
| negativeBase | Number | 0 | If you use different colors for your negative values, a graph below zero line is filled with negativeColor. With this property you can define a different base value at which colors should be changed to negative colors. |
| negativeFillAlphas | Number | Fill opacity of negative part of the graph. Will use fillAlphas if not set. | |
| negativeFillColors | String/Array | Fill color of negative part of the graph. Will use fillColors if not set. | |
| negativeLineColor | String | Color of the line (or column) when the values are negative. In case the graph type is candlestick or ohlc, negativeLineColor is used when close value is less then open value. | |
| numberFormatter | Object | Example: {precision:-1, decimalSeparator:'.', thousandsSeparator:','}. The graph uses this object's values to format the numbers. Uses chart's numberFormatter if not defined. | |
| openField | String | Name of the open field (used by floating columns, candlesticks and ohlc) in your dataProvider. | |
| pointPosition | String | middle | Specifies where data points should be placed - on the beginning of the period (day, hour, etc) or in the middle (only when parseDates property of categoryAxis is set to true). This setting affects Serial chart only. Possible values are "start" and "middle". |
| showAllValueLabels | Boolean | false | If graph's type is column and labelText is set, graph hides labels which do not fit into the column's space. If you don't want these labels to be hidden, set this to true. |
| showBalloon | Boolean | true | Specifies whether the value balloon of this graph is shown when mouse is over data item or chart's indicator is over some series. |
| showBalloonAt | String | close | Specifies graphs value at which cursor is showed. This is only important for candlestick and ohlc charts, also if column chart has "open" value. Possible values are: "open", "close", "high", "low". |
| showHandOnHover | Boolean | false | If you want mouse pointer to change to hand when hovering the graph, set this property to true. |
| stackable | Boolean | true | If the value axis of this graph has stack types like "regular" or "100%" You can exclude this graph from stacking. |
| title | String | Graph title. | |
| type | String | line | Type of the graph. Possible values are: "line", "column", "step", "smoothedLine", "candlestick", "ohlc". XY and Radar charts can only display "line" type graphs. |
| urlField | String | Name of the url field in your dataProvider. | |
| urlTarget | String | Target to open URLs in, i.e. _blank, _top, etc. | |
| valueAxis | ValueAxis | Specifies which value axis the graph will use. Will use the first value axis if not set. | |
| valueField | String | Name of the value field in your dataProvider. | |
| visibleInLegend | Boolean | true | Specifies whether this graph should be shown in the Legend. |
| xAxis | ValueAxis | XY chart only. A horizontal value axis object to attach graph to. | |
| xField | String | XY chart only. Name of the x field in your dataProvider. | |
| yAxis | ValueAxis | XY chart only. A vertical value axis object to attach graph to. | |
| yField | String | XY chart only. Name of the y field in your dataProvider. |
| Name | Parameters | Returns | Description |
|---|---|---|---|
| hideBullets() | Hides graph's bullets. | ||
| showBullets() | Shows graph's bullets. |