This class implements two dimensional chart with one X-Axis, and one or more Y-Axes (represented by BG.charts.Scale). Charts are always contained inside a BG.charts.ChartSet where they share the same X-Axis.
The chart object is mainly responsible for event handling, and managing a set of tools (BG.charts.Tool), layers (BG.charts.Layers), and legend entries (BG.charts.LegendEntry).
Depending on the type of displayed layers, the X-Axis can be synced/locked to one or more Y-Axis, meaning that manipulating the scale of either will also affect the other. For example, this is used in Point and Figure charts, to ensure a constant aspect ratio.
must be called after willUpdateOptions
once all actions that might potentially changed values of any options are done
IMPORTANT: methods must be called in balance; e.g. for each call to willUpdateOptions
, you must call didUpdateOptions
exactly once.
draw a horizontal marker this method should only be called while the chart is redrawing (e.g. from a tools draw routine)
if the important parameter is set to true, marker is also drawn when xAxis is not visible
Optional
order: numberOptional
important: booleandraw a vertical marker with the specified property this method should only be called while the chart is redrawing (e.g. from a tools draw routine)
if the important parameter is set to true, marker is also drawn when xAxis is not visible
returns a flat representation of all available config options in the form of a key-value-object optionally only values that are not read-only can be returned
IMPORTANT: this method will always convert I18NStrings to strings, so for displaying strings in a UI use individual calls to BG.charts.Object:get instead
Optional
readWriteOnly: booleandefault: true
Optional
modifiedOnly: booleandefault: true
Optional
nonEphemeralOnly: booleandefault: true
returns the categorization of the objects options can be used for displaying a more structured user interface
returns the numeric offset for the specified index will only be non-zero if the timestamp at the specified index is not distinct
offset should be used in combination with the return value of getIdentifierByIndex
an index
numeric offset
returns the inset values for all plot area edges plugins or tools should not draw any interactive elements within these areas
return the style object
life cycle method; called when the object should stop normal operation if objects have any pending subscriptions/requests, they should all be stopped here
the object is also responsible for clearing the loading flag from it's state if it is currently active failing to do so will trigger a fatal error
object might be started again afterwards (start) or destroyed (destroy) this is not known yet at this point
called after start or restart
will set validate and then set the specified option(s) to the provided value(s) after validation
NOTE: if multiple options are used, will return false if at least one value is not valid values are applied individually however, so one option might be set even if the value for another is invalid
by default EventEmitters will print a warning if more than 10 listeners are added for a particular event. This is a useful default which helps finding memory leaks. Obviously not all Emitters should be limited to 10. This function allows that limit to be increased. Set to zero for unlimited.
when using custom getters/setters (via _get/_set) in options, the values of options can change
without .set being called - or there might not even be a setter for readonly options;
for example, if the getter simply returns the value of a member variable
this variable could be modified directly.
In this case, events such as optionChanged
would not be fired, and listeners would not be informed about the change.
To account for such cases, the methods willUpdateOptions
and didUpdateOptions
should be called directly BEFORE and AFTER
actions that might potentially change values of options.
the correct events will then automatically be triggered when calling didUpdateOptions
.
if the options that could change are known, they can be supplied via the optional parameter. This provides a small performance gain in most situations.
IMPORTANT: methods must be called in balance; e.g. for each call to willUpdateOptions
, you must call didUpdateOptions
exactly once.
Optional
options: string | string[]Static
guardStatic
listenerStatic
set
*Example of an options definition with the most common attributes: