AnyChart
API Reference
Still have questions?
Contact support
Top

class anychart.core.cartesian.series.Base Improve this Doc

Extends: anychart.core.SeriesBase

Base class for all cartesian series.
Base class defines common methods, such as those for:

  • Binding series to a scale: xScale, yScale
  • Base color settings: color
You can also obtain getIterator, getResetIterator iterators here.

Methods Overview

Specific settings
a11y()Accessibility setting.
clip()Series clip settings.
getPixelPointWidth()Gets point width in case of width-based series.
id()Series id.
selectionMode()Selection mode.
transformX()Transforms X value to pixel coordinates.
transformY()Transforms Y value to pixel coordinates.
xPointPosition()Position of the point.
Coloring
colorScale()Color scale settings.
Data
excludePoint()Excludes points at the specified index.
getExcludedPoints()Returns an array of excluded points.
getStat()Gets the statistics value by key.
includeAllPoints()Includes all excluded points.
includePoint()Includes excluded points with the specified indexes.
keepOnlyPoints()Keep only the specified points.
name()Series name settings.
Events
listen()Adds an event listener
listenOnce()Adds a single time event listener
removeAllListeners()Removes all listeners
unlisten()Removes the listener
unlistenByKey()Removes the listener by the key
Export
print()Prints all elements.
Interactivity
hovered()Hovered state settings.
normal()Normal state settings.
selected()Selected state settings.
unhover()Removes hover from the series.
unselect()Deselects all selected points.
Point Elements
error()Error settings.
getPoint()Gets wrapped point by index.
labels()Labels settings.
markers()Markers settings.
maxLabels()Maximum labels settings.
minLabels()Minimum labels settings.
Scales
xScale()X-scale settings.
yScale()Y-scale settings.
Series
rendering()Rendering settings
seriesType()Switch the series type
Size and Position
bottom()Bottom bound settings.
bounds()Bounds settings.
getPixelBounds()Returns pixel bounds.
height()Height settings.
left()Left bound settings.
maxHeight()Maximum height.
maxWidth()Maximum width.
minHeight()Minimum height.
minWidth()Minimum width.
right()Right bound settings.
top()Top bound settings.
width()Width settings.
zIndex()Z-index of the element.
Miscellaneous
isVertical()Getter for the series layout direction.

Methods Description

a11y

Getter for the accessibility setting.

Returns:

anychart.core.utils.SeriesA11y - Accessibility settings object.
See listing.
var series = chart.line([3, 5, 2, 14, 3]);
var a11y = series.a11y();
Setter for the accessibility setting.

Params:

NameTypeDescription
valueboolean | ObjectWhether to enable accessibility.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

bottom

Getter for element bottom bound settings.

Returns:

number | string | undefined - Element's bottom bound setting.
Setter for element bottom bound settings.

Params:

NameTypeDefaultDescription
bottomnumber | string | null
null
Bottom bound settings for the element.

Returns:

anychart.core.cartesian.series.Base - Returns self for method chaining.

bounds

Getter for element bounds settings.

Returns:

anychart.core.utils.Bounds - Bounds of the element.
Setter for bounds of the element using one parameter.

Params:

NameTypeDescription
boundsanychart.utils.RectObj | anychart.math.Rect | anychart.core.utils.BoundsBounds of element.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.
Setter for element bounds settings.

Params:

NameTypeDefaultDescription
xnumber | string
null
X-coordinate.
ynumber | string
null
Y-coordinate.
widthnumber | string
null
Width.
heightnumber | string
null
Height.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

clip

Getter for series clip settings.

Returns:

boolean | anychart.math.Rect - Clip settings.
Setter for series clip settings.

Params:

NameTypeDefaultDescription
valueboolean | anychart.math.Rect
False, if series is created manually.
True, if created via chart
Enable/disable series clip.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

colorScale

Getter for the color scale.
See listing
var series = chart.line();
var colorScale = series.colorScale();
Setter for the color scale.

Params:

NameTypeDescription
settingsanychart.scales.LinearColor | anychart.scales.OrdinalColor | Object | anychart.enums.ScaleTypes | stringScale to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

error

Getter for the series error.

Returns:

anychart.core.utils.Error - Series error.
Setter for the series error.

Params:

NameTypeDefaultDescription
settingsObject | null | boolean | string | number
false
Error settings. An error value can be set as absolute numbers or as a percentage.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

excludePoint

Excludes points at the specified index.

Params:

NameTypeDescription
indexesnumber | Array.<number>Points indexes.

Returns:

boolean - Returns true if the points were excluded.

getExcludedPoints

Returns an array of excluded points.

Returns:

Array.<anychart.core.Point> - Array of the points.

getPixelBounds

Returns pixel bounds of the element due to parent bounds and self bounds settings.

Returns:

anychart.math.Rect - Pixel bounds of the element.

getPixelPointWidth

Gets point width in case of width-based series. Note: Works only after anychart.charts.Cartesian#draw is called.

Returns:

number - Point width.

getPoint

Gets wrapped point by index.

Params:

NameTypeDescription
indexnumberPoint index.

Returns:

anychart.core.SeriesPoint - Wrapped point.

getStat

Gets the statistics value by key.

Params:

NameTypeDescription
keyanychart.enums.Statistics | stringKey.

Returns:

* - Statistics value.

height

Getter for element height settings.

Returns:

number | string | undefined - Element's height setting.
Setter for element height setting.

Params:

NameTypeDefaultDescription
heightnumber | string | null
null
Height settings for the element.

Returns:

anychart.core.cartesian.series.Base - Returns self for method chaining.

hovered

Getter for hovered state settings.

Returns:

anychart.core.StateSettings - Hovered state settings
Setter for hovered state settings.

Params:

NameTypeDescription
settingsObjectState settings to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

id

Getter for the series id.

Returns:

string | number - Series id.
Setter for the series id.

Params:

NameTypeDescription
idstring | numberId of the series. Default id is equal to internal index.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

includeAllPoints

Includes all excluded points.

Returns:

boolean - Returns true if all points were included.

includePoint

Includes excluded points with the specified indexes.

Params:

NameTypeDescription
indexesnumber | Array.<number>Points indexes.

Returns:

boolean - Returns true if the points were included.

isVertical

Getter for the series layout direction.

Returns:

boolean - The flag of the series layout direction.
See listing
var flag = series.isVertical();
Setter for the series layout direction. Set it to null to reset to the default. Learn more about Vertical chart.

Params:

NameTypeDescription
enabledboolean | nullWhether to change the series layout direction to vertical.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

keepOnlyPoints

Keep only the specified points.

Params:

NameTypeDescription
indexesnumber | Array.<number>Point index or indexes.

labels

Getter for series data labels.

Returns:

anychart.core.ui.LabelsFactory - Labels instance.
Setter for series data labels.

Params:

NameTypeDefaultDescription
settingsObject | boolean | null
false
Series data labels settings.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

left

Getter for element left bound settings.

Returns:

number | string | undefined - Element's left bound setting.
Setter for element left bound settings.

Params:

NameTypeDefaultDescription
leftnumber | string | null
null
Left bound setting for the element.

Returns:

anychart.core.cartesian.series.Base - Returns self for method chaining.

listen

Adds an event listener to an implementing object.

Params:

NameTypeDefaultDescription
typestring
The event type id.
listenerfunction(e:Object)
Callback method. Function that looks like:
function(event){
   // event.actualTarget - actual event target
   // event.currentTarget - current event target
   // event.iterator - event iterator
   // event.originalEvent - original event
   // event.point - event point
   // event.pointIndex - event point index
}
useCaptureboolean
false
Whether to fire in capture phase. Learn more about capturing https://javascript.info/bubbling-and-capturing
listenerScopeObject
Object in whose scope to call the listener.

Returns:

Object - Unique key for the listener.

listenOnce

Adds an event listener to an implementing object.

Params:

NameTypeDefaultDescription
typestring
The event type id.
listenerfunction(e:Object)
Callback method.
useCaptureboolean
false
Whether to fire in capture phase. Learn more about capturing https://javascript.info/bubbling-and-capturing
listenerScopeObject
Object in whose scope to call the listener.

Returns:

Object - Unique key for the listener.

markers

Getter for series data markers.

Returns:

anychart.core.ui.MarkersFactory - Markers instance.
Setter for series data markers.

Params:

NameTypeDefaultDescription
settingsObject | boolean | null | string
false
Series data markers settings.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

maxHeight

Getter for the maximum height.

Returns:

number | string | null - Element's maximum height.
Setter for the maximum height.

Params:

NameTypeDefaultDescription
heightnumber | string | null
null
Maximum height to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

maxLabels

Getter for maximum labels.

Returns:

anychart.core.ui.LabelsFactory - Labels instance.
Setter for maximum labels.

Params:

NameTypeDescription
settingsObject | boolean | nullMaximum labels settings.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

maxWidth

Getter for the maximum width.

Returns:

number | string | null - Element's maximum width.
Setter for the maximum width.

Params:

NameTypeDefaultDescription
widthnumber | string | null
null
Maximum width to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

minHeight

Getter for the minimum height.

Returns:

number | string | null - Element's minimum height.
Setter for the minimum height.

Params:

NameTypeDefaultDescription
heightnumber | string | null
null
Minimum height to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

minLabels

Getter for minimum labels.

Returns:

anychart.core.ui.LabelsFactory - Labels instance.
Setter for minimum labels.

Params:

NameTypeDescription
settingsObject | boolean | nullMinimum labels settings.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

minWidth

Getter for the minimum width.

Returns:

number | string | null - Element's minimum width.
Setter for the minimum width.

Params:

NameTypeDefaultDescription
widthnumber | string | null
null
Minimum width to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

name

Getter for the series name.

Returns:

string | undefined - Series name value.
Setter for the series name.

Params:

NameTypeDescription
namestringSeries name to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

normal

Getter for normal state settings.

Returns:

anychart.core.StateSettings - Normal state settings.
Setter for normal state settings.

Params:

NameTypeDescription
settingsObjectState settings to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

print

Prints all elements on related stage.

Params:

NameTypeDefaultDescription
paperSizeOrOptionsanychart.graphics.vector.PaperSize | Object
Paper size or object with options.
landscapeboolean
false
Flag of landscape.

removeAllListeners

Removes all listeners from an object. You can also optionally remove listeners of some particular type.

Params:

NameTypeDescription
typestringType of event to remove, default is to remove all types.

Returns:

number - Number of listeners removed.

rendering

Getter for the series rendering.

Returns:

anychart.core.series.RenderingSettings - Rendering settings.
Setter for the series rendering settings.

Params:

NameTypeDescription
settingsObject | functionRendering settings to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.
Getter for element right bound settings.

Returns:

number | string | undefined - Element's right bound setting.
Setter for element right bound setting.

Params:

NameTypeDefaultDescription
rightnumber | string | null
null
Right bound setting for the element.

Returns:

anychart.core.cartesian.series.Base - Returns self for method chaining.

selected

Getter for selected state settings.

Returns:

anychart.core.StateSettings - Selected state settings
Setter for selected state settings.

Params:

NameTypeDescription
settingsObjectState settings to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

selectionMode

Gets the state of the series for selection mode.

Returns:

anychart.enums.SelectionMode | string | null - Selection mode.
Allows to select points of the series. To select multiple points, press 'ctrl' and click on them.

Params:

NameTypeDefaultDescription
valueanychart.enums.SelectionMode | string | null
'multiSelect'
Selection mode.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

seriesType

Getter for switching of the series type.

Returns:

string - Series type.
Setter for switching of the series type.

Params:

NameTypeDescription
typestringSeries type to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

top

Getter for element top bound settings.

Returns:

number | string | undefined - Element's top bound setting.
Setter for element top bound settings.

Params:

NameTypeDefaultDescription
topnumber | string | null
null
Top bound setting for the element.

Returns:

anychart.core.cartesian.series.Base - Returns self for method chaining.

transformX

Transforms X value to pixel coordinates. Note: Works only after anychart.charts.Cartesian#draw is called.

Params:

NameTypeDescription
value*X value.
subRangeRationumberRange ratio value.

Returns:

number - Pixel value.

transformY

Transforms Y value to pixel coordinates. Note: Works only after anychart.charts.Cartesian#draw is called.

Params:

NameTypeDescription
value*Y value.
subRangeRationumberRange ratio value.

Returns:

number - Pixel value.

unhover

Removes hover from the series.

Params:

NameTypeDescription
indexOrIndexesnumber | Array.<number>Point index or array of indexes.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

unlisten

Removes a listener added using listen() or listenOnce() methods.

Params:

NameTypeDefaultDescription
typestring
The event type id.
listenerfunction(e:Object):boolean|undefined
Callback method.
useCaptureboolean
false
Whether to fire in capture phase. Learn more about capturing https://javascript.info/bubbling-and-capturing
listenerScopeObject
Object in whose scope to call the listener.

Returns:

boolean - Whether any listener was removed.

unlistenByKey

Removes an event listener which was added with listen() by the key returned by listen() or listenOnce().

Params:

NameTypeDescription
keyObjectThe key returned by listen() or listenOnce().

Returns:

boolean - Whether any listener was removed.

unselect

Deselects all selected points.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.
Deselects selected point by index.

Params:

NameTypeDescription
indexnumberIndex of the point to select.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.
Deselects selected points by indexes.

Params:

NameTypeDescription
indexesArray.<number>An array of indexes of the point to select.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

width

Getter for element width settings.

Returns:

number | string | undefined - Element's width setting.
Setter for element width setting.

Params:

NameTypeDefaultDescription
widthnumber | string | null
null
Width settings for the element.

Returns:

anychart.core.cartesian.series.Base - Returns self for method chaining.

xPointPosition

Getter for the position of the point on an ordinal scale.

Returns:

number - X-point position.
Setter for the position of the point on an ordinal scale.

Params:

NameTypeDefaultDescription
positionnumber
0.5
Point position (in 0 to 1 range).

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

xScale

Getter for the series X scale.

Returns:

anychart.scales.Ordinal - Series X scale.
Setter for the series X scale.

Params:

NameTypeDefaultDescription
settingsanychart.scales.Base | Object | anychart.enums.ScaleTypes | string
anychart.scales.Ordinal
Scale settings to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

yScale

Getter for the series Y scale.

Returns:

anychart.scales.Base - Series Y Scale.
Setter for the series Y scale.

Params:

NameTypeDefaultDescription
settingsanychart.scales.Base | Object | anychart.enums.ScaleTypes | string
anychart.scales.Linear
Scale settings to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.

zIndex

Getter for the Z-index of the element.

Returns:

number - Z-index.
Setter for the Z-index of the element.

Params:

NameTypeDefaultDescription
zIndexnumber
0
Value to set.

Returns:

anychart.core.cartesian.series.Base - Self instance for method chaining.