class anychart.core.waterfall.series.Waterfall Improve this Doc
Extends: anychart.core.cartesian.series.WidthBased
Waterfall Series Class.
Methods Overview
Specific settings | |
a11y() | Accessibility settings. |
clip() | Series clip settings. |
getIndex() | Returns series index. |
getPixelPointWidth() | Gets point width in case of width-based series. |
getType() | Returns series type. |
id() | Series id. |
legendItem() | Legend item settings. |
maxPointWidth() | Maximum point width settings. |
minPointLength() | Minimum point length settings. |
pointWidth() | Point width settings. |
selectionMode() | Selection mode. |
transformX() | Transforms X value to pixel coordinates. |
transformY() | Transforms Y value to pixel coordinates. |
xPointPosition() | Position of the point. |
Coloring | |
color() | Color settings. |
colorScale() | Color scale settings. |
fallingFill() | Falling fill settings. |
fill() | Fill settings. |
risingFill() | Rising fill settings. |
Data | |
data() | Data settings. |
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. |
meta() | Series meta data settings. |
name() | Series name settings. |
Interactivity | |
enabled() | Element state (enabled or disabled). |
hover() | Hover settings. |
hovered() | Hovered state settings. |
normal() | Normal state settings. |
select() | Select settings. |
selected() | Selected state settings. |
tooltip() | Tooltip settings. |
unhover() | Removes hover from the series. |
unselect() | Deselects all selected points. |
Point Elements | |
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
Returns:
anychart.core.utils.SeriesA11y - Accessibility settings object.var series = chart.line([3, 5, 2, 14, 3]); var a11y = series.a11y();
Sets accessibility setting depending on parameter type:
- boolean - disable or enable accessibility.
- object - sets accessibility setting.
Params:
Name | Type | Description |
---|---|---|
value | boolean | Object | Whether to enable accessibility. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.bottom
Returns:
number | string | undefined - Element's bottom bound setting.Params:
Name | Type | Default | Description |
---|---|---|---|
bottom | number | string | null | null | Bottom bound settings for the element. |
Returns:
anychart.core.waterfall.series.Waterfall - Returns self for method chaining.Try it:
bounds
Returns:
anychart.core.utils.Bounds - Bounds of the element.Params:
Name | Type | Description |
---|---|---|
bounds | anychart.utils.RectObj | anychart.math.Rect | anychart.core.utils.Bounds | Bounds of element. |
Returns:
anychart.core.waterfall.series.Waterfall - 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.waterfall.series.Waterfall - 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.waterfall.series.Waterfall - Self instance for method chaining.Try it:
color
Learn more about coloring.
Params:
Name | Type | Description |
---|---|---|
color | string | Color as a string. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
colorScale
var series = chart.line(); var colorScale = series.colorScale();
Params:
Name | Type | Description |
---|---|---|
settings | anychart.scales.LinearColor | anychart.scales.OrdinalColor | Object | anychart.enums.ScaleTypes | string | Scale to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
data
Params:
Name | Type | Description |
---|---|---|
data | anychart.data.View | anychart.data.Set | Array | string | Data to set. |
csvSettings | anychart.enums.TextParsingMode | string | anychart.data.TextParsingSettings | If CSV string is passed by first param, you can pass CSV parser settings here as a hash map. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.enabled
Returns:
boolean - Element state.Try it:
Params:
Name | Type | Default | Description |
---|---|---|---|
enabled | boolean | true | Enabled state to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.if (!element.enabled()) element.enabled(true);
Try it:
excludePoint
Params:
Name | Type | Description |
---|---|---|
indexes | number | Array.<number> | Points indexes. |
Returns:
boolean - Returns true if the points were excluded.Try it:
fallingFill
Returns:
anychart.graphics.vector.Fill - Falling fill color.var fallingFill = series.fallingFill();
Params:
Name | Type | Default | Description |
---|---|---|---|
color | anychart.graphics.vector.Fill | Array.<(anychart.graphics.vector.GradientKey|string)> | null | Color as an object, an array or a string. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Params:
Name | Type | Default | Description |
---|---|---|---|
fillFunction | function():anychart.graphics.vector.Fill | function() { return anychart.color.darken(this.sourceColor); } | Function that looks like: function(){ // this.index - series index. // this.sourceColor - color returned by fill() getter. // this.iterator - series point iterator. return fillValue; // type anychart.graphics.vector.Fill } |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
color | string | Color as a string. |
opacity | number | Color opacity. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
keys | Array.<(anychart.graphics.vector.GradientKey|string)> | Gradient keys. |
angle | number | Gradient angle. |
mode | boolean | anychart.graphics.vector.Rect | Object | Gradient mode. |
opacity | number | Gradient opacity. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
keys | Array.<(anychart.graphics.vector.GradientKey|string)> | Color-stop gradient keys. |
cx | number | X ratio of center radial gradient. |
cy | number | Y ratio of center radial gradient. |
mode | anychart.graphics.math.Rect | If defined then userSpaceOnUse mode, else objectBoundingBox. |
opacity | number | Opacity of the gradient. |
fx | number | X ratio of focal point. |
fy | number | Y ratio of focal point. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
imageSettings | anychart.graphics.vector.Fill | Object with settings. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
fill
Returns:
anychart.graphics.vector.Fill - The fill color.Params:
Name | Type | Description |
---|---|---|
color | anychart.graphics.vector.Fill | Array.<(anychart.graphics.vector.GradientKey|string)> | Color as an object, an array or a string. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Params:
Name | Type | Default | Description |
---|---|---|---|
fillFunction | function():anychart.graphics.vector.Fill | function() { return anychart.color.darken(this.sourceColor); } | Function that looks like: function(){ // this.index - series index. // this.sourceColor - color returned by fill() getter. // this.iterator - series point iterator. return fillValue; // type anychart.graphics.vector.Fill } |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
color | string | Color as a string. |
opacity | number | Color opacity. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
keys | Array.<(anychart.graphics.vector.GradientKey|string)> | Gradient keys. |
angle | number | Gradient angle. |
mode | boolean | anychart.graphics.vector.Rect | Object | Gradient mode. |
opacity | number | Gradient opacity. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
keys | Array.<(anychart.graphics.vector.GradientKey|string)> | Color-stop gradient keys. |
cx | number | X ratio of center radial gradient. |
cy | number | Y ratio of center radial gradient. |
mode | anychart.graphics.math.Rect | If defined then userSpaceOnUse mode, else objectBoundingBox. |
opacity | number | Opacity of the gradient. |
fx | number | X ratio of focal point. |
fy | number | Y ratio of focal point. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
imageSettings | anychart.graphics.vector.Fill | Object with settings. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
getExcludedPoints
Returns:
Array.<anychart.core.Point> - Array of the points.Try it:
getIndex
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:
getStat
Params:
Name | Type | Description |
---|---|---|
key | anychart.enums.Statistics | string | Key. |
Returns:
* - Statistics value.Try it:
getType
height
Returns:
number | string | undefined - Element's height setting.Params:
Name | Type | Default | Description |
---|---|---|---|
height | number | string | null | null | Height settings for the element. |
Returns:
anychart.core.waterfall.series.Waterfall - Returns self for method chaining.Try it:
hover
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
index | number | Point index. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
indexes | Array.<number> | Array of indexes. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
hovered
Returns:
anychart.core.StateSettings - Hovered state settingsTry it:
Params:
Name | Type | Description |
---|---|---|
settings | Object | State settings to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
id
Params:
Name | Type | Description |
---|---|---|
id | string | number | Id of the series. Default id is equal to internal index. |
Returns:
anychart.core.waterfall.series.Waterfall - 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 |
---|---|---|
enabled | boolean | null | Whether to change the series layout direction to vertical. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
keepOnlyPoints
Params:
Name | Type | Description |
---|---|---|
indexes | number | Array.<number> | Point index or indexes. |
Try it:
labels
- null/boolean - disable or enable chart labels.
- object - sets chart labels settings.
Params:
Name | Type | Default | Description |
---|---|---|---|
settings | Object | boolean | null | false | Series data labels settings. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.left
Returns:
number | string | undefined - Element's left bound setting.Params:
Name | Type | Default | Description |
---|---|---|---|
left | number | string | null | null | Left bound setting for the element. |
Returns:
anychart.core.waterfall.series.Waterfall - Returns self for method chaining.Try it:
legendItem
Returns:
anychart.core.utils.LegendItemSettings - Legend item settings.Try it:
Params:
Name | Type | Description |
---|---|---|
settings | Object | Legend item settings object. |
Returns:
anychart.core.waterfall.series.Waterfall - Legend item settings or self for chaining.Try it:
markers
- null/boolean - disable or enable series markers.
- object - sets series markers settings.
- string - sets series markers type.
Params:
Name | Type | Default | Description |
---|---|---|---|
settings | Object | boolean | null | string | false | Series data markers settings. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.maxHeight
Returns:
number | string | null - Element's maximum height.Params:
Name | Type | Default | Description |
---|---|---|---|
height | number | string | null | null | Maximum height to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
maxLabels
- null/boolean - disable or enable maximum labels.
- object - sets maximum labels settings.
Params:
Name | Type | Description |
---|---|---|
settings | Object | boolean | null | Maximum labels settings. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.maxPointWidth
Returns:
string | number - The maximum point width pixel value.var maxPointWidth = series.maxPointWidth();
Params:
Name | Type | Description |
---|---|---|
width | number | string | Point width pixel value. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
maxWidth
Returns:
number | string | null - Element's maximum width.Params:
Name | Type | Default | Description |
---|---|---|---|
width | number | string | null | null | Maximum width to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
meta
Params:
Name | Type | Description |
---|---|---|
key | * | Metadata key. |
Returns:
* - Metadata object, key value or itself for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
object | * | Object to replace metadata. |
value | * | Meta data value. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
key | * | Metadata key. |
value | * | Meta data value. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
minHeight
Returns:
number | string | null - Element's minimum height.Params:
Name | Type | Default | Description |
---|---|---|---|
height | number | string | null | null | Minimum height to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
minLabels
- null/boolean - disable or enable minimum labels.
- object - sets minimum labels settings.
Params:
Name | Type | Description |
---|---|---|
settings | Object | boolean | null | Minimum labels settings. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.minPointLength
Returns:
string | number - The minimum point length pixel value.var minPointLength = series.minPointLength();
Params:
Name | Type | Description |
---|---|---|
length | number | string | Minimum point length pixel value. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
minWidth
Returns:
number | string | null - Element's minimum width.Params:
Name | Type | Default | Description |
---|---|---|---|
width | number | string | null | null | Minimum width to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
name
Returns:
string | undefined - Series name value.Try it:
Params:
Name | Type | Description |
---|---|---|
name | string | Series name to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
normal
Returns:
anychart.core.StateSettings - Normal state settings.Try it:
Params:
Name | Type | Description |
---|---|---|
settings | Object | State settings to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
pointWidth
Returns:
string | number - The point width pixel value.var pointWidth = series.pointWidth();
Params:
Name | Type | Description |
---|---|---|
width | number | string | Point width pixel value. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
rendering
Returns:
anychart.core.series.RenderingSettings - Rendering settings.Try it:
Params:
Name | Type | Description |
---|---|---|
settings | Object | function | Rendering settings to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
right
Returns:
number | string | undefined - Element's right bound setting.Params:
Name | Type | Default | Description |
---|---|---|---|
right | number | string | null | null | Right bound setting for the element. |
Returns:
anychart.core.waterfall.series.Waterfall - Returns self for method chaining.Try it:
risingFill
Returns:
anychart.graphics.vector.Fill - Rising fill color.var risingFill = series.risingFill();
Params:
Name | Type | Description |
---|---|---|
color | anychart.graphics.vector.Fill | Array.<(anychart.graphics.vector.GradientKey|string)> | Color as an object, an array or a string. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Params:
Name | Type | Default | Description |
---|---|---|---|
fillFunction | function():anychart.graphics.vector.Fill | function() { return anychart.color.darken(this.sourceColor); } | Function that looks like: function(){ // this.index - series index. // this.sourceColor - color returned by fill() getter. // this.iterator - series point iterator. return fillValue; // type anychart.graphics.vector.Fill } |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
color | string | Color as a string. |
opacity | number | Color opacity. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
keys | Array.<(anychart.graphics.vector.GradientKey|string)> | Gradient keys. |
angle | number | Gradient angle. |
mode | boolean | anychart.graphics.vector.Rect | Object | Gradient mode. |
opacity | number | Gradient opacity. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
keys | Array.<(anychart.graphics.vector.GradientKey|string)> | Color-stop gradient keys. |
cx | number | X ratio of center radial gradient. |
cy | number | Y ratio of center radial gradient. |
mode | anychart.graphics.math.Rect | If defined then userSpaceOnUse mode, else objectBoundingBox. |
opacity | number | Opacity of the gradient. |
fx | number | X ratio of focal point. |
fy | number | Y ratio of focal point. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
imageSettings | anychart.graphics.vector.Fill | Object with settings. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
select
Params:
Name | Type | Description |
---|---|---|
index | number | Index of the point to select. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
indexes | number | Array.<number> | Array of indexes of the point to select. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
selected
Returns:
anychart.core.StateSettings - Selected state settingsTry it:
Params:
Name | Type | Description |
---|---|---|
settings | Object | State settings to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
selectionMode
Returns:
anychart.enums.SelectionMode | string | null - Selection mode.Try it:
Params:
Name | Type | Default | Description |
---|---|---|---|
value | anychart.enums.SelectionMode | string | null | 'multiSelect' | Selection mode. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
seriesType
Params:
Name | Type | Description |
---|---|---|
type | string | Series type to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
tooltip
- null/boolean - disable or enable chart tooltip.
- object - sets chart tooltip settings.
Params:
Name | Type | Description |
---|---|---|
settings | Object | boolean | null | Tooltip settings. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.top
Returns:
number | string | undefined - Element's top bound setting.Params:
Name | Type | Default | Description |
---|---|---|---|
top | number | string | null | null | Top bound setting for the element. |
Returns:
anychart.core.waterfall.series.Waterfall - 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.waterfall.series.Waterfall - Self instance for method chaining.Try it:
unselect
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
Params:
Name | Type | Description |
---|---|---|
index | number | Index of the point to select. |
Returns:
anychart.core.waterfall.series.Waterfall - 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.waterfall.series.Waterfall - Self instance for method chaining.Try it:
width
Returns:
number | string | undefined - Element's width setting.Params:
Name | Type | Default | Description |
---|---|---|---|
width | number | string | null | null | Width settings for the element. |
Returns:
anychart.core.waterfall.series.Waterfall - Returns self for method chaining.Try it:
xPointPosition
Returns:
number - X-point position.Try it:
On an ordinal scale, the position where point is can be set manually. If there are more than one series, positions is calculated to fit all.
Params:
Name | Type | Default | Description |
---|---|---|---|
position | number | 0.5 | Point position (in 0 to 1 range). |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
xScale
Params:
Name | Type | Default | Description |
---|---|---|---|
settings | anychart.scales.Base | Object | anychart.enums.ScaleTypes | string | anychart.scales.Ordinal | Scale settings to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
yScale
Params:
Name | Type | Default | Description |
---|---|---|---|
settings | anychart.scales.Base | Object | anychart.enums.ScaleTypes | string | anychart.scales.Linear | Scale settings to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it:
zIndex
Params:
Name | Type | Default | Description |
---|---|---|---|
zIndex | number | 0 | Value to set. |
Returns:
anychart.core.waterfall.series.Waterfall - Self instance for method chaining.Try it: