Skip to content

AmGraph

Type class

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);```

Sources

This information about AmGraph is provided for reference only and is not available through exported packages and thus should not be imported or used on its own.

Inheritance

AmGraph does not extend any other symbol.

AmGraph is extended by StockGraph.

Properties

alphaField

Type stringDefault

Name of the alpha field in your dataProvider.

balloonColor

Type stringDefault

Value balloon color. Will use graph or data item color if not set.

balloonText

Type stringDefault [[value]]

Balloon text. You can use tags like value, description, percents, open, category

baloonFunction

Type 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

Type booleanDefault false

Specifies if the line graph should be placed behind column graphs

bullet

Type stringDefault none

Type of the bullets. Possible values are: "none", "round", "square", "triangleUp", "triangleDown", "bubble", "custom".

bulletAlpha

Type numberDefault 1

Opacity of bullets. Value range is 0 - 1.

bulletBorderAlpha

Type numberDefault 1

Bullet border opacity.

bulletBorderColor

Type stringDefault

Bullet border color. Will use lineColor if not set.

bulletBorderThickness

Type numberDefault 2

Bullet border thickness.

bulletColor

Type stringDefault

Bullet color. Will use lineColor if not set.

bulletField

Type stringDefault

Name of the bullet field in your dataProvider.

bulletOffset

Type numberDefault 0

Bullet offset. Distance from the actual data point to the bullet. Can be used to place custom bullets above the columns.

bulletSize

Type numberDefault 8

Bullet size.

bulletSizeField

Type stringDefault

Name of the bullet size field in your dataProvider.

closeField

Type stringDefault

Name of the close field (used by candlesticks and ohlc) in your dataProvider.

color

Type stringDefault

Color of value labels. Will use chart's color if not set.

colorField

Type stringDefault

Name of the color field in your dataProvider.

connect

Type booleanDefault true

Specifies whether to connect data points if data is missing. The default value is true.

cornerRadiusTop

Type numberDefault 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

Type numberDefault 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

Type stringDefault

Path to the image of custom bullet.

customBulletField

Type stringDefault

Name of the custom bullet field in your dataProvider.

dashLength

Type numberDefault 0

Dash length. If you set it to a value greater than 0, the graph line will be dashed.

descriptionField

Type stringDefault

Name of the description field in your dataProvider.

fillAlphas

Type numberDefault 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

Type String/ArrayDefault

Fill color. Will use lineColor if not set.

fillColorsField

Type stringDefault

Name of the fill colors field in your dataProvider.

fillToGraph

Type 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

Type numberDefault

Size of value labels text. Will use chart's fontSize if not set.

gradientOrientation

Type stringDefault vertical

Orientation of the gradient fills (only for "column" graph type). Possible values are "vertical" and "horizontal".

hidden

Type booleanDefault 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

Type numberDefault 0

If there are more data points than hideBulletsCount, the bullets will not be shown. 0 means the bullets will always be visible.

highField

Type stringDefault

Name of the high field (used by candlesticks and ohlc) in your dataProvider.

includeInMinMax

Type booleanDefault true

Whether to include this graph when calculating min and max value of the axis.

labelColorField

Type string

Name of label color field in data provider.

labelPosition

Type stringDefault 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

Type stringDefault

Value label text. You can use tags like value, description, percents, open, category.

legendAlpha

Type numberDefault

Legend marker opacity. Will use lineAlpha if not set. Value range is 0 - 1.

legendColor

Type stringDefault

Legend marker color. Will use lineColor if not set.

legendValueText

Type stringDefault

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

Type numberDefault 1

Opacity of the line (or column border). Value range is 0 - 1.

lineColor

Type stringDefault

Color of the line (or column border). If you do not set any, the color from [[AmCoordinateChart

lineColorField

Type stringDefault

Name of the line color field (used by columns and candlesticks only) in your dataProvider.

lineThickness

Type numberDefault 1

Specifies thickness of the graph line (or column border).

lowField

Type stringDefault

Name of the low field (used by candlesticks and ohlc) in your dataProvider.

markerType

Type stringDefault

Legend marker type. You can set legend marker (key) type for individual graphs. Possible values are: "square", "circle", "line", "dashedLine", "triangleUp", "triangleDown", "bubble".

maxBulletSize

Type numberDefault 50

Specifies size of the bullet which value is the biggest (XY chart).

minBulletSize

Type numberDefault 0

Specifies minimum size of the bullet (XY chart).

negativeBase

Type numberDefault 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

Type numberDefault

Fill opacity of negative part of the graph. Will use fillAlphas if not set.

negativeFillColors

Type String/ArrayDefault

Fill color of negative part of the graph. Will use fillColors if not set.

negativeLineColor

Type stringDefault

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

Type objectDefault

Example: {precision:-1, decimalSeparator:'.', thousandsSeparator:','}. The graph uses this object's values to format the numbers. Uses chart's numberFormatter if not defined.

openField

Type stringDefault

Name of the open field (used by floating columns, candlesticks and ohlc) in your dataProvider.

pointPosition

Type stringDefault 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

Type booleanDefault 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

Type booleanDefault 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

Type stringDefault 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

Type booleanDefault false

If you want mouse pointer to change to hand when hovering the graph, set this property to true.

stackable

Type booleanDefault true

If the value axis of this graph has stack types like "regular" or "100%" You can exclude this graph from stacking.

title

Type stringDefault

Graph title.

type

Type stringDefault 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

Type stringDefault

Name of the url field in your dataProvider.

urlTarget

Type stringDefault

Target to open URLs in, i.e. _blank, _top, etc.

valueAxis

Type ValueAxisDefault

Specifies which value axis the graph will use. Will use the first value axis if not set.

valueField

Type stringDefault

Name of the value field in your dataProvider.

visibleInLegend

Type booleanDefault true

Specifies whether this graph should be shown in the Legend.

xAxis

Type ValueAxisDefault

XY chart only. A horizontal value axis object to attach graph to.

xField

Type stringDefault

XY chart only. Name of the x field in your dataProvider.

yAxis

Type ValueAxisDefault

XY chart only. A vertical value axis object to attach graph to.

yField

Type stringDefault

XY chart only. Name of the y field in your dataProvider.

Methods

hideBullets()

Returns void

Hides graph's bullets.

showBullets()

Returns void

Shows graph's bullets.

Events

AmGraph does not have any events.