class anychart.core.resource.TimeLine Improve this Doc
Extends: anychart.core.VisualBaseWithBounds
Resource Chart Timeline element.
Methods Overview
| Specific settings | |
| drawBottomLine() | Drawing of the bottom line. |
| drawLeftLine() | Drawing of the left line. |
| drawRightLine() | Drawing of the right line. |
| drawTopLine() | Drawing of the top line. |
| format() | Function to format content text. |
| holidays() | Padding settings |
| overlay() | Overlay element. |
| Advanced Text Settings | |
| maxFontSize() | Maximum font size settings. |
| minFontSize() | Minimum font size settings. |
| Coloring | |
| background() | Background settings. |
| fill() | Fill settings. |
| stroke() | Stroke settings. |
| Content Text Settings | |
| useHtml() | Use HTML option. |
| vAlign() | Text vertical align 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 | |
| enabled() | Element state (enabled or disabled). |
| 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. |
| padding() | Padding settings |
| right() | Right bound setting. |
| top() | Top bound setting. |
| width() | Width setting. |
| zIndex() | Z-index of the element. |
| Text Settings | |
| adjustFontSize() | Adjusting settings. |
| disablePointerEvents() | Pointer events settings. |
| fontColor() | Font color settings. |
| fontDecoration() | Font decoration setting. |
| fontFamily() | Font family settings. |
| fontOpacity() | Font opacity settings. |
| fontSize() | Font size settings. |
| fontStyle() | Font style settings. |
| fontVariant() | Font variant settings. |
| fontWeight() | Font weight settings. |
| hAlign() | Text horizontal align settings. |
| letterSpacing() | Text letter spacing settings. |
| lineHeight() | Text line height setting. |
| selectable() | Text selectable option. |
| textDirection() | Text direction settings. |
| textIndent() | Text indent settings. |
| textOverflow() | Text overflow settings. |
| textWrap() | Text wrap setting. |
| Miscellaneous | |
| levelHeight() | Getter for the level height. |
Methods Description
adjustFontSize
- [false, false] - do not adjust (adjust is off )
- [true, false] - adjust width
- [false, true] - adjust height
- [true, true] - adjust the first suitable value.
Returns:
number - An adjusted font size.var timeLine = chart.timeLine(); var adjustFontSize = timeLine.adjustFontSize();
Note: anychart.core.resource.TimeLine#fontSize does not work when adjusting is enabled.
Params:
| Name | Type | Description |
|---|---|---|
| adjustOrAdjustByWidth | boolean | Array.<boolean> | Object | Is font needs to be adjusted in case of 1 argument and adjusted by width in case of 2 arguments. |
| adjustByHeight | boolean | Is font needs to be adjusted by height. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
background
- null/boolean - disable or enable background.
- object - sets background settings.
- string - sets background color.
Params:
| Name | Type | Description |
|---|---|---|
| value | string | Object | null | boolean | Value to set |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.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.resource.TimeLine - 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.resource.TimeLine - 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.resource.TimeLine - Self instance for method chaining.Try it:
disablePointerEvents
Returns:
boolean - The pointer events settings.var timeLine = chart.timeLine(); var disablePointerEvents = timeLine.disablePointerEvents();
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| value | boolean | false | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.drawBottomLine
Returns:
boolean - Drawing flag.var currentGrid = chart.grid(); var flag = currentGrid.drawBottomLine();
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| value | boolean | false | Value to set. |
Returns:
anychart.core.resource.Grid - Self instance for method chaining.Try it:
drawLeftLine
Returns:
boolean - Drawing flag.var currentGrid = chart.grid(); var flag = currentGrid.drawLeftLine();
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| value | boolean | false | Value to set. |
Returns:
anychart.core.resource.Grid - Self instance for method chaining.Try it:
drawRightLine
Returns:
boolean - Drawing flag.var currentGrid = chart.grid(); var flag = currentGrid.drawRightLine();
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| value | boolean | false | Value to set. |
Returns:
anychart.core.resource.Grid - Self instance for method chaining.Try it:
drawTopLine
Returns:
boolean - Drawing flag.var currentGrid = chart.grid(); var flag = currentGrid.drawTopLine();
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| value | boolean | false | Value to set. |
Returns:
anychart.core.resource.Grid - 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.resource.TimeLine - Self instance for method chaining.if (!element.enabled()) element.enabled(true);
Try it:
fill
Returns:
anychart.graphics.vector.Fill - The fill color.var currentTimeLine = chart.timeLine(); var currentFill = currentTimeLine.fill();
Params:
| Name | Type | Description |
|---|---|---|
| value | anychart.graphics.vector.Fill | Color as an object or a string. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
Params:
| Name | Type | Description |
|---|---|---|
| color | string | Color as a string. |
| opacity | number | Color opacity. |
Returns:
anychart.core.resource.TimeLine - 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.resource.TimeLine - 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.resource.TimeLine - Self instance for method chaining.Try it:
Params:
| Name | Type | Description |
|---|---|---|
| imageSettings | anychart.graphics.vector.Fill | Object with settings. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
fontColor
Returns:
string - Font color settings.var timeLine = chart.timeLine(); var fontColor = timeLine.fontColor();
Params:
| Name | Type | Description |
|---|---|---|
| value | string | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
fontDecoration
Returns:
anychart.graphics.vector.Text.Decoration - Font decoration settings.var timeLine = chart.timeLine(); var fontDecoration = timeLine.fontDecoration();
Params:
| Name | Type | Description |
|---|---|---|
| value | anychart.graphics.vector.Text.Decoration | string | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
fontFamily
Returns:
string - Font family settings.var timeLine = chart.timeLine(); var fontFamily = timeLine.fontFamily();
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| value | string | "Helvetica Neue", Helvetica, sans-serif | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
fontOpacity
Returns:
number - Font opacity settings.var timeLine = chart.timeLine(); var fontOpacity = timeLine.fontOpacity();
Params:
| Name | Type | Description |
|---|---|---|
| value | number | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
fontSize
Returns:
number - Font size settings.var currentTooltipSettings = chart.tooltip(); var currentValue = currentTooltipSettings.fontSize();
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| value | number | string | 11 | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
fontStyle
Returns:
anychart.graphics.vector.Text.FontStyle - Font style settings.var timeLine = chart.timeLine(); var fontStyle = timeLine.fontStyle();
Params:
| Name | Type | Description |
|---|---|---|
| value | string | anychart.graphics.vector.Text.FontStyle | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
fontVariant
Returns:
anychart.graphics.vector.Text.FontVariant - Font variant settings.var timeLine = chart.timeLine(); var fontVariant = timeLine.fontVariant();
Params:
| Name | Type | Description |
|---|---|---|
| value | string | anychart.graphics.vector.Text.FontVariant | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
fontWeight
Returns:
string | number - Font weight settings.var timeLine = chart.timeLine(); var fontWeight = timeLine.fontWeight();
Params:
| Name | Type | Description |
|---|---|---|
| value | string | number | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
format
Returns:
function | string - Token or function to format text.var format = timeLine.format();
Learn more about using format() method.
Params:
| Name | Type | Description |
|---|---|---|
| value | function | string | Function or string token to format content text. |
Returns:
anychart.core.resource.TimeLineLevelHolidaysSettings - Self instance for method chaining.getPixelBounds
Returns:
anychart.math.Rect - Pixel bounds of the element.hAlign
Returns:
anychart.graphics.vector.Text.HAlign - Horizontal align settings.var timeLine = chart.timeLine(); var hAlign = timeLine.hAlign();
Params:
| Name | Type | Description |
|---|---|---|
| value | string | anychart.graphics.vector.Text.HAlign | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.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.resource.TimeLine - Returns self for method chaining.Try it:
holidays
Returns:
anychart.core.resource.TimeLineLevelHolidaysSettings - Holidays settings.Params:
| Name | Type | Description |
|---|---|---|
| value | Object | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.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.resource.TimeLine - Returns self for method chaining.Try it:
letterSpacing
Returns:
number - Letter spacing settings.var timeLine = chart.timeLine(); var letterSpacing = timeLine.letterSpacing();
Params:
| Name | Type | Description |
|---|---|---|
| value | number | string | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
levelHeight
Returns:
number - The level height.var currentTimeLine = chart.timeLine(); var currentHeight = currentTimeLine.levelHeight();
Params:
| Name | Type | Description |
|---|---|---|
| value | number | Level height. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
lineHeight
Returns:
number | string - Line height settings.var timeLine = chart.timeLine(); var lineHeight = timeLine.lineHeight();
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| value | number | string | "normal" | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance 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:
maxFontSize
Returns:
number - Maximum font size.var maxFontSize = timeLine.maxFontSize();
Params:
| Name | Type | Description |
|---|---|---|
| value | number | string | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.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.resource.TimeLine - 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.resource.TimeLine - Self instance for method chaining.Try it:
minFontSize
Returns:
number - Minimum font size.var minFontSize = timeLine.minFontSize();
Params:
| Name | Type | Description |
|---|---|---|
| value | number | string | Value to set. |
Returns:
anychart.core.resource.TimeLine - 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.resource.TimeLine - 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.resource.TimeLine - Self instance for method chaining.Try it:
overlay
Returns:
anychart.core.ui.Overlay - Overlay element.var element = timeLine.overlay();
Params:
| Name | Type | Description |
|---|---|---|
| value | Object | null | boolean | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
padding
Params:
| Name | Type | Description |
|---|---|---|
| value | null | Array.<(number|string)> | Object | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.// all paddings 15px
timeLine.padding(15);
// all paddings 15px
timeLine.padding('15px');
// top and bottom 5px ,right and left 15px
timeLine.padding(anychart.utils.padding(5,15));Try it:
Params:
| Name | Type | Description |
|---|---|---|
| value1 | string | number | Top or top-bottom space. |
| value2 | string | number | Right or right-left space. |
| value3 | string | number | Bottom space. |
| value4 | string | number | Left space. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.// 1) top and bottom 10px, left and right 15px timeLine.padding(10, '15px'); // 2) top 10px, left and right 15px, bottom 5px timeLine.padding(10, '15px', 5); // 3) top 10px, right 15px, bottom 5px, left 12px timeLine.padding(10, '15px', '5px', 12);
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:
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.resource.TimeLine - Returns self for method chaining.Try it:
selectable
Returns:
boolean - Text selectable value.var timeLine = chart.timeLine(); var selectable = timeLine.selectable();
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| value | boolean | false | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
stroke
Returns:
anychart.graphics.vector.Stroke - The stroke.var currentTimeLine = chart.timeLine(); var currentStroke = currentTimeLine.stroke();
Params:
| Name | Type | Default | Description |
|---|---|---|---|
| color | anychart.graphics.vector.Stroke | anychart.graphics.vector.ColoredFill | string | null | Stroke settings. | |
| thickness | number | 1 | Line thickness. |
| dashpattern | string | Controls the pattern of dashes and gaps used to stroke paths. | |
| lineJoin | anychart.graphics.vector.StrokeLineJoin | Line join style. | |
| lineCap | anychart.graphics.vector.StrokeLineCap | Line cap style. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
textDirection
Returns:
anychart.graphics.vector.Text.Direction - Text direction settings.var timeLine = chart.timeLine(); var textDirection = timeLine.textDirection();
Params:
| Name | Type | Description |
|---|---|---|
| value | string | anychart.graphics.vector.Text.Direction | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
textIndent
Returns:
number - Text indent settings.var timeLine = chart.timeLine(); var textIndent = timeLine.textIndent();
Params:
| Name | Type | Description |
|---|---|---|
| value | number | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
textOverflow
Returns:
anychart.graphics.vector.Text.TextOverflow - Text overflow settingsvar timeLine = chart.timeLine(); var textOverflow = timeLine.textOverflow();
Params:
| Name | Type | Description |
|---|---|---|
| value | anychart.graphics.vector.Text.TextOverflow | string | Value to set |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
textWrap
Returns:
anychart.graphics.vector.Text.TextWrap - Text wrap settings.var timeLine = chart.timeLine(); var textWrap = timeLine.textWrap();
Params:
| Name | Type | Description |
|---|---|---|
| value | string | anychart.graphics.vector.Text.TextWrap | Value to set. |
Returns:
anychart.core.resource.TimeLine - 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.resource.TimeLine - Returns self 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:
useHtml
Returns:
boolean - UseHTML flag.var timeLine = chart.timeLine(); var useHtml = timeLine.useHtml();
Params:
| Name | Type | Description |
|---|---|---|
| value | boolean | Value to set. |
Returns:
anychart.core.resource.TimeLine - Self instance for method chaining.Try it:
vAlign
Returns:
anychart.graphics.vector.Text.VAlign - Vertical align.var timeLine = chart.timeLine(); var vAlign = timeLine.vAlign();
Params:
| Name | Type | Description |
|---|---|---|
| value | string | anychart.graphics.vector.Text.VAlign | Value to set. |
Returns:
anychart.core.resource.TimeLine - 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.resource.TimeLine - Returns self 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.resource.TimeLine - Self instance for method chaining.Try it:
