DurationAxis
Type class
A value axis whose values are amounts of baseUnit, with labels formatted as durations.
More info: Duration axis
Data item
DurationAxis uses data items of type IDurationAxisDataItem.
Sources
DurationAxis can be used (imported) via one of the following packages.
// Import DurationAxisimport * as am5xy from "@amcharts/amcharts5/xy";
// Create DurationAxisam5xy.DurationAxis.new(root, { // ... config if applicable});<!-- Load DurationAxis --><script src="xy.js"></script>
<script>// Create DurationAxisam5xy.DurationAxis.new(root, { // ... config if applicable});</script>Inheritance
DurationAxis extends ValueAxis.
DurationAxis is not extended by any other symbol.
Settings
Set these settings on a DurationAxis object using its set() and setAll() methods. Read about settings concept.
baseUnitType
TimeUnitDefault"second"The time unit the data's values are in: with
"second", a value of90is 1 minute 30 seconds.More info: Formatting durations: base unit
135 inherited items
activeType
undefined|false|trueInherited fromISpriteSettingsApplies the element's
"active"state whiletrue.animationsType
ArrayInherited fromIEntitySettingsSince 5.20.8Animations the element plays on its own, described as data - so they can be set from a JSON config and saved with it.
Each one animates a setting of the element (or, with
target: "dataItem", a value of its data item - a map point'spositionOnLine, say). They start when the setting is applied, restart when it changes, and stop when the element is disposed. A saved config keeps what was configured, never a value caught half way through an animation.sprite.set("animations", [ { key: "rotation", to: 360, duration: 4000, loops: 0 }, { key: "scale", from: 1, to: 1.3, duration: 800, loops: 0, yoyo: true, easing: "sine" } ]);appearDelayType
undefined|numberDefault0Inherited fromISpriteSettingsSince 5.21.0Milliseconds to wait before the
autoAppearanimation starts. The element stays hidden until then.appearDurationType
undefined|numberInherited fromISpriteSettingsSince 5.21.0Duration of the
autoAppearanimation, in milliseconds. Without it, the element'sstateAnimationDurationis used.ariaCheckedType
undefined|false|trueInherited fromISpriteSettingsaria-checkedsetting.This setting is ignored unless
roleis one of the following:"checkbox""option""radio""menuitemcheckbox""menuitemradio""treeitem"On a toggle"button"(one withtoggleKey) it is exposed asaria-pressed.
ariaControlsType
undefined|stringInherited fromISpriteSettingsaria-controlssetting.ariaCurrentType
undefined|stringInherited fromISpriteSettingsSince 5.9.8aria-currentsetting.More info: https://w3c.github.io/aria/#aria-current
ariaExpandedType
undefined|false|trueInherited fromISpriteSettingsSince 5.21.0aria-expandedsetting: whether the content the element shows or hides (e.g. a task's subtasks, a node's children) is shown.More info: https://w3c.github.io/aria/#aria-expanded
ariaHiddenType
undefined|false|trueInherited fromISpriteSettingsaria-hiddensetting.ariaLabelType
undefined|stringInherited fromISpriteSettingsLabel for the element to use for screen readers.
More info: Accessibility: screen reader
ariaLiveType
AriaLiveInherited fromISpriteSettingsaria-livesetting.ariaOrientationType
undefined|stringInherited fromISpriteSettingsaria-orientationsetting.ariaSelectedType
undefined|false|trueInherited fromISpriteSettingsSince 5.9.8aria-selectedsetting.More info: https://w3c.github.io/aria/#aria-selected
ariaValueMaxType
undefined|stringInherited fromISpriteSettingsaria-valuemaxsetting.ariaValueMinType
undefined|stringInherited fromISpriteSettingsaria-valueminsetting.ariaValueNowType
undefined|stringInherited fromISpriteSettingsaria-valuenowsetting.ariaValueTextType
undefined|stringInherited fromISpriteSettingsaria-valuetextsetting.autoAppearType
undefined|false|trueDefaultfalseInherited fromISpriteSettingsSince 5.21.0Plays the element's reveal animation, as
appear()does, when it is first drawn: a chart fades in, a series grows its columns or lines from the base. A series waits for its first data. It plays once: data updates do not replay it, but turning the setting off and on again does.Elements made from a template play as each one is made.
An element that starts hidden (
visible: false, or hidden in code before it is drawn) stays hidden. Ananimationsentry on the same setting, such as a pulsingopacity, keeps playing.This is how a JSON config gets the opening animation, as a config cannot call
appear().chart.setAll({ autoAppear: true, appearDuration: 1000, appearDelay: 100 }); series.setAll({ autoAppear: true, appearDuration: 1000 });chart.setAll({ autoAppear: true, appearDuration: 1000, appearDelay: 100 }); series.setAll({ autoAppear: true, appearDuration: 1000 });More info: Animations
autoZoomType
undefined|false|trueDefaulttrueInherited fromIValueAxisSettingsSince 5.2.20Rescales the axis to fit the values in view as the chart zooms along the other axis. Works only when that axis is not a plain
ValueAxis: aDateAxisor aCategoryAxis, for example.backgroundType
GraphicsInherited fromIContainerSettingsElement drawn behind the container's content, sized to fill the container.
More info: Containers: background
baseValueType
undefined|numberDefault0Inherited fromIValueAxisSettingsThe value columns grow from, splitting "positive" from "negative" values. Its grid line gets the
"base"theme tag.More info: Value axis: base value
blurType
undefined|numberInherited fromISpriteSettingsSince 5.5.0Blur radius in pixels, from
0(no blur) up.IMPORTANT: This setting is not supported in Safari browsers.
More info: Filters
brightnessType
undefined|numberInherited fromISpriteSettingsSince 5.5.0Brightness.
0- completely black1- no changes (default)>1- brighter IMPORTANT: This setting is not supported in Safari browsers.
More info: Filters
bulletType
undefined| (root:Root, axis:Axis, dataItem:DataItem) =>AxisBulletInherited fromIAxisSettingsFunction that creates an
AxisBulletfor each of the axis's cells, such as each category. Axis ranges get none.More info: Axes: axis bullets
calculateTotalsType
undefined|false|trueInherited fromIValueAxisSettingsCalculates totals across the axis's series for each data item in view:
valueYTotal,valueYSumandvalueYTotalPercent(or thevalueXones on an X axis), as used by 100% stacked charts. Series withexcludeFromTotalare left out.More info: Value axis: calculated values
centerXType
number|PercentInherited fromISpriteSettingsThe point of the element that is placed at its
xposition, and that it rotates and scales around: pixels from its left edge, or a percent of its width.centerYType
number|PercentInherited fromISpriteSettingsThe point of the element that is placed at its
yposition, and that it rotates and scales around: pixels from its top edge, or a percent of its height.clickAnnounceTextType
undefined|stringInherited fromISpriteSettingsSince 5.10.8If set, the text will be read out (announced) by a screen reader when focused element is "clicked" (by pressing ENTER or SPACE).
contrastType
undefined|numberInherited fromISpriteSettingsSince 5.5.0Contrast.
0- completely gray1- no changes (default)>1- more contrast IMPORTANT: This setting is not supported in Safari browsers.
More info: Filters
crispType
undefined|false|trueDefaultfalseInherited fromISpriteSettingsSince 5.3.0Draws the element sharply, with minimal anti-aliasing: its position is rounded to whole pixels, and
strokeWidthis adjusted to the device pixel ratio, so lines may look thinner than expected.NOTE: it may not work well on several elements that are meant to fit together exactly.
cursorOverStyleType
undefined|stringInherited fromISpriteSettingsCSS cursor to show while the pointer is over the element, e.g.
"pointer".More info: https://developer.mozilla.org/en-US/docs/Web/CSS/cursor
dateFormatterType
DateFormatter|undefinedInherited fromISpriteSettingsA
DateFormatterto use for this element instead of the root's.More info: /v5/concepts/using-formatters/
disabledType
undefined|false|trueInherited fromISpriteSettingsApplies the element's
"disabled"state whiletrue. It changes only the look: the element still responds to the pointer.draggableType
undefined|false|trueInherited fromISpriteSettingsLets the user drag the element. Touches that start on it no longer scroll the page.
durationFormatterType
DurationFormatter|undefinedInherited fromISpriteSettingsA
DurationFormatterto use for this element instead of the root's.More info: /v5/concepts/using-formatters/
dxType
undefined|numberInherited fromISpriteSettingsHorizontal shift in pixels. Can be negative to shift leftward.
dyType
undefined|numberInherited fromISpriteSettingsVertical shift in pixels. Can be negative to shift upward.
endType
undefined|numberDefault1Inherited fromIAxisSettingsEnd of the visible (zoomed) part of the axis:
0is the start of the axis,1the end. Set it to pre-zoom:0.9hides the last 10%.More info: Zoom and pan: pre zooming axes
exportableType
undefined|false|trueInherited fromISpriteSettingsIf
false, the element is left out of exported images of the chart.extraMaxType
undefined|numberInherited fromIValueAxisSettingsExtends the scale above the highest value by this share of the value range: with values from
0to1000,0.1ends the axis at1100(before rounding to the grid). If not set, alogarithmicaxis withoutstrictMinMaxuses0.2.More info: Value axis: relative scope extension
extraMinType
undefined|numberInherited fromIValueAxisSettingsExtends the scale below the lowest value by this share of the value range: with values from
0to1000,0.1starts the axis at-100(before rounding to the grid). If not set, alogarithmicaxis withoutstrictMinMaxuses0.1.More info: Value axis: relative scope extension
extraTooltipPrecisionType
undefined|numberInherited fromIValueAxisSettingsExtra decimal places for the axis tooltip, beyond those of the labels:
with labels like
1.1and1.2,1lets the tooltip show1.15.More info: Value axis: tooltip number format
fillRuleType
undefined| (dataItem:DataItem) =>voidInherited fromIValueAxisSettingsFunction that decides which axis fills show; it is called for each grid step. The default fills every other step.
More info: Axes: axis fills
fixAxisSizeType
undefined|false|trueDefaulttrueInherited fromIAxisSettingsKeeps the axis from shrinking as zooming changes the visible labels: it keeps room for the widest label shown so far.
focusableType
undefined|false|trueInherited fromISpriteSettingsCan element be focused, i.e. selected using TAB key.
More info: Accessibility: focusing elements
focusableGroupType
string|numberInherited fromISpriteSettingsSince 5.0.6An identifier by which to group common elements into focusable groups.
If set, only the first element in he group will be focusable via TAB key.
When it is selected, the rest of the elements in the same group can be selected using arrow keys.
It allows users to TAB-through chart elements quickly without the need to TAB into each and every element.
It's up to implementer of the charts to provide meaningful
ariaLabelto the element, which advertises this capability and provides adequate instructions.More info: Accessibility: grouping focusable elements
forceHiddenType
undefined|false|trueInherited fromISpriteSettingsHides the element whatever its
visiblesetting, even whenshow()is called.forceInactiveType
undefined|false|trueInherited fromISpriteSettingsSince 5.0.21Makes the element and its children ignore the pointer, even with
interactive: trueor event listeners set.heightType
number|Percent|nullInherited fromISpriteSettingsHeight in pixels, or a
Percentof the parent's inner height. In a vertical layout, a percent height is a share of the height the other children leave.hoverOnFocusType
undefined|false|trueInherited fromISpriteSettingsSimulate hover on an element when it gains focus, including changing hover appearance and displaying a tooltip if applicable.
More info: Accessibility: focusing elements
htmlType
undefined|stringInherited fromIContainerSettingsSince 5.2.11HTML content of the container. It can hold data placeholders, such as
{category}.More info: HTML content
hueType
undefined|numberInherited fromISpriteSettingsSince 5.5.0Rotates the hue of all colors by this many degrees, from
0to360.IMPORTANT: This setting is not supported in Safari browsers.
More info: Filters
idType
undefined|stringInherited fromIEntitySettingsA unique ID for looking the element up in
root.entitiesById. Setting an ID that another element already has throws an error.ignoreThemesType
undefined|false|trueDefaultfalseInherited fromIEntitySettingsSince 5.15.6Ignores themes: no theme rule applies to the element, not even one of the default theme.
interactiveType
undefined|false|trueInherited fromISpriteSettingsMakes the element respond to the pointer. Adding a pointer event listener to it turns this on.
interactiveChildrenType
undefined|false|trueDefaulttrueInherited fromIContainerSettingsMakes every descendant, not just direct children, interactive when the container itself is interactive.
interpolationDurationType
undefined|numberDefault0Inherited fromIComponentSettingsDuration in milliseconds of the animation from old values to new ones, e.g. when data changes.
More info: Animations: animating data values
interpolationEasingType
$ease.EasingInherited fromIComponentSettingsEasing function of the animation from old values to new ones.
More info: Animations: easing functions
invertType
undefined|numberInherited fromISpriteSettingsSince 5.5.0Color inversion, from
0(no changes) to1(fully inverted colors).IMPORTANT: This setting is not supported in Safari browsers.
More info: Filters
isMeasuredType
undefined|false|trueDefaulttrueInherited fromISpriteSettingsIf
false, the element's bounds are not measured, so it takes no part in its parent's layout or size.layerType
undefined|numberInherited fromISpriteSettingsLayer to draw the element on: elements on higher layers show in front of those on lower ones. If not set, the element is on its parent's layer.
layerMarginType
IMarginInherited fromISpriteSettingsSince @5.2.39Margins in pixels that make the element's layer larger than the chart, or, when negative, smaller.
layoutType
Layout|nullInherited fromIContainerSettingsHow children are arranged, e.g.
root.horizontalLayout,root.verticalLayoutorroot.gridLayout. Without a layout, children are placed by their ownxandy.More info: Containers: layout
logarithmicType
undefined|false|trueInherited fromIValueAxisSettingsUses a logarithmic scale. It can show only values above zero; see
treatZeroAs.More info: Value axis: logarithmic scale
marginBottomType
undefined|numberInherited fromISpriteSettingsBottom margin in pixels.
marginLeftType
undefined|numberInherited fromISpriteSettingsLeft margin in pixels.
marginRightType
undefined|numberInherited fromISpriteSettingsRight margin in pixels.
marginTopType
undefined|numberInherited fromISpriteSettingsTop margin in pixels.
maskType
Graphics|nullInherited fromIContainerSettingsAn element whose shape clips the container's children.
More info: Containers: masks
maskContentType
undefined|false|trueInherited fromIContainerSettingsClips all content that goes outside the container's bounds.
maxType
undefined|numberInherited fromIValueAxisSettingsHighest value of the axis scale, instead of the highest series value.
The axis may round it to fit its grid, unless
strictMinMaxistrue.More info: Value axis: custom scope
maxDeviationType
undefined|numberDefault0.1Inherited fromIAxisSettingsHow far past its ends the axis can be zoomed or panned, as a share of the visible range:
0.1is 10%.More info: Zoom and pan: over zooming
maxHeightType
number|nullInherited fromISpriteSettingsMaximum allowed height in pixels.
maxPrecisionType
undefined|numberInherited fromIValueAxisSettingsMost decimal places the labels may have. It also limits the grid step:
0allows whole-number steps only.More info: Value axis: label format
maxWidthType
number|nullInherited fromISpriteSettingsMaximum allowed width in pixels.
maxZoomCountType
undefined|numberInherited fromIAxisSettingsMost cells to show at a time, such as categories on a
CategoryAxisorbaseIntervalperiods on aDateAxis. The axis can't be zoomed out any further.More info: Zoom and pan: limiting zoom scope
maxZoomFactorType
number|nullDefault1000Inherited fromIAxisSettingsRoughly how many times the axis can be zoomed in. A
CategoryAxisignores it and zooms in as far asminZoomCountcategories; aDateAxisset tonull(its default) zooms in as far asminZoomCountbase intervals.minType
undefined|numberInherited fromIValueAxisSettingsLowest value of the axis scale, instead of the lowest series value. The axis may round it to fit its grid, unless
strictMinMaxistrue.More info: Value axis: custom scope
minHeightType
number|nullInherited fromISpriteSettingsMinimum allowed height in pixels.
minorAxisFillsEnabledType
undefined|false|trueInherited fromIAxisSettingsSince 5.14.0Creates axis fills for the cells of the minor grid too, not only the main one. The
fillRulestill decides which of them show.minWidthType
number|nullInherited fromISpriteSettingsMinimum allowed width in pixels.
minZoomCountType
undefined|numberInherited fromIAxisSettingsFewest cells to show at a time, such as categories on a
CategoryAxisorbaseIntervalperiods on aDateAxis. The axis can't be zoomed in any further.More info: Zoom and pan: limiting zoom scope
numberFormatType
undefined|stringInherited fromIValueAxisSettingsNumber format for the labels. If not set, the number formatter's default format is used, with as many decimals as the grid step needs.
More info: Value axis: label format
numberFormatterType
NumberFormatter|undefinedInherited fromISpriteSettingsA
NumberFormatterto use for this element instead of the root's.More info: /v5/concepts/using-formatters/
opacityType
undefined|numberDefault1Inherited fromISpriteSettingsOpacity, from
0(transparent) to1(opaque).The theme's
"default"state hasopacity: 1, soshow(), and leaving a state that changesopacity, bring it back to1, not to a value set here. To come back to another value, set it in the"default"state too:sprite.states.create("default", { opacity: 0.5 }).paddingBottomType
undefined|numberInherited fromIContainerSettingsBottom padding in pixels.
paddingLeftType
undefined|numberInherited fromIContainerSettingsLeft padding in pixels.
paddingRightType
undefined|numberInherited fromIContainerSettingsRight padding in pixels.
paddingTopType
undefined|numberInherited fromIContainerSettingsTop padding in pixels.
panXType
undefined|false|trueInherited fromIAxisSettingsfalsekeeps this axis in place when the chart is panned horizontally, by dragging or with the mouse wheel.panYType
undefined|false|trueInherited fromIAxisSettingsfalsekeeps this axis in place when the chart is panned vertically, by dragging or with the mouse wheel.positionType
"absolute"|"relative"Default"relative"Inherited fromISpriteSettingsPositioning of the element.
"absolute"leaves the element out of its parent's layout and size: it is placed by itsxandyonly.rendererType
RInherited fromIAxisSettingsThe renderer that draws the axis line, labels, ticks, grid and fills:
AxisRendererXfor a horizontal axis,AxisRendererYfor a vertical one.More info: XY chart: axis renderer
reverseChildrenType
undefined|false|trueInherited fromIContainerSettingsSince 5.1.1Lays out the children in reverse order.
roleType
RoleInherited fromISpriteSettingsElement's role.
More info: Accessibility: roles
rotationType
undefined|numberDefault0Inherited fromISpriteSettingsRotation in degrees, clockwise, around the point set by
centerXandcenterY.saturateType
undefined|numberInherited fromISpriteSettingsSince 5.5.0Saturation.
0- grayscale1- no changes (default)>1- more saturated IMPORTANT: This setting is not supported in Safari browsers.
More info: Filters
scaleType
undefined|numberDefault1Inherited fromISpriteSettingsScale, around the point set by
centerXandcenterY: below1shrinks the element, above1enlarges it.sepiaType
undefined|numberInherited fromISpriteSettingsSince 5.5.0Sepia tone, from
0(no changes) to1(full sepia).IMPORTANT: This setting is not supported in Safari browsers.
More info: Filters
setStateOnChildrenType
undefined|false|trueDefaultfalseInherited fromIContainerSettingsApplies every state set on the container to its children too.
More info: Containers: states
showTooltipOnType
"hover"|"always"|"click"Default"hover"Inherited fromISpriteSettingsSince 5.0.16When the element's tooltip shows:
"hover"(default) - while the pointer is over the element, or after a tap on it until a tap elsewhere."always"- all the time. To show tooltips of several elements at once, give each its ownTooltip(tooltip)."click"- after a click or tap on the element, until a click anywhere else on the page.
More info: Tooltips: sticky tooltips
snapTooltipType
undefined|false|trueDefaulttrueInherited fromIAxisSettingsSnaps the tooltip to
tooltipLocationin the cell under the cursor, instead of following the cursor exactly.startType
undefined|numberDefault0Inherited fromIAxisSettingsStart of the visible (zoomed) part of the axis:
0is the start of the axis,1the end. Set it to pre-zoom:0.1hides the first 10%.More info: Zoom and pan: pre zooming axes
stateAnimationDurationType
undefined|numberDefault0Inherited fromIEntitySettingsHow long, in milliseconds, a switch from one state to another animates.
0switches at once.stateAnimationEasingType
$ease.EasingDefaultout(cubic)Inherited fromIEntitySettingsEasing of the animated switch from one state to another.
strictMinMaxType
undefined|false|trueInherited fromIValueAxisSettingsMakes the scale start and end exactly at
minandmax, or where they aren't set, at the lowest and highest series values, without rounding.The axis then also stops rescaling to the values in view as the chart zooms. To rescale to the exact values in view, use
strictMinMaxSelectioninstead.extraMinandextraMaxstill add padding.More info: Value axis: custom scope
strictMinMaxSelectionType
undefined|false|trueInherited fromIValueAxisSettingsSince 5.1.11Rescales the axis to exactly the lowest and highest values in view as the chart zooms, without rounding. Keeps series of derived values, such as
valueYChangeSelection, from jumping around.Has no effect with
strictMinMax, which stops the rescaling.extraMinandextraMaxstill add padding.syncWithAxisType
ValueAxisInherited fromIValueAxisSettingsAnother
ValueAxiswhose grid this axis lines up with, by adjusting its own scale. A perfect match isn't always possible.More info: Value axis: syncing grid
syncZerosType
undefined|false|trueDefaultfalseInherited fromIValueAxisSettingsSince 5.16.2Lines up this axis's zero with the zero of
syncWithAxis, spreading the other grid lines above and below it. Needs zero within the range ofsyncWithAxis, which has to extend to each side where this axis has values.More info: Value axis: syncing grid
tabindexOrderType
undefined|numberInherited fromISpriteSettingsAn internal order by which focusable elements will be selected within the chart.
More info: Accessibility: focusing elements
templateFieldType
undefined|stringInherited fromISpriteSettingsField in the data item's data object that holds settings for this element, applied over its template's.
More info: Template fields
themesType
ArrayInherited fromIEntitySettingsThemes applied to the element and everything inside it.
themeTagsType
ArrayInherited fromIEntitySettingsTags that theme rules can target. They also count for the element's children, so a rule can match a child by a tag of its parent.
More info: Themes
themeTagsSelfType
ArrayInherited fromIEntitySettingsTags that theme rules can target, like
themeTags, but only for this element, not its children.More info: Themes
toggleKeyType
"disabled"|"active"|"none"|undefinedInherited fromISpriteSettingsSetting that a click or tap toggles between
trueandfalse:"active"or"disabled"."none"turns toggling off.tooltipType
TooltipInherited fromIAxisSettingsTooltip that shows the axis value at the cursor's position.
tooltipHTMLType
undefined|stringInherited fromISpriteSettingsSince 5.2.11HTML content of the element's tooltip, shown in place of
tooltipText.tooltipLocationType
undefined|numberDefault0.5Inherited fromIAxisSettingsWhere within a cell the tooltip snaps to when
snapTooltipis on:0the cell's start,0.5its middle,1its end.tooltipNumberFormatType
string|NumberFormatOptionsInherited fromIValueAxisSettingsNumber format for the axis tooltip. If not set,
numberFormatis used.More info: Value axis: tooltip number format
tooltipPositionType
"fixed"|"pointer"Default"fixed"Inherited fromISpriteSettingsWhere the tooltip points:
"fixed"attooltipXandtooltipY, or"pointer"at the pointer, following it.tooltipTextType
undefined|stringInherited fromISpriteSettingsText of the element's tooltip. It can hold data placeholders, such as
{value}.tooltipXType
number|PercentDefaultam5.percent(50)Inherited fromISpriteSettingsWhere on the element the tooltip points, horizontally: pixels from its left edge, or a percent of its width.
tooltipYType
number|PercentDefaultam5.percent(50)Inherited fromISpriteSettingsWhere on the element the tooltip points, vertically: pixels from its top edge, or a percent of its height.
treatZeroAsType
undefined|numberInherited fromIValueAxisSettingsOn a
logarithmicaxis, the value to plot zero and negative values at, since the scale can't show them.More info: Value axis: logarithmic scale
userDataType
anyInherited fromIEntitySettingsAny data of your own to keep with the element.
verticalScrollbarType
ScrollbarInherited fromIContainerSettingsA
Scrollbarthat scrolls the content vertically when it does not fit in the container.More info: Containers: scrollbar
visibleType
undefined|false|trueDefaulttrueInherited fromISpriteSettingsWhether the element is shown. Unlike
show()andhide(), it does not animate.wheelableType
undefined|false|trueInherited fromISpriteSettingsMakes the element receive mouse wheel events. While the pointer is over it, the wheel no longer scrolls the page.
widthType
number|Percent|nullInherited fromISpriteSettingsWidth in pixels, or a
Percentof the parent's inner width. In a horizontal layout, a percent width is a share of the width the other children leave.xType
number|Percent|nullInherited fromISpriteSettingsX position in the parent: pixels from its left edge, or a
Percentof its inner width, measured from inside its left padding.yType
number|Percent|nullInherited fromISpriteSettingsY position in the parent: pixels from its top edge, or a
Percentof its inner height, measured from inside its top padding.zoomableType
undefined|false|trueInherited fromIAxisSettingsfalsemakeszoom()do nothing, so the cursor, scrollbars, pinch and mouse wheel can't zoom or scroll the axis. Dragging the plot area still pans it.zoomOutType
undefined|false|trueDefaulttrueInherited fromIAxisSettingsSince 5.14.0falseleaves the axis out of the chart's zoom-out: the zoom-out button doesn't reset it, and zooming it doesn't show the button.zoomXType
undefined|false|trueInherited fromIAxisSettingsfalsekeeps this axis as it is when the mouse wheel zooms the chart horizontally. The cursor, scrollbars and pinch still zoom it; usezoomableto stop those too.zoomYType
undefined|false|trueInherited fromIAxisSettingsfalsekeeps this axis as it is when the mouse wheel zooms the chart vertically. The cursor, scrollbars and pinch still zoom it; usezoomableto stop those too.
Private settings
These are read-only settings accessible from a DurationAxis object using its getPrivate() method. Read about private settings.
durationFormatRead onlyType
stringThe duration format the axis picked for its labels and tooltip, based on the grid step.
20 inherited items
cellWidthRead onlyType
undefined|numberInherited fromIAxisPrivateDistance in pixels between grid lines (read-only). Approximate on a
DateAxis, whose grid can be uneven.Watch it to resize or hide labels so they don't overlap.
focusableRead onlyType
undefined|false|trueInherited fromISpritePrivateSince 5.3.16If set to
false, its tabindex will be set to -1, so it does not get focused with TAB, regardless whether its public settingfocusableis set totrue.htmlElementRead onlyType
HTMLDivElementInherited fromIContainerPrivateThe
<div>element that holds the container'shtmlcontent.htmlElementWrapperRead onlyType
HTMLDivElementInherited fromIContainerPrivateSince 5.11.2A wrapper
<div>forhtmlElement.lastTooltipCoordsRead onlyType
IPointInherited fromISpritePrivateSince 5.11.3The last point the tooltip was shown at, so it is not shown again at the same place.
maxRead onlyType
undefined|numberInherited fromIValueAxisPrivateCurrent highest value of the whole axis scale, not just the part in view.
maxFinalRead onlyType
undefined|numberInherited fromIValueAxisPrivateThe highest value of the axis scale once it settles. When the scale changes,
maxanimates towards it.minRead onlyType
undefined|numberInherited fromIValueAxisPrivateCurrent lowest value of the whole axis scale, not just the part in view.
minFinalRead onlyType
undefined|numberInherited fromIValueAxisPrivateThe lowest value of the axis scale once it settles. When the scale changes,
minanimates towards it.selectionMaxRead onlyType
undefined|numberInherited fromIValueAxisPrivateHighest value of the visible (zoomed) part of the axis. Except on a
DateAxis, it is rounded up to the grid step.selectionMaxFinalRead onlyType
undefined|numberInherited fromIValueAxisPrivateThe highest visible value the axis is zooming to. During a zoom animation,
selectionMaxholds the value along the way.selectionMinRead onlyType
undefined|numberInherited fromIValueAxisPrivateLowest value of the visible (zoomed) part of the axis. Except on a
DateAxis, it is rounded down to the grid step.selectionMinFinalRead onlyType
undefined|numberInherited fromIValueAxisPrivateThe lowest visible value the axis is zooming to. During a zoom animation,
selectionMinholds the value along the way.selectionStepFinalRead onlyType
undefined|numberInherited fromIValueAxisPrivateThe grid step the axis will have once the zoom animation ends.
showingTooltipRead onlyType
undefined|false|trueInherited fromISpritePrivatetruewhile the element shows its tooltip.stepRead onlyType
undefined|numberInherited fromIValueAxisPrivateValue step between grid lines.
stepDecimalPlacesRead onlyType
undefined|numberInherited fromIValueAxisPrivateDecimal places used when formatting axis labels.
tooltipPositionRead onlyType
undefined|numberInherited fromIAxisPrivatePosition on the axis (
0to1) the tooltip points to.tooltipTargetRead onlyType
GraphicsInherited fromISpritePrivateAn element whose tooltip point and colors the tooltip uses, in place of this element's.
trustBoundsRead onlyType
undefined|false|trueInherited fromISpritePrivateSince 5.5.0Checks that the pointer is within the element's bounds before dispatching
"pointerover". This prevents ghost tooltips that sometimes appear while the pointer moves over interactive elements.It is
trueby default onRectangleandCircle.
Properties
classNameStaticType
stringDefault"DurationAxis"classNamesStaticType
ArrayDefaultValueAxis.classNames.concat([DurationAxis.className])
24 inherited items
adaptersType
AdaptersDefaultnew Adapters(this)Inherited fromEntityaxisHeaderType
ContainerDefaultthis.children.push(Container.new(this._root, { themeTags: ["axis", "header"], position: "absolute", background: Rectangle.new(this._root, { themeTags: ["header", "background"], fill: this._root.interfaceColors.get("background") })._markC("themeTags", "fill") })._markC("themeTags", "position", "background"))Inherited fromAxisA container for extra content, such as a legend, a label or an icon. It sits above a Y axis, and to the left of an X axis.
More info: Axis headers
axisRangesType
ListDefaultnew List()Inherited fromAxisThe axis's ranges: highlighted values or spans, each with its own grid, label and fill.
More info: Axis ranges
bulletsContainerType
ContainerDefaultthis.children.push(Container.new(this._root, { isMeasured: false, width: p100, height: p100, position: "absolute" }))Inherited fromAxisHolds the axis's bullets.
chartType
XYChart|undefinedInherited fromAxisThe chart the axis belongs to.
childrenType
ChildrenDefaultnew Children(this)Inherited fromContainerThe container's child elements.
dataType
ListDataInherited fromComponentThe component's data: a list of data objects, each made into a data item.
More info: Data
dataItemType
DataItem|undefinedInherited fromSpriteThe element's
DataItem, or, if it has none, its nearest parent's.NOTE: data items are assigned automatically in most cases where it matters. Set one only if you know what you are doing.
dataItemsType
ArrayInherited fromComponentThe component's data items.
enableDisposeType
booleanDefaulttrueInherited fromSettingsSet to
falseto makedispose()do nothing.eventsType
SpriteEventDispatcherInherited fromSpriteghostLabelType
AxisLabelInherited fromAxisAn invisible label that keeps room for the axis's widest label, so the axis doesn't shrink while zooming (see
fixAxisSize).More info: Value axis: ghost label
gridContainerType
ContainerDefaultContainer.new(this._root, { width: p100, height: p100 })Inherited fromAxisHolds the axis's grid and fills, drawn below the series.
initedType
booleanDefaultfalseInherited fromComponentBecomes
trueafter the component's first update.labelsContainerType
ContainerDefaultthis.children.push(Container.new(this._root, {}))Inherited fromAxisHolds the axis's labels and ticks.
minorDataItemsType
ArrayDefault[]Inherited fromAxisData items of the minor grid.
parentType
Container|undefinedInherited fromSpriteParent
Containerof this element.rootType
RootInherited fromEntitySince 5.0.6The
Rootthe object belongs to.seriesA list of series using this axis.
statestemplateType
Template|undefinedInherited fromEntityA
Templateapplied to the object. Its settings apply where the object has none set of its own.topGridContainerType
ContainerDefaultContainer.new(this._root, { width: p100, height: p100 })Inherited fromAxisHolds the grid and fills of axis ranges set to be drawn
abovethe series.uidType
numberDefault++counterInherited fromSettingsA unique number, given to each object as it is created.
virtualParent
Methods
getTooltipText(position:number,
_adjustPosition?:undefined|false|true)Returns
string|undefinedReturns the text the axis tooltip shows at a position, formatted as a duration.
83 inherited items
allChildren()Returns
ArrayInherited fromContainerReturns all children, including the background, vertical scrollbar and mask.
animate(options:AnimationOptions)Returns
AnimationInherited fromSettingsAnimates a setting from its current value (or
from) toto. The setting jumps tofromat once. Withduration0, or no value to start from, it is set totoat once and the returned animation is already stopped.More info: Animations: animating settings
appear(duration?:undefined|number,
delay?:undefined|number)Returns
PromiseInherited fromSpritePlays the reveal animation: hides the element at once, then shows it, whether it was hidden or not.
basePosition()Returns
numberInherited fromValueAxisReturns the position (
0to1) of the axis's base value.baseValue()Returns
numberInherited fromValueAxisReturns the
baseValuesetting, kept within the axis's scale.compositeOpacity()Returns
numberInherited fromSpriteSince 5.2.11Returns the element's opacity multiplied by those of all its parents.
compositeRotation()Returns
numberInherited fromSpriteSince 5.9.2Returns the element's rotation plus those of all its parents, in degrees.
compositeScale()Returns
numberInherited fromSpriteSince 5.9.2Returns the element's scale multiplied by those of all its parents.
contentHeight()Returns
numberInherited fromContainercontentWidth()Returns
numberInherited fromContainercoordinateToPosition(coordinate:number)Returns
numberInherited fromAxisConverts a pixel coordinate along the axis, from its left or top edge, to a position on the axis (
0to1), taking zoom into account.createAxisRange(axisDataItem:DataItem)Returns
DataItemInherited fromAxisAdds a data item, made with
axis.makeDataItem(), as an axis range and returns it.More info: Axis ranges
depth()Returns
numberInherited fromSpriteReturns how deep the element is in the tree: the number of parents it has.
dispose()Returns
voidInherited fromSettingsDisposes the object, freeing everything it holds. A disposed object can't be used again.
eachChildren(f: (child:Sprite) =>void)Returns
voidInherited fromContainerCalls
ffor each child, including the background, vertical scrollbar and mask.get(key:Key,
fallback:F)Returns
NonNullable|FInherited fromEntityReturns the value of setting
key, run through any adapters, orfallbackif it is not set.More info: Settings
getCellWidthPosition()Returns
numberInherited fromValueAxisReturns the distance between two grid lines as a share of the visible part of the axis.
getDataItemById(id:string)Returns
DataItem|undefinedInherited fromComponentReturns the data item whose
idmatches, if any.getDateFormatter()Returns
DateFormatterInherited fromSpriteReturns the
DateFormatterof the element: its owndateFormatter, or else the one of theRoot.More info: /v5/concepts/using-formatters/
getDurationFormatter()Returns
DurationFormatterInherited fromSpriteReturns the
DurationFormatterof the element: its owndurationFormatter, or else the one of theRoot.More info: /v5/concepts/using-formatters/
getNumberFormatter()Returns
NumberFormatterInherited fromSpriteReturns the
NumberFormatterof the element: its ownnumberFormatter, or else the one of theRoot.More info: /v5/concepts/using-formatters/
getSeriesItem(series:XYSeries,
position:number)Returns
DataItem|undefinedInherited fromValueAxisReturns the series data item whose value is closest to a position on the axis.
getTooltip()Returns
Tooltip|undefinedInherited fromSpriteReturns the element's
Tooltip: its owntooltip, or else the nearest parent's.getX(value:number,
location:number,
baseValue:number)Returns
anyInherited fromValueAxisReturns the X coordinate in pixels of a value, from the axis's left edge.
getY(value:number,
location:number,
baseValue:number)Returns
anyInherited fromValueAxisReturns the Y coordinate in pixels of a value, from the axis's top edge.
has(key:Key)Returns
booleanInherited fromSettingsReturns
trueif settingkeyis set.More info: Settings
height()Returns
numberInherited fromSpriteReturns the element's height in pixels.
hide(duration?:undefined|number)Returns
PromiseInherited fromSpriteHides the element and returns a
Promisethat resolves when its hiding animations finish.series.hide().then(function(ev) { console.log("Series finished hiding"); })series.hide().then(function(ev) { console.log("Series finished hiding"); })hideTooltip()Returns
Promise|undefinedInherited fromSpriteHides the element's
Tooltip.hover()Returns
voidInherited fromSpriteHovers the element as if the pointer were over it: applies its hover state and shows its tooltip.
innerHeight()Returns
numberInherited fromContainerReturns the container's height without padding, in pixels.
innerWidth()Returns
numberInherited fromContainerReturns the container's width without padding, in pixels.
isDisposed()Returns
booleanInherited fromSettingsReturns
trueif the object has been disposed.isDragging()Returns
booleanInherited fromSpriteReturns
truewhile the element is being dragged.isFocus()Returns
booleanInherited fromSpriteReturns
trueif this element does currently have focus.isHidden()Returns
booleanInherited fromSpriteReturns
trueif the element was hidden withhide(), even while its hiding animation still plays. For thevisiblesetting, useisVisible().isHiding()Returns
booleanInherited fromSpriteReturns
truewhile the element's hiding animation plays.isHover()Returns
booleanInherited fromSpriteReturns
trueif the pointer is over the element.isShowing()Returns
booleanInherited fromSpriteReturns
truewhile the element's showing animation plays.isType(type:string)Returns
thisInherited fromEntityReturns
trueif the object is of classtypeor extends it.isVisible()Returns
booleanInherited fromSpriteReturns
falseif either the public or the private settingvisibleisfalse, orforceHiddenistrue.isVisibleDeep()Returns
booleanInherited fromSpriteSince 5.2.7Same as
isVisible(), except it checks all ascendants, too.makeDataItem(data:IComponentDataItem,
dataContext?:any)Returns
DataItemInherited fromComponentCreates and processes a data item, without adding it to
dataItems.markDirtyKey(key:Key)Returns
voidInherited fromSpriteMarks a setting as changed, so the element reads it again, running its adapters, on the next frame.
markDirtyValues(_dataItem?:DataItem)Returns
voidInherited fromComponentSince 5.0.21Makes the component redraw from its data on the next frame.
maxHeight()Returns
numberInherited fromSpriteReturns the most height the element may take, in pixels: its
maxHeight, a fixedheight, or else its parent's inner height.maxWidth()Returns
numberInherited fromSpriteReturns the most width the element may take, in pixels: its
maxWidth, a fixedwidth, or else its parent's inner width.new(root:Root,
settings:ITSettings,
template?:Template)StaticReturns
TInherited fromEntityCreates an instance of the class. Use it instead of
new Class().More info: Getting started: new element syntax
off(key:Key,
callback?:undefined| (value:[""], target:this, key:Key) =>void)Returns
voidInherited fromSettingsSince 5.9.2Removes a callback added with
on(). Withoutcallback, removes all of them forkey.More info: Events: settings value change
offDebounced(key:Key,
callback?:undefined| (value:[""], target:this, key:Key) =>void)Returns
voidInherited fromSettingsRemoves a callback added with
onDebounced(). Withoutcallback, removes all of them forkey.More info: Events: settings value change
offDebouncedPrivate(key:Key,
callback?:undefined| (value:[""], target:this, key:Key) =>void)Returns
voidInherited fromSettingsRemoves a callback added with
onPrivateDebounced(). Withoutcallback, removes all of them forkey.More info: Events: settings value change
offPrivate(key:Key,
callback?:undefined| (value:[""], target:this, key:Key) =>void)Returns
voidInherited fromSettingsSince 5.9.2Removes a callback added with
onPrivate(). Withoutcallback, removes all of them forkey.More info: Events: settings value change
on(key:Key,
callback: (value:[""], target:this, key:Key) =>void)Returns
IDisposerInherited fromSettingsCalls
callbackeach time the value of settingkeychanges or is removed. Setting the same value again does not call it.More info: Events: settings value change
once(key:Key,
callback: (value:[""], target:this, key:Key) =>void)Returns
IDisposerInherited fromSettingsSince 5.20.4Like
on(), but the callback is removed after it is called once.More info: Events: settings value change
onceDebounced(key:Key,
callback: (value:[""], target:this, key:Key) =>void,
debounceDelay:number)Returns
IDisposerInherited fromSettingsSince 5.20.4Like
onDebounced(), but the callback is removed after it is called once.More info: Events: settings value change
onDebounced(key:Key,
callback: (value:[""], target:this, key:Key) =>void,
debounceDelay:number)Returns
IDisposerInherited fromSettingsLike
on(), but waits until settingkeyhas not changed fordebounceDelaymilliseconds, then callscallbackonce with the latest value.More info: Events: settings value change
onPrivate(key:Key,
callback: (value:[""], target:this, key:Key) =>void)Returns
IDisposerInherited fromSettingsCalls
callbackeach time the value of private settingkeychanges.More info: Events: settings value change
onPrivateDebounced(key:Key,
callback: (value:[""], target:this, key:Key) =>void,
debounceDelay:number)Returns
IDisposerInherited fromSettingsLike
onPrivate(), but waits until private settingkeyhas not changed fordebounceDelaymilliseconds, then callscallbackonce with the latest value.More info: Events: settings value change
positionToValue(position:number)Returns
numberInherited fromValueAxisConverts a position on the axis (
0to1, regardless of zoom) to a value.pushDataItem(data:IComponentDataItem,
dataContext?:any)Returns
DataItemInherited fromComponentCreates a data item straight from settings, not from data, and adds it to the component's data items.
remove(key:Key)Returns
voidInherited fromEntityRemoves the value set for setting
key. The setting goes back to the value from a theme or template, if one has it.More info: Settings
removeAll()Returns
voidInherited fromSettingsRemoves all settings, as
remove()does for each one.More info: Settings
scrollToChild(child:Sprite)Returns
voidInherited fromContainerSince 5.10.5Scrolls the container so that the child comes into view, if it is out of view. Works only on a container with a
verticalScrollbar.set(key:Key,
value:Value)Returns
ValueInherited fromEntitySets setting
keytovalueand returnsvalue. A value set this way overrides themes and templates, and stops any animation of the setting.More info: Settings
setAll(settings:Partial)Returns
voidInherited fromSettingsSets several settings at once, from an object of key-value pairs.
More info: Settings
setTimeout(fn: () =>void,
delay:number)Returns
IDisposerInherited fromEntityCalls
fnafterdelaymilliseconds, unless the object is disposed first. Disposing the returned disposer cancels it.show(duration?:undefined|number)Returns
PromiseInherited fromSpriteShows the element and returns a
Promisethat resolves when its showing animations finish.series.show().then(function(ev) { console.log("Series is now fully visible"); })series.show().then(function(ev) { console.log("Series is now fully visible"); })showTooltip(point?:IPoint)Returns
Promise|undefinedInherited fromSpriteShows the element's
Tooltip. Does nothing if the element has notooltipTextortooltipHTML.toAxisPosition(position:number)Returns
numberInherited fromAxisConverts a position in the plot area (
0to1, from its left or top edge) to a position on the axis, taking zoom andinversedinto account.toBack()Returns
voidInherited fromSpriteMoves the element to the start of its parent's children, so it is drawn under its siblings, or, in a layout, placed first.
toFront()Returns
voidInherited fromSpriteMoves the element to the end of its parent's children, so it is drawn over its siblings, or, in a layout, placed last.
toGlobal(point:IPoint)Returns
IPointInherited fromSpriteConverts a point within the element to a point relative to the root.
toGlobalPosition(position:number)Returns
numberInherited fromAxisSince 5.4.2Converts a position on the axis to a position in the plot area (
0to1, from its left or top edge): the opposite oftoAxisPosition.toLocal(point:IPoint)Returns
IPointInherited fromSpriteConverts a point relative to the root to a point within the element.
unhover()Returns
voidInherited fromSpriteEnds a hover, as if the pointer left the element: hides its tooltip and takes it out of its hover state.
updateData(data:Array)Returns
voidInherited fromComponentUpdates the data in place, keeping the existing data items: each object's values go into the data item at the same index. Extra objects are added as new data items, and data items beyond the new data are removed.
updateTooltip()Returns
voidInherited fromAxisMoves the axis tooltip, and the series tooltips it drives, to the cursor's current position. Call it after changing the zoom from code.
valueToPosition(value:number)Returns
numberInherited fromValueAxisConverts a value to a position on the axis (
0to1, regardless of zoom).width()Returns
numberInherited fromSpriteReturns the element's width in pixels.
x()Returns
numberInherited fromSpriteReturns the element's X position in pixels, relative to its parent, without
dx.y()Returns
numberInherited fromSpriteReturns the element's Y position in pixels, relative to its parent, without
dy.zoom(start:number,
end:number,
duration?:undefined|number,
priority?:"start"|"end")Returns
Animation|Animation|undefinedInherited fromAxisZooms the axis to the range between
startandend, where0is the start of the axis and1the end. The range is kept withinmaxDeviation,maxZoomFactor,minZoomCountandmaxZoomCount.zoomToValues(start:number,
end:number,
duration?:undefined|number)Returns
voidInherited fromValueAxisZooms the axis to the range between two values.
Events
Add event handlers to DurationAxis object using its events.on() method. Read about adding event handlers.
22 inherited items
blurParam { type:
"blur", target:DurationAxis, originalEvent:FocusEvent, target:Sprite}Inherited fromISpriteEventsInvoked when element loses focus.
boundschangedParam { type:
"boundschanged", target:DurationAxis}Inherited fromISpriteEventsThe element's bounds changed.
clickParam { type:
"click", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsThe element was clicked or tapped. A press and release more than 5 pixels apart is not a click.
dataitemchangedParam { type:
"dataitemchanged", target:DurationAxis, newDataItem:DataItem|undefined, oldDataItem:DataItem|undefined}Inherited fromISpriteEventsThe element's data item changed.
datavalidatedParam { type:
"datavalidated", target:DurationAxis}Inherited fromIComponentEventsThe component's data changed and was processed.
dblclickParam { type:
"dblclick", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsThe element was double-clicked or double-tapped. Also dispatched on its parents.
draggedParam { type:
"dragged", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsThe element moved while being dragged.
dragstartParam { type:
"dragstart", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsDragging of the element started: the pointer moved more than 5 pixels after pressing on it.
dragstopParam { type:
"dragstop", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsDragging of the element stopped.
focusParam { type:
"focus", target:DurationAxis, originalEvent:FocusEvent, target:Sprite}Inherited fromISpriteEventsInvoked when element gains focus.
globalpointerdownParam { type:
"globalpointerdown", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsA pointer button was pressed, or a touch started, anywhere in the window, even outside the chart.
globalpointermoveParam { type:
"globalpointermove", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsThe pointer moved anywhere in the window, even outside the chart.
globalpointerupParam { type:
"globalpointerup", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsA pointer button was released, or a touch ended, anywhere in the window, even outside the chart.
middleclickParam { type:
"middleclick", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsThe element was clicked with the middle mouse button.
pointerdownParam { type:
"pointerdown", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsA pointer button was pressed, or a touch started, over the element. Also dispatched on its parents.
pointeroutParam { type:
"pointerout", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsThe pointer left the element.
pointeroverParam { type:
"pointerover", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsThe pointer moved over the element.
pointerupParam { type:
"pointerup", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsA pointer button was released, or a touch ended, over the element.
positionchangedParam { type:
"positionchanged", target:DurationAxis}Inherited fromISpriteEventsThe element's position changed.
rightclickParam { type:
"rightclick", target:DurationAxis} &ISpritePointerEventInherited fromISpriteEventsThe element was clicked with the right mouse button.
valueschangedParam { type:
"valueschanged", target:DurationAxis}Inherited fromIComponentEventsValues of the component's data items changed.
wheelParam { type:
"wheel", target:DurationAxis, originalEvent:WheelEvent, point:IPoint}Inherited fromISpriteEventsThe mouse wheel turned while the pointer was over the element. Also dispatched on its parents.