Base class for ValueAxis and CategoryAxis. It can not be instantiated explicitly.

Properties

PropertyTypeDefaultDescription
autoGridCountBooleantrueSpecifies whether number of gridCount is specified automatically, acoarding to the axis size.
autoRotateAngleNumberAngle of label rotation, if the number of series exceeds autoRotateCount. Works on horizontal axis only. It is not recommended to use it with charts with zoom/scroll features, as chart adjusts margin only based on initial render.
autoRotateCountNumberIf the number of category axis items will exceed the autoRotateCount, the labels will be rotated by autoRotateAngle degree. Works on horizontal axis only. Not recommended with scrollable/zoomable charts.
axisAlphaNumber1Axis opacity. Value range is 0 - 1.
axisColorColor#000000Axis color.
axisThicknessNumber1Thickness of the axis.
axisXNumberRead-only. Returns x coordinate of the axis.
axisYNumberRead-only. Returns y coordinate of the axis.
balloonAmBalloonAmBalloonAllows customizing axes balloons individually.
boldLabelsBooleanfalseSpecifies if axis labels should be bold or not.
boldPeriodBeginningBooleantrueWhen parse dates is on for the category axis, the chart will try to highlight the beginning of the periods, like month, in bold. Set this to false to disable the functionality.
centerLabelOnFullPeriodBooleantrueThis setting works only when parseDates is set to true and equalSpacing is set to false. In case you set it to false,
labels will never be centered between grid lines.
centerLabelsBooleanfalseForce-centers labels of date-based axis (in case it's category axis, equalSpacing must be false)
centerRotatedLabelsBooleanfalseIn case you have rotated labels on horizontal axis, you can force-center them using this property.
colorColorColor of axis value labels. Will use chart's color if not set.
dashLengthNumber0Length of a dash. 0 means line is not dashed.
dateFormatsArray[Object][{"period":"fff","format":"JJ:NN:SS"},{"period":"ss","format":"JJ:NN:SS"},{"period":"mm","format":"JJ:NN"},{"period":"hh","format":"JJ:NN"},{"period":"DD","format":"MMM DD"},{"period":"WW","format":"MMM DD"},{"period":"MM","format":"MMM"},{"period":"YYYY","format":"YYYY"}]Date formats of different periods. Possible period values: fff - milliseconds, ss - seconds, mm - minutes, hh - hours, DD - days, MM - months, WW - weeks, YYYY - years. Check this page for date formatting strings.
fillAlphaNumber0Fill opacity. Every second space between grid lines can be filled with color. Set fillAlpha to a value greater than 0 to see the fills.
fillColorColor#FFFFFFFill color. Every second space between grid lines can be filled with color. Set fillAlpha to a value greater than 0 to see the fills.
firstDayOfWeekNumber1Sets first day of the week. 0 is Sunday, 1 is Monday, etc.
fontSizeNumberSize of value labels text. Will use chart's fontSize if not set.
gridAlphaNumber0.15Opacity of grid lines.
gridColorColor#000000Color of grid lines.
gridCountNumber5Number of grid lines. In case this is value axis, or your categoryAxis parses dates, the number is approximate. The default value is 5. If you set autoGridCount to true, this property is ignored.
gridThicknessNumber1Thickness of grid lines.
guidesArray[Guide][]The array of guides belonging to this axis.
ignoreAxisWidthBooleanfalseIf autoMargins of a chart is set to true, but you want this axis not to be measured when calculating margin, set ignoreAxisWidth to true.
insideBooleanfalseSpecifies whether values should be placed inside or outside plot area.
labelFrequencyNumber1Frequency at which labels should be placed. Doesn't work for CategoryAxis if parseDates is set to true.
labelOffsetNumber0You can use it to adjust position of axes labels. Works both with CategoryAxis and ValueAxis.
labelRotationNumber0Rotation angle of a label. Only horizontal axis' values can be rotated. If you set this for vertical axis, the setting will be ignored. Possible values from -90 to 90.
labelsEnabledBooleantrueSpecifies whether axis displays category axis' labels and value axis' values.
listenersArray[Object]You can add listeners of events using this property. Example: listeners = [{"event":"clickItem", "method":handleEvent}];
markPeriodChangeBooleantrueIf you set it to false, the start of longer periods won't use a different date format and won't be bold.
minHorizontalGapNumber75This property is used when calculating grid count (when autoGridCount is true). It specifies minimum cell width required for one span between grid lines.
minorGridAlphaNumber0.07Opacity of minor grid. In order minor to be visible, you should set minorGridEnabled to true.
minorGridEnabledBooleanfalseSpecifies if minor grid should be displayed.

NOTE: If equalSpacing is set to true, this setting will be ignored.
minorTickLengthNumber0Length of minor grid tick.
minVerticalGapNumber35This property is used when calculating grid count (when autoGridCount is true). It specifies minimum cell height required for one span between grid lines.
offsetNumber0The distance of the axis to the plot area, in pixels. Negative values can also be used.
positionStringbottomPossible values are: "top", "bottom", "left", "right". If axis is vertical, default position is "left". If axis is horizontal, default position is "bottom".
showFirstLabelBooleantrueWhether to show first axis label or not. This works properly only on ValueAxis. With CategoryAxis it wont work 100%, it depends on the period, zooming, etc. There is no guaranteed way to force category axis to show or hide first label.
showLastLabelBooleantrueWhether to show last axis label or not. This works properly only on ValueAxis. With CategoryAxis it wont work 100%, it depends on the period, zooming, etc. There is no guaranteed way to force category axis to show or hide last label.
tickLengthNumber5Length of the tick marks.
titleStringTitle of the axis.
titleBoldBooleantrueSpecifies if title should be bold or not.
titleColorColorColor of axis title. Will use text color of chart if not set any.
titleFontSizeNumberFont size of axis title. Will use font size of chart plus two pixels if not set any.
titleRotationNumberRotation of axis title. Useful if you want to make vertical axis title to be shown from top to down.

Methods

NameParametersReturnsDescription
addGuide(guide)guide - instance of GuideAdds guide to the axis.
removeGuide(guide)guide - instance of GuideRemoves guide from the axis.

Events

NameEvent objectDescription
clickGuide{type: "clickGuide", guide:Guide, chart:AmRectangularChart}Dispatched when user clicks on a guide.
clickItem{type: "clickItem", value:value, serialDataItem:SerialDataItem, axis:AxisBase, target:label, chart:AmRectangularChart, event:MouseEvent}Fired if user clicks on axis label.
rollOutGuide{type: "rollOutGuide", guide:Guide, chart:AmRectangularChart}Dispatched when user rolls-out of the guide.
rollOutItem{type: "rollOutItem", value:value, serialDataItem:SerialDataItem, axis:AxisBase, target:label, chart:AmRectangularChart, event:MouseEvent}Fired if user rolls-out of the axis label.
rollOutItem{type: "rollOutItem", value:value, serialDataItem:SerialDataItem, axis:AxisBase, target:label, chart:AmRectangularChart, event:MouseEvent}Fired if user rolls-out of the axis label.
rollOverGuide{type: "rollOverGuide", guide:Guide, chart:AmRectangularChart}Dispatched when user rolls-over some guide.
rollOverItem{type: "rollOverItem", value:value, serialDataItem:SerialDataItem, axis:AxisBase, target:label, chart:AmRectangularChart, event:MouseEvent}Fired if user rolls-over axis label.