Documentation

Annotator


Warning: Undefined variable $html in /home/u695651349/domains/amcharts.com/public_html/docs/wp-content/themes/amdocs/inc/shortcodes.php on line 1016

Type class

A plugin that can be used to annotate charts.

Click here for more info

Sources

Annotator can be used (imported) via one of the following packages.

// Import Annotator
import * as am5plugins_exporting from "@amcharts/amcharts5/plugins/exporting";

am5plugins_exporting.Annotator.new(root, {
  // ... config if applicable
});

<!-- Load Annotator -->
<script src="plugins/exporting.js">

<script>
// Create Annotator
am5plugins_exporting.Annotator.new(root, {
  // ... config if applicable
});
</script>

Inheritance

Annotator extends Entity.

Annotator is not extended by any other symbol.

Settings

Set these settings on a Annotator object using its set() and setAll() methods.

Read about settings concept.

id
#

Type undefined | string

Inherited from IEntitySettings

A custom string ID for the element.

If set, element can be looked up via root.entitiesById.

Will raise error if an element with the same ID already exists.
ignoreThemes
#

Type undefined | false | true

Default false

Inherited from IEntitySettings

If set to true the themes will be ignored when applying settings.

@since 5.15.6

layer
#

Type undefined | number

Default 1000

Layer number to use for annotations.
markerSettings
#

Type undefined | object

MarkerArea settings in form of an object where keys are setting names and value is a setting value. E.g.:

let annotator = am5plugins_exporting.Annotator.new(root, {
 markerSettings: {
   defaultColorSet: ["red", "green", "blue"],
   wrapText: true
 }
});

var annotator = am5plugins_exporting.Annotator.new(root, {
 markerSettings: {
   defaultColorSet: ["red", "green", "blue"],
   wrapText: true
 }
});

Click here for a full list of settings
@since 5.7.4

markerState
#

Type any

Raw annotation info saved by MarkerJS.
markerStyleSettings
#

Type undefined | object

MarkerArea style settings for user interface elements. E.g.:

let annotator = am5plugins_exporting.Annotator.new(root, {
 markerStyleSettings: {
   toolboxColor: "#F472B6",
   toolboxAccentColor: "#BE185D"
 }
});

var annotator = am5plugins_exporting.Annotator.new(root, {
 markerStyleSettings: {
   toolboxColor: "#F472B6",
   toolboxAccentColor: "#BE185D"
 }
});

Click here for a full list of settings
@since 5.7.5

stateAnimationDuration
#

Type undefined | number

Default 0

Inherited from IEntitySettings

Duration of transition from one state to another.
stateAnimationEasing
#

Type $ease.Easing

Default out(cubic)

Inherited from IEntitySettings

Easing of transition from one state to another.
themeTags
#

Type Array

Inherited from IEntitySettings

Tags which can be used by the theme rules.

Click here for more info

themeTagsSelf
#

Type Array

Inherited from IEntitySettings

Tags which can be used by the theme rules.

These tags only apply to this object, not any children.

Click here for more info

themes
#

Type Array

Inherited from IEntitySettings

A list of themes applied to the element.
userData
#

Type any

Inherited from IEntitySettings

A storage for any custom user data that needs to be associated with the element.
There are 8 inherited items currently hidden from this list.

Private settings

Properties

adapters
#

Type Adapters

Default new Adapters(this)

Inherited from Entity
className
#

Static

Type string

Default "Annotator"
classNames
#

Static

Type Array

Default "Annotator", "Entity"
enableDispose
#

Type boolean

Default true

Inherited from Settings

If this is set to false then disposing does nothing, it's a no-op.
events
#

Type EventDispatcher

Default this._createEvents()

Inherited from Entity
root
#

Type Root

Inherited from Entity

An instance of Root object.

@readonly
@since 5.0.6

states
#

Type States

Default new States(this)

Inherited from Entity
template
#

Type Template | undefined

Inherited from Entity

@todo needs description

uid
#

Type number

Default ++counter

Inherited from Settings

Unique ID.
There are 7 inherited items currently hidden from this list.

Methods

animate(

options: AnimationOptions

)

#

Returns Animation

Inherited from Settings

Animates setting values from current/start values to new ones.

Click here for more info

cancel()

#

Returns Promise

Exits from annotation mode. Any changes made during last session of the annotation editing are cancelled.

clear()

#

Returns void

All annotations are removed.

close()

#

Returns Promise

Exists from annotation mode. All annotations remain visible on the chart.

dispose()

#

Returns void

Inherited from Settings

Disposes this object.

get(

key: Key,
fallback: F

)

#

Returns NonNullable | F

Inherited from Entity

Returns settings value for the specified key.

If there is no value, fallback is returned instead (if set).

Click here for more info

getMarkerArea()

#

Returns Promise

An instance of MarkerJS's MarkerArea.

Click here for more info

has(

key: Key

)

#

Returns boolean

Inherited from Settings

Returns true if the setting exists.

Click here for more info

isDisposed()

#

Returns boolean

Inherited from Settings

Returns true if this element is disposed.

isType(

type: string

)

#

Returns this

Inherited from Entity

Checks if element is of certain class (or inherits one).

new(

root: Root,
settings: ITSettings,
template?: Template

)

#

Static

Returns T

Inherited from Entity

Use this method to create an instance of this class.

Click here for more info

off(

key: Key,
callback?: undefined | ( value: [""], target: this, key: Key) => void

)

#

Returns void

Inherited from Settings

Removes a callback for when value of a setting changes.

Click here for more info
@since 5.9.2

offDebounced(

key: Key,
callback?: undefined | ( value: [""], target: this, key: Key) => void

)

#

Returns void

Inherited from Settings

Removes a debounced callback for when value of a setting changes.

Click here for more info

offDebouncedPrivate(

key: Key,
callback?: undefined | ( value: [""], target: this, key: Key) => void

)

#

Returns void

Inherited from Settings

Removes a debounced callback for when value of a private setting changes.

Click here for more info

offPrivate(

key: Key,
callback?: undefined | ( value: [""], target: this, key: Key) => void

)

#

Returns void

Inherited from Settings

Removes a callback for when value of a private setting changes.

Click here for more info
@since 5.9.2

on(

key: Key,
callback: ( value: [""], target: this, key: Key) => void

)

#

Returns IDisposer

Inherited from Settings

Sets a callback function to invoke when specific key of settings changes or is set.

Click here for more info

onDebounced(

key: Key,
callback: ( value: [""], target: this, key: Key) => void,
debounceDelay: number

)

#

Returns IDisposer

Inherited from Settings

Sets a debounced callback function to invoke when specific key of settings changes or is set. The callback fires only once even if the setting is changed multiple times within the debounce delay.

Click here for more info

onPrivate(

key: Key,
callback: ( value: [""], target: this, key: Key) => void

)

#

Returns IDisposer

Inherited from Settings

Sets a callback function to invoke when specific key of private settings changes or is set.

Click here for more info

onPrivateDebounced(

key: Key,
callback: ( value: [""], target: this, key: Key) => void,
debounceDelay: number

)

#

Returns IDisposer

Inherited from Settings

Sets a debounced callback function to invoke when specific key of private settings changes or is set. The callback fires only once even if the setting is changed multiple times within the debounce delay.

Click here for more info

open()

#

Returns Promise

Triggers annotation mode on the chart. This will display UI toolbars and disable all interactions on the chart itself.

remove(

key: Key

)

#

Returns void

Inherited from Entity

Removes a setting value for the specified key.

Click here for more info

removeAll()

#

Returns void

Inherited from Settings

Removes all keys;

Click here for more info

set(

key: Key,
value: Value

)

#

Returns Value

Inherited from Entity

Sets a setting value for the specified key, and returns the same value.

Click here for more info

setAll(

settings: Partial

)

#

Returns void

Inherited from Settings

Sets multiple settings at once.

settings must be an object with key: value pairs.

Click here for more info

setTimeout(

fn: () => void,
delay: number

)

#

Returns IDisposer

Inherited from Entity

Creates and returns a "disposable" timeout.

toggle()

#

Returns Promise
There are 20 inherited items currently hidden from this list.

Events

Annotator does not have any events.