Chartbreaker
    Preparing search index...

    Class Sparkline

    *Example of an options definition with the most common attributes:

    this.prototype.options = {
       'chartType': {
           type: 'number',
           [name: 'Name'],
           [_set: function],
           [value: 'line'],                    // options without value get forwarded to the _get callback
           [_get: function],                   // either _get or value must be specified
           [flags: BG.charts.Object.EOptionFlags.EXPOSED]   // various flags; e.g. exposed => hint for ui; this option can be shown
       },
    };

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    interval optionGroups options render setBounds

    Methods

    addListener attr destroy didUpdateOptions emit flat get getCanvas getGroups getProfiler getState listeners on once onDestroy onRecover onStart onStop recover redraw removeAllListeners removeListener set setMaxListeners setThreshold setTypeAndName suspendPush toString update updateSource validate willUpdateOptions zoom guard listenerCount setDefaultMaxListeners

    Constructors

    Properties

    interval: ESpans
    optionGroups: OptionGroup[]
    options: { [key: string]: any }
    render: (push?: number) => number | void
    setBounds: (min: number, max: number) => void

    Methods

    • Type Parameters

      • Type extends (keyof Events) | "loaded"
      • Callback extends
            | (
                (
                    optionName: string,
                    attributeName: string,
                    oldValue: any,
                    newValue: any,
                ) => void
            )
            | ((optionName: string, oldValue?: any, newValue?: any) => void)
            | (
                (
                    state: BG.charts.Object.State,
                    flags: BG.charts.Object.State.EFlags,
                ) => void
            )
            | (() => void)
            | (() => void)

      Parameters

      Returns this

      adds a listener to the end of the listeners array for the specified event.

    • returns or sets the attribute of an option this function should be used with care - modifications of internal properties might break stuff!

      Parameters

      Returns any

    • destroy the sparkline

      Returns void

    • 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.

      Parameters

      Returns void

    • Type Parameters

      • Type extends (keyof Events) | "loaded"
      • Callback extends
            | (
                (
                    optionName: string,
                    attributeName: string,
                    oldValue: any,
                    newValue: any,
                ) => void
            )
            | ((optionName: string, oldValue?: any, newValue?: any) => void)
            | (
                (
                    state: BG.charts.Object.State,
                    flags: BG.charts.Object.State.EFlags,
                ) => void
            )
            | (() => void)
            | (() => void)

      Parameters

      Returns boolean

      execute each of the listeners in order with the supplied parameters.

    • 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

      Parameters

      • OptionalreadWriteOnly: boolean

        default: true

      • OptionalmodifiedOnly: boolean

        default: true

      • OptionalnonEphemeralOnly: boolean

        default: true

      Returns { [key: string]: any }

    • returns the value of the requested option, or a list of all available config options if no parameter is specified.

      Parameters

      • Optionals: string
      • Optionalflags: number

      Returns any

    • returns the sparklines underlying canvas element

      Returns null | HTMLCanvasElement

    • returns the categorization of the objects options can be used for displaying a more structured user interface

      Returns OptionGroup[]

    • Returns a BG.charts.Profiler instance if run in a node environment

      Returns undefined | Profiler

    • Type Parameters

      • Type extends (keyof Events) | "loaded"
      • Callback extends
            | (
                (
                    optionName: string,
                    attributeName: string,
                    oldValue: any,
                    newValue: any,
                ) => void
            )
            | ((optionName: string, oldValue?: any, newValue?: any) => void)
            | (
                (
                    state: BG.charts.Object.State,
                    flags: BG.charts.Object.State.EFlags,
                ) => void
            )
            | (() => void)
            | (() => void)

      Parameters

      Returns Callback[]

      returns an array of listeners for the specified event.

    • Type Parameters

      • Type extends (keyof Events) | "loaded"
      • Callback extends
            | (
                (
                    optionName: string,
                    attributeName: string,
                    oldValue: any,
                    newValue: any,
                ) => void
            )
            | ((optionName: string, oldValue?: any, newValue?: any) => void)
            | (
                (
                    state: BG.charts.Object.State,
                    flags: BG.charts.Object.State.EFlags,
                ) => void
            )
            | (() => void)
            | (() => void)

      Parameters

      Returns this

      alias for addListener

    • Type Parameters

      • Type extends (keyof Events) | "loaded"
      • Callback extends
            | (
                (
                    optionName: string,
                    attributeName: string,
                    oldValue: any,
                    newValue: any,
                ) => void
            )
            | ((optionName: string, oldValue?: any, newValue?: any) => void)
            | (
                (
                    state: BG.charts.Object.State,
                    flags: BG.charts.Object.State.EFlags,
                ) => void
            )
            | (() => void)
            | (() => void)

      Parameters

      Returns this

      adds a one time listener for the event. This listener is invoked only the next time the event is fired, after which it is removed.

    • destroy the sparkline

      Returns void

    • life cycle method; called when the object should recover from an error and resume normal operation

      this will only be called if the object encountered a RecoverableError, and is always triggered by a manual user interaction

      always called between start and stop

      Returns void

    • life cycle method; called when the object should start normal operation at this point is is already completely initialized

      Parameters

      Returns void

    • 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

      Returns void

    • can be called to tell the object that it should recover from an error and resume will have no effect if no retryable error is currently associated with the object

      Returns boolean

    • update data

      Parameters

      • Optionalpush: number

      Returns void

    • Type Parameters

      • Type extends (keyof Events) | "loaded"

      Parameters

      Returns this

      removes all listeners, or those of the specified event.

    • Type Parameters

      • Type extends (keyof Events) | "loaded"
      • Callback extends
            | (
                (
                    optionName: string,
                    attributeName: string,
                    oldValue: any,
                    newValue: any,
                ) => void
            )
            | ((optionName: string, oldValue?: any, newValue?: any) => void)
            | (
                (
                    state: BG.charts.Object.State,
                    flags: BG.charts.Object.State.EFlags,
                ) => void
            )
            | (() => void)
            | (() => void)

      Parameters

      Returns this

      remove a listener from the listener array for the specified event.

    • 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

      Parameters

      Returns boolean

    • Parameters

      • maxListeners: number

      Returns this

      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.

    • set threshold for deciding between positive and negative regions can bei either a number, or a function if a function is provided, it is called with an array containing all values, and the start and end index of the currently visible region of the array

      Parameters

      • threshold: number | ((arg0: Float64Array, arg1: number, arg2: number) => number)

      Returns void

    • Sets the objName and objType of the Object reverts to the default ones if no arguments are given

      Parameters

      • OptionalobjType: string
      • OptionalobjName: string

      Returns void

    • suspend push updates

      Parameters

      • mode: boolean

      Returns boolean

    • Returns a string representation of an object.

      Returns string

    • update the chart

      Parameters

      • mode: boolean

      Returns boolean

    • update data

      Parameters

      • Optionalinstant: boolean

      Returns boolean

    • will set validate value(s) for the specified option(s)

      NOTE: if multiple options are used, will return false if at least one value is not valid

      Parameters

      Returns boolean

    • 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.

      Parameters

      • Optionaloptions: string | string[]

      Returns void

    • Parameters

      • Optionals: string | number

      Returns void

    • Parameters

      • cb: Function

      Returns void

      set custom error handler for event listeners

    • Parameters

      • maxListeners: number

      Returns void

      set default amount for limit warning

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods