ListData – amCharts 5 Documentation

Type class

A List that holds a component's data.

Sources

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

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

// Create ListData
am5.ListData.new(root, {
  // ... config if applicable
});

<!-- Load ListData -->
<script src="index.js"></script>

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

Inheritance

ListData extends List.

ListData is not extended by any other symbol.

Settings

ListData does not have any settings.

Private settings

ListData does not have any private settings.

Properties

events #	Type `EventDispatcher` Default `new EventDispatcher()` Inherited from `List`
length #	Type `number` Inherited from `List` Number of items in list. @readonly
processor #	Type `DataProcessor` A `DataProcessor` that processes each data item as it is added or replaced. Click here for more info
values #	Type `Array` Inherited from `List` An array of values in the list. Don't change this array directly: use methods like `push()` and `removeIndex()`, which dispatch the list's events. @readonly
There are 3 inherited items currently hidden from this list.

Methods

[Symbol.iterator]() #	Returns `Iterator` Inherited from `List` Returns an ES6 iterator for the list.
clear() #	Returns `void` Inherited from `List` Removes all items from the list.
constructor( initial: `Array` ) #	Returns `ListData` Inherited from `List` Constructor
contains( value: `T` ) #	Returns `boolean` Inherited from `List` Checks if list contains specific item reference.
copyFrom( source: `this` ) #	Returns `void` Inherited from `List` Adds all items of another list to the end of this one.
each( f: ( value: `T`, index: `number`) => `void` ) #	Returns `void` Inherited from `List` Calls `f` for each item in the list, with the item and its index.
eachReverse( f: ( value: `T`, index: `number`) => `void` ) #	Returns `void` Inherited from `List` Calls `f` for each item in the list, from last to first, with the item and its index.
getIndex( index: `number` ) #	Returns `T` \| `undefined` Inherited from `List` Returns an item at specified index.
hasIndex( index: `number` ) #	Returns `boolean` Inherited from `List` Checks if there's a value at specific index.
indexOf( value: `T` ) #	Returns `number` Inherited from `List` Searches the list for specific item and returns its index.
insertIndex( index: `number`, value: `K` ) #	Returns `K` Inherited from `List` Inserts an item at `index`, moving the items from there on one place further.
moveValue( value: `K`, toIndex?: `undefined` \| `number` ) #	Returns `K` Inherited from `List` Moves an item to `toIndex`, or to the end of the list if `toIndex` is not set. An item that is not in the list yet is added.
pop() #	Returns `Optional` Inherited from `List` Returns the last item from the list, and removes it.
push( value: `K` ) #	Returns `K` Inherited from `List` Adds an item to the end of the list.
pushAll( values: `Array` ) #	Returns `void` Inherited from `List` Adds multiple items to the end of the list.
removeIndex( index: `number` ) #	Returns `T` Inherited from `List` Removes a value at specific index.
removeValue( value: `T` ) #	Returns `void` Inherited from `List` Removes all copies of an item from the list.
setAll( newArray: `Array` ) #	Returns `void` Inherited from `List` Replaces all items in the list with `newArray`.
setIndex( index: `number`, value: `T` ) #	Returns `T` Inherited from `List` Replaces the value at `index`, which must already exist.
shift() #	Returns `Optional` Inherited from `List` Returns the first item from the list, and removes it.
swap( a: `number`, b: `number` ) #	Returns `void` Inherited from `List` Swaps two items in the list.
unshift( value: `K` ) #	Returns `K` Inherited from `List` Adds an item as a first item in the list.
There are 22 inherited items currently hidden from this list.

[Symbol.iterator]()

Returns Iterator

Inherited from List

Returns an ES6 iterator for the list.

clear()

Returns void

Inherited from List

Removes all items from the list.

constructor(

initial: Array

)

Returns ListData

Inherited from List

Constructor

contains(

value: T

)

Returns boolean

Inherited from List

Checks if list contains specific item reference.

copyFrom(

source: this

)

Returns void

Inherited from List

Adds all items of another list to the end of this one.

each(

f: ( value: T, index: number) => void

)

Returns void

Inherited from List

Calls f for each item in the list, with the item and its index.

eachReverse(

f: ( value: T, index: number) => void

)

Returns void

Inherited from List

Calls f for each item in the list, from last to first, with the item and its index.

getIndex(

index: number

)

Returns T | undefined

Inherited from List

Returns an item at specified index.

hasIndex(

index: number

)

Returns boolean

Inherited from List

Checks if there's a value at specific index.

indexOf(

value: T

)

Returns number

Inherited from List

Searches the list for specific item and returns its index.

insertIndex(

index: number,
value: K

)

Returns K

Inherited from List

Inserts an item at index, moving the items from there on one place further.

moveValue(

value: K,
toIndex?: undefined | number

)

Returns K

Inherited from List

Moves an item to toIndex, or to the end of the list if toIndex is not set. An item that is not in the list yet is added.

pop()

Returns Optional

Inherited from List

Returns the last item from the list, and removes it.

push(

value: K

)

Returns K

Inherited from List

Adds an item to the end of the list.

pushAll(

values: Array

)

Returns void

Inherited from List

Adds multiple items to the end of the list.

removeIndex(

index: number

)

Returns T

Inherited from List

Removes a value at specific index.

removeValue(

value: T

)

Returns void

Inherited from List

Removes all copies of an item from the list.

setAll(

newArray: Array

)

Returns void

Inherited from List

Replaces all items in the list with newArray.

setIndex(

index: number,
value: T

)

Returns T

Inherited from List

Replaces the value at index, which must already exist.

shift()

Returns Optional

Inherited from List

Returns the first item from the list, and removes it.

swap(

a: number,
b: number

)

Returns void

Inherited from List

Swaps two items in the list.

unshift(

value: K

)

Returns K

Inherited from List

Adds an item as a first item in the list.

There are 22 inherited items currently hidden from this list.

Events

Add event handlers to ListData object using its events.on() method.

Read about adding event handlers.

#clear	Param { oldValues: `Array`, type: `"clear"`, target: `this` } Inherited from `List` All items were removed, by `clear()` or `setAll()`.
#insertIndex	Param { index: `number`, newValue: `A`, type: `"insertIndex"`, target: `this` } Inherited from `List` An item was inserted at `index`.
#moveIndex	Param { newIndex: `number`, oldIndex: `number`, value: `A`, type: `"moveIndex"`, target: `this` } Inherited from `List` An item was moved from `oldIndex` to `newIndex`.
#push	Param { newValue: `A`, type: `"push"`, target: `this` } Inherited from `List` An item was added to the end of the list.
#removeIndex	Param { index: `number`, oldValue: `A`, type: `"removeIndex"`, target: `this` } Inherited from `List` The item at `index` was removed.
#setIndex	Param { index: `number`, newValue: `A`, oldValue: `A`, type: `"setIndex"`, target: `this` } Inherited from `List` The item at `index` was replaced.
#swap	Param { a: `A`, b: `A`, type: `"swap"`, target: `this` } Inherited from `List` Two items swapped places.
There are 7 inherited items currently hidden from this list.