Bullet

Type class

A universal placeholder for bullet elements.

Click here for more info

Sources

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

// Import Bullet
import * as am5 from "@amcharts/amcharts5";

// Create Bullet
am5.Bullet.new(root, {
  // ... config if applicable
});
<!-- Load Bullet -->
<script src="index.js"></script>

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

Inheritance

Bullet extends Entity.

Bullet is not extended by any other symbol.

Settings

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

Read about settings concept.

autoRotate
#

Type undefined | false | true

Default false

If set to true, the bullet will be automatically rotated to face direction of line it is attached to.

NOTE: Works only in Flow and MapPointSeries (when MapPoint is attached to a MapLine).

autoRotateAngle
#

Type undefined | number

If autoRotate is set to true, value of autoRotateAngle will be added to the automatically-calculated angle.

dynamic
#

Type undefined | false | true

Default false

If set to true, the bullet will redraw its sprite element whenever anything in its parent series changes.

field
#

Type "open" | "high" | "low" | "value"

If a field will be set, the bullet will be located at exact value of that field, not paying atention to locationY/locationX. Works with XYSeries only.

If field is set, bullet will be placed at the specific data value, ignoring any locationX and locationY settings.

  • IMPORTANT: this setting works with XYSeries only.

Click here for more info
@since 5.6.0

id
#

Type undefined | string

Inherited from IEntitySettings

A custom string ID for the element.

If set, element can be looked up via am5.registry.entitiesById.

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

locationX
#

Type undefined | number

Horizontal location within target element.

0 - left, 1 - right, or anything inbetweeen.

locationY
#

Type undefined | number

Vertical location within target element.

0 - top, 1 - bottom, or anything inbetweeen.

sprite
#

Type Sprite

A visual element of the bullet.

stacked
#

Type "up" | "down" | "auto"

If set, will stack bullets instead of overlapping them.

  • "up - stacks bullets upwards.
  • "down - stacks bullets downwards.
  • "auto - stacks bullets in the direction that offers more space.
  • IMPORTANT: this setting works with XYSeries only.

Click here for more info
@since 5.6.0

stateAnimationDuration
#

Type undefined | number

Inherited from IEntitySettings

Duration of transition from one state to another.

stateAnimationEasing
#

Type $ease.Easing

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 7 inherited items currently hidden from this list.

Private settings

These are read-only settings accessible from a Bullet object using its getPrivate() method.

Read about private settings.

hidden
#

Read only

Type undefined | false | true

Properties

adapters
#

Type Adapters

Default new Adapters(this)

Inherited from Entity

className
#

Static

Type string

Default "Bullet"

classNames
#

Static

Type Array

Default "Bullet", "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

series
#

Type Series | undefined

Target series object if it's a bullet for series.

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

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

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

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

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

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.

There are 16 inherited items currently hidden from this list.

Events

Bullet does not have any events.