class anychart.core.ui.ChartScroller Improve this Doc
Extends: anychart.core.ui.Scroller
Chart scroller class that also exposes position method that is used by chart.
Methods Overview
| Specific settings | |
| allowRangeChange() | Mode of the range changing. |
| thumbs() | Thumbs settings. |
| Coloring | |
| fill() | Fill settings. |
| outlineStroke() | Stroke settings. |
| selectedFill() | Select fill settings. |
| Interactivity | |
| autoHide() | Auto hide setting. |
| enabled() | Element state (enabled or disabled). |
| Size and Position | |
| height() | Scroller height. |
| inverted() | Inverted settings. |
| maxHeight() | Scroller maximum height. |
| minHeight() | Scroller minimum height. |
| orientation() | Scroller orientation. |
| position() | Scroller position. |
| zIndex() | Z-index of the element. |
Methods Description
allowRangeChange
Getter for the mode of the range changing.
Returns:
boolean - Mode of the range changing. See listing
var scroller = chart.xScroller(); var allowRangeChange = scroller.allowRangeChange();
Setter for the mode of the range changing. If the range changing is allowed.
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | Enabled state to set. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
autoHide
Getter for scroller auto hide mode.
Returns:
boolean - Auto hide mode. See listing
var scroller = chart.xScroller(); var state = scroller.autoHide();
Setter for scroller auto hide mode.
Detailed description
If the scroller should be automatically hidden if it cannot be
changed (allowRangeChange(false)) and shows the full range (startRatio(0), endRatio(1)).
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | false | Enabled state to set. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
enabled
Getter for the element state (enabled or disabled).
Returns:
boolean - Element state.Try it:
Setter for the element enabled state.
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | true | Enabled state to set. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining. Example.
if (!element.enabled()) element.enabled(true);
Try it:
fill
Getter for the scroller fill.
Detailed description
This method can be used as getter only if the value has been previously set.
Returns:
anychart.graphics.vector.Fill - Fill color.Try it:
Setter for scroller fill settings using an array, an object or a string.
Learn more about coloring.
Detailed description
Used to fill the background of selected part of the scroller.
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| color | anychart.graphics.vector.Fill | Array.<(anychart.graphics.vector.GradientKey|string)> | '#fff' | Color as an array, an object or a string. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Scroller fill color with opacity.
Detailed description
Used to fill the background of selected part of the scroller.
Note: If color is set as a string (e.g. 'red .5') it has a priority over opt_opacity, which
means: color set like this rect.fill('red 0.3', 0.7) will have 0.3 opacity.
Params:
| Name | Type | Description |
|---|---|---|
| color | string | Color as a string. |
| opacity | number | Color opacity. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
Linear gradient fill.
Learn more about coloring.
Detailed description
Used to fill the background of selected part of the scroller.
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.ui.ChartScroller - Self instance for method chaining.Try it:
Radial gradient fill.
Learn more about coloring.
Detailed description
Used to fill the background of selected part of the scroller.
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.ui.ChartScroller - Self instance for method chaining.Try it:
Image fill.
Learn more about coloring.
Detailed description
Used to fill the background of selected part of the scroller.
Params:
| Name | Type | Description |
|---|---|---|
| imageSettings | anychart.graphics.vector.Fill | Object with settings. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
height
Setter for the scroller height.
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| height | number | string | 40 | Scroller height to set. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
inverted
Setter for the scroller inversion.
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| enabled | boolean | false | Whether scroller should be inverted or not. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
maxHeight
Getter for the scroller maximum height.
Returns:
number | string | null - Scroller maximum height.Try it:
Setter for the scroller maximum height.
Params:
| Name | Type | Description |
|---|---|---|
| height | number | string | null | Maximum height |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
minHeight
Setter for the scroller minimum height.
Returns:
number | string | null - Scroller minimum height.Try it:
Setter for the scroller minimum height.
Params:
| Name | Type | Description |
|---|---|---|
| height | number | string | null | Minimum height. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
orientation
Getter for the scroller orientation.
Returns:
anychart.enums.Orientation | string - Scroller orientation.Try it:
Setter for the scroller orientation.
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| orientation | anychart.enums.Orientation | string | 'bottom' | Scroller orientation. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
outlineStroke
Getter for outline stroke settings.
Returns:
anychart.graphics.vector.Stroke - Stroke settings.Try it:
Setter for outline stroke settings.
Learn more about stroke settings.
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| color | anychart.graphics.vector.Stroke | anychart.graphics.vector.ColoredFill | string | null | '#cecece' | Stroke settings. |
| thickness | number | Line thickness. | |
| dashpattern | string | Controls the pattern of dashes and gaps used to stroke paths. | |
| lineJoin | string | anychart.graphics.vector.StrokeLineJoin | Line join style. | |
| lineCap | string | anychart.graphics.vector.StrokeLineCap | Line cap style. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
Setter for outline stroke using an object.
Params:
| Name | Type | Description |
|---|---|---|
| settings | Object | Stroke settings from anychart.graphics.vector.Stroke. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
position
Getter for the scroller position.
Returns:
anychart.enums.ChartScrollerPosition | string - Scroller position.Try it:
Setter for the scroller position.
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| position | anychart.enums.ChartScrollerPosition | string | 'afterAxis' | Position to set. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
selectedFill
Getter for scroller fill in selected mode.
Detailed description
This method can be used as getter only if the value has been previously set.
Returns:
anychart.graphics.vector.Fill - Select fill color.Try it:
Setter for scroller fill settings in selected mode using an array or a string.
Learn more about coloring.
Detailed description
Used to fill the background of selected part of the scroller.
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| color | anychart.graphics.vector.Fill | Array.<(anychart.graphics.vector.GradientKey|string)> | {color: "#1976d2", opacity: 0.2} | Color as an array, an object or a string. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Scroller fill color in selected mode with opacity.
Detailed description
Used to fill the background of selected part of the scroller.
Note: If color is set as a string (e.g. 'red .5') it has a priority over opt_opacity, which
means: color set like this rect.fill('red 0.3', 0.7) will have 0.3 opacity.
Params:
| Name | Type | Description |
|---|---|---|
| color | string | Color as a string. |
| opacity | number | Color opacity. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
Linear gradient fill in selected mode.
Learn more about coloring.
Detailed description
Used to fill the background of selected part of the scroller.
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.ui.ChartScroller - Self instance for method chaining.Try it:
Radial gradient fill in selected mode.
Learn more about coloring.
Detailed description
Used to fill the background of selected part of the scroller.
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.ui.ChartScroller - Self instance for method chaining.Try it:
Image fill in selected mode.
Learn more about coloring.
Detailed description
Used to fill the background of selected part of the scroller.
Params:
| Name | Type | Description |
|---|---|---|
| imageSettings | anychart.graphics.vector.Fill | Object with settings. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it:
thumbs
Setter for the thumbs settings.
Detailed description
Sets thumbs settings depending on parameter type:
- null/boolean - disable or enable thumbs.
- object - sets thumbs settings.
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| settings | boolean | Object | null | null | Thumbs settings. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.zIndex
Setter for the Z-index of the element.
Detailed description
The bigger the index - the higher the element position is.
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| zIndex | number | 0 | Value to set. |
Returns:
anychart.core.ui.ChartScroller - Self instance for method chaining.Try it: