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
Methods Overview
Specific settings | |
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. |
Data | |
excludePoint() | Excludes points at the specified index. |
getExcludedPoints() | Returns an array of excluded points. |
includeAllPoints() | Includes all excluded points. |
includePoint() | Includes excluded points with the specified indexes. |
keepOnlyPoints() | Keep only the specified points. |
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 | |
enabled() | Element state (enabled or disabled). |
unhover() | Removes hover from the series. |
unselect() | Deselects all selected points. |
Point Elements | |
error() | Error settings. |
getPoint() | Gets wrapped point by index. |
Scales | |
xScale() | X-scale settings. |
yScale() | Y-scale settings. |
Series | |
rendering() | Rendering settings |
seriesType() | Switch the series type |
Size and Position | |
bottom() | Bottom bound setting. |
bounds() | Bounds settings. |
getPixelBounds() | Returns pixel bounds. |
height() | Height setting. |
left() | Left bound setting. |
maxHeight() | Maximum height. |
maxWidth() | Maximum width. |
minHeight() | Minimum height. |
minWidth() | Minimum width. |
right() | Right bound setting. |
top() | Top bound setting. |
width() | Width setting. |
zIndex() | Z-index of the element. |
Miscellaneous | |
isVertical() | Getter for the series layout direction. |
Methods Description
bottom
Returns:
number | string | undefined - Current element's bottom bound setting.Params:
Name | Type | Default | Description |
---|---|---|---|
value | number | string | null | null | Bottom bound setting for the element. |
Returns:
anychart.core.cartesian.series.Base - Returns self for method chaining.Try it:
bounds
Returns:
anychart.core.utils.Bounds - Current bounds of the element.Params:
Name | Type | Description |
---|---|---|
value | anychart.utils.RectObj | anychart.math.Rect | anychart.core.utils.Bounds | Bounds of element. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
Params:
Name | Type | Default | Description |
---|---|---|---|
x | number | string | null | X-coordinate. |
y | number | string | null | Y-coordinate. |
width | number | string | null | Width. |
height | number | string | null | Height. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
clip
Params:
Name | Type | Default | Description |
---|---|---|---|
value | boolean | anychart.math.Rect | False, if series is created manually. | Enable/disable series clip. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
enabled
Returns:
boolean - The current element state.Try it:
Params:
Name | Type | Default | Description |
---|---|---|---|
value | boolean | true | Value to set. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.if (!element.enabled()) element.enabled(true);
Try it:
error
- null - disable series error.
- boolean - enable mode both or none for series error.
- string - sets value for series error.
- object - sets series error settings.
Params:
Name | Type | Default | Description |
---|---|---|---|
value | Object | 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
Params:
Name | Type | Description |
---|---|---|
indexes | number | Array.<number> | Points indexes. |
Returns:
boolean - Returns true if the points were excluded.Try it:
getExcludedPoints
Returns:
Array.<anychart.core.Point> - Array of the points.Try it:
getPixelBounds
Returns:
anychart.math.Rect - Pixel bounds of the element.getPixelPointWidth
Returns:
number - Point width.Try it:
getPoint
Params:
Name | Type | Description |
---|---|---|
index | number | Point index. |
Returns:
anychart.core.SeriesPoint - Wrapped point.Try it:
height
Returns:
number | string | undefined - Current element's height setting.Params:
Name | Type | Default | Description |
---|---|---|---|
value | number | string | null | null | Height setting for the element. |
Returns:
anychart.core.cartesian.series.Base - Returns self for method chaining.Try it:
id
Returns:
string | number - The current series id.Try it:
Params:
Name | Type | Description |
---|---|---|
value | string | number | Id of the series. Default id is equal to internal index. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
includeAllPoints
Returns:
boolean - Returns true if all points were included.Try it:
includePoint
Params:
Name | Type | Description |
---|---|---|
indexes | number | Array.<number> | Points indexes. |
Returns:
boolean - Returns true if the points were included.Try it:
isVertical
Returns:
boolean - The flag of the series layout direction.var flag = series.isVertical();
Params:
Name | Type | Description |
---|---|---|
value | boolean | null | Whether to change the series layout direction to vertical. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
keepOnlyPoints
Params:
Name | Type | Description |
---|---|---|
indexes | number | Array.<number> | Point index or indexes. |
Try it:
left
Returns:
number | string | undefined - Current element's left bound setting.Params:
Name | Type | Default | Description |
---|---|---|---|
value | number | string | null | null | Left bound setting for the element. |
Returns:
anychart.core.cartesian.series.Base - Returns self for method chaining.Try it:
listen
Note Notice that if the existing listener is one-off (added using listenOnce), it will cease to be such after calling the listen() method.
Params:
Name | Type | Default | Description |
---|---|---|---|
type | string | The event type id. | |
listener | function | 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
} . | |
useCapture | boolean | false | Whether to fire in capture phase. Learn more about capturing https://javascript.info/bubbling-and-capturing |
listenerScope | Object | Object in whose scope to call the listener. |
Returns:
Object - Unique key for the listener.Try it:
listenOnce
If the event handler being added already exists, listenOnce will do nothing.
Note In particular, if the handler is already registered using listen(), listenOnce() will not make it one-off. Similarly, if a one-off listener already exists, listenOnce will not change it (it wil remain one-off).
Params:
Name | Type | Default | Description |
---|---|---|---|
type | string | The event type id. | |
listener | function | Callback method. | |
useCapture | boolean | false | Whether to fire in capture phase. Learn more about capturing https://javascript.info/bubbling-and-capturing |
listenerScope | Object | Object in whose scope to call the listener. |
Returns:
Object - Unique key for the listener.Try it:
maxHeight
Returns:
number | string | null - Current element's maximum height.Params:
Name | Type | Default | Description |
---|---|---|---|
value | number | string | null | null | Value to set. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
maxWidth
Returns:
number | string | null - Current element's maximum width.Params:
Name | Type | Default | Description |
---|---|---|---|
value | number | string | null | null | Value to set. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
minHeight
Returns:
number | string | null - Current element's minimum height.Params:
Name | Type | Default | Description |
---|---|---|---|
value | number | string | null | null | Value to set. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
minWidth
Returns:
number | string | null - Current element's minimum width.Params:
Name | Type | Default | Description |
---|---|---|---|
value | number | string | null | null | Value to set. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
Params:
Name | Type | Default | Description |
---|---|---|---|
paperSizeOrOptions | anychart.graphics.vector.PaperSize | Object | Paper size or object with options. | |
landscape | boolean | false | Flag of landscape. |
Try it:
removeAllListeners
Params:
Name | Type | Description |
---|---|---|
type | string | Type of event to remove, default is to remove all types. |
Returns:
number - Number of listeners removed.Try it:
rendering
Returns:
anychart.core.series.RenderingSettings - Rendering settings.Try it:
Params:
Name | Type | Description |
---|---|---|
value | Object | function | Value to set. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
right
Returns:
number | string | undefined - Current element's right bound setting.Params:
Name | Type | Default | Description |
---|---|---|---|
value | number | string | null | null | Right bound setting for the element. |
Returns:
anychart.core.cartesian.series.Base - Returns self for method chaining.Try it:
selectionMode
Returns:
anychart.enums.SelectionMode | null - Selection mode.Try it:
Params:
Name | Type | Default | Description |
---|---|---|---|
value | anychart.enums.SelectionMode | string | null | "multiSelect" | Selection mode. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
seriesType
Params:
Name | Type | Description |
---|---|---|
value | string | Series type. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
top
Returns:
number | string | undefined - Current element's top bound setting.Params:
Name | Type | Default | Description |
---|---|---|---|
value | number | string | null | null | Top bound setting for the element. |
Returns:
anychart.core.cartesian.series.Base - Returns self for method chaining.Try it:
transformX
Params:
Name | Type | Description |
---|---|---|
value | * | X value. |
subRangeRatio | number | Range ratio value. |
Returns:
number - Pixel value.Try it:
transformY
Params:
Name | Type | Description |
---|---|---|
value | * | Y value. |
subRangeRatio | number | Range ratio value. |
Returns:
number - Pixel value.Try it:
unhover
Params:
Name | Type | Description |
---|---|---|
indexOrIndexes | number | Array.<number> | Point index or array of indexes. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
unlisten
Params:
Name | Type | Default | Description |
---|---|---|---|
type | string | The event type id. | |
listener | function | Callback method. | |
useCapture | boolean | false | Whether to fire in capture phase. Learn more about capturing https://javascript.info/bubbling-and-capturing |
listenerScope | Object | Object in whose scope to call the listener. |
Returns:
boolean - Whether any listener was removed.Try it:
unlistenByKey
Params:
Name | Type | Description |
---|---|---|
key | Object | The key returned by listen() or listenOnce(). |
Returns:
boolean - Whether any listener was removed.Try it:
unselect
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
index | number | Index of the point to select. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
indexes | Array.<number> | An array of indexes of the point to select. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
width
Returns:
number | string | undefined - Current element's width setting.Params:
Name | Type | Default | Description |
---|---|---|---|
value | number | string | null | null | Width setting for the element. |
Returns:
anychart.core.cartesian.series.Base - Returns self for method chaining.Try it:
xPointPosition
Returns:
number - X-point position.Try it:
Points get a place on ordinal scale, the size of the place can be set manually.
If there are more than one seties, place size is calculated to fit all.
Params:
Name | Type | Default | Description |
---|---|---|---|
position | number | 0.5 | Point position (in 0 to 1 range). |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
xScale
Params:
Name | Type | Default | Description |
---|---|---|---|
value | anychart.scales.Base | "ordinal" | Value to set. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
yScale
Params:
Name | Type | Default | Description |
---|---|---|---|
value | anychart.scales.Base | "linear" | Value to set. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it:
zIndex
Returns:
number - The current zIndex.Try it:
Params:
Name | Type | Default | Description |
---|---|---|---|
value | number | 0 | Value to set. |
Returns:
anychart.core.cartesian.series.Base - Self instance for method chaining.Try it: