class anychart.data.Tree Improve this Doc

Tree data model.

Methods Overview

Data
addChild()	Adds a new root element and return it.
addChildAt()	Inserts a new root element into a specified position by index and return it.
addData()	Adds a data.
createIndexOn()	Creates an index on a specified field.
dispatchEvents()	Tree CRUD events dispatching
getChildAt()	Gets the child by index.
getChildren()	Returns a copy of roots array.
getTraverser()	Creates tree data traverser.
indexOfChild()	Gets index of child in a roots array.
mapAs()	Returns a new mapping for the tree.
numChildren()	Returns a length of roots array.
removeChild()	Removes tree's root data item.
removeChildAt()	Removes child at specified position.
removeChildren()	Removes children of tree.
removeIndexOn()	Removes index on a specified field.
search()	Performs a data search.
searchItems()	Performs an items search.
Events
listen()	Adds an event listener.
listenOnce()	Adds a single time event listener.
removeAllListeners()	Removes all listeners.
unlisten()	Removes the listener.
unlistenByKey()	Removes the listener by the key.

Methods Description

addChild

addChild(child)

Adds a new root element and return it.

Params:

Name	Type	Description
child	Object	Child object.

Returns:

anychart.data.Tree.DataItem - An instance of the class for method chaining.

Try it:

Usage sample

addChildAt

addChildAt(child, index)

Inserts a new root element into a specified position by index and return it.

Params:

Name	Type	Description
child	Object \| anychart.data.Tree.DataItem \| anychart.data.TreeView.DataItem	Child object.
index	number	Position.

Returns:

anychart.data.Tree.DataItem - An instance of the class for method chaining.

Try it:

Usage sample

addData

addData(data, fillingMethod, csvSettingsOrDeps)

Adds a data.

Params:

Name	Type	Description
data	Array.<Object> \| string	Raw data.
fillingMethod	anychart.enums.TreeFillingMethod \| string	Filling method.
csvSettingsOrDeps	Object \| Array.<anychart.data.Tree.Dependency>	CSV settings object or dependencies data.

Returns:

anychart.data.Tree - Self instance for method chaining.

Try it:

createIndexOn

createIndexOn(field, asString)

Creates an index on a specified field.
It can't be indexed by 'parent' or 'children' fields because these fields are not available by treeItem.get(field);.

Params:

Name	Type	Description
field	string	Field name.
asString	boolean	If the value should be treated as string always.

Returns:

anychart.data.Tree - Self instance for method chaining.

Sample for method createIndexOn.

var rawdata = [
{name: 1, children: [
    {name: 2, children: [
        {name: 3},
        {name: 4, children: [
            {name: 5},
            {name: 6}
        ]}
    ]},
    {name: 7, children: [
        {name: 8}
    ]}
]}
];
var treeData = anychart.data.tree(rawdata, anychart.enums.TreeFillingMethod.TREE);
treeData.createIndexOn("name"); // Creates index.
treeData.search("name", 5);

dispatchEvents

dispatchEvents()Since version 7.8.0

Gets tree CRUD events dispatching.

Returns:

boolean - Current value.

Try it:

Usage sample

dispatchEvents(value)Since version 7.8.0

Starts or stops tree CRUD events dispatching.

Params:

Name	Type	Default	Description
value	boolean	true	Value to set.

Returns:

anychart.data.Tree - Self instance for method chaining.

Try it:

Usage sample

getChildAt

getChildAt(index)

Gets the child by index.

Params:

Name	Type	Description
index	number	Index of child to find.

Returns:

anychart.data.Tree.DataItem | undefined - Child into a specified position.

Try it:

Usage sample

getChildren

getChildren()

Returns a copy of roots array.

Returns:

Array.<anychart.data.Tree.DataItem> - Copy of roots array.

Try it:

Usage sample

getTraverser

getTraverser()

Creates tree data traverser.

Returns:

anychart.data.Traverser - An instance of the class for method chaining.

Sample for method getTraverser.

var rawdata = [
{name: 1, children: [
    {name: 2, children: [
        {name: 3},
        {name: 4, children: [
            {name: 5},
            {name: 6}
        ]}
    ]},
    {name: 7, children: [
        {name: 8}
    ]}
]}
];
var treeData = anychart.data.tree(rawdata, anychart.enums.TreeFillingMethod.TREE);
treeData.getTraverser(); // creates traverser

indexOfChild

indexOfChild(child)

Gets index of child in a roots array.

Params:

Name	Type	Description
child	anychart.data.Tree.DataItem \| anychart.data.TreeView.DataItem	Child for getting of index.

Returns:

number - Index of child.

Try it:

Usage sample

listen

listen(type, listener, useCapture, listenerScope)

Adds an event listener to an implementing object.

Detailed description

The listener can be added to an object once, and if it is added one more time, its key will be returned.
Note Notice that if the existing listener is one-off (added using listenOnce), it will cease to be such after calling the listen() method.

Params:

Name	Type	Default	Description
type	string		The event type id.
listener	function		Callback method. Function that looks like `function(event){ // event.actualTarget - actual event target // event.currentTarget - current event target // event.iterator - event iterator // event.originalEvent - original event // event.point - event point // event.pointIndex - event point index }`.
useCapture	boolean	false	Whether to fire in capture phase. Learn more about capturing https://javascript.info/bubbling-and-capturing
listenerScope	Object		Object in whose scope to call the listener.

Returns:

Object - Unique key for the listener.

Try it:

Usage sample

listenOnce

listenOnce(type, listener, useCapture, listenerScope)

Adds an event listener to an implementing object.

Detailed description

After the event is called, its handler will be deleted.
If the event handler being added already exists, listenOnce will do nothing.
Note In particular, if the handler is already registered using listen(), listenOnce() will not make it one-off. Similarly, if a one-off listener already exists, listenOnce will not change it (it wil remain one-off).

Params:

Name	Type	Default	Description
type	string		The event type id.
listener	function		Callback method.
useCapture	boolean	false	Whether to fire in capture phase. Learn more about capturing https://javascript.info/bubbling-and-capturing
listenerScope	Object		Object in whose scope to call the listener.

Returns:

Object - Unique key for the listener.

Try it:

Usage sample

mapAs

mapAs(mapping)Since version 7.12.0

Returns a new mapping for the tree.

Params:

Name	Type	Description
mapping	Object	Mapping for the tree.

Returns:

anychart.data.TreeView - An instance of the class for method chaining.

Try it:

Usage sample

numChildren

numChildren()

Returns a length of roots array.

Returns:

number - Number of roots.

Try it:

Usage sample

removeAllListeners

removeAllListeners(type)

Removes all listeners from an object. You can also optionally remove listeners of some particular type.

Params:

Name	Type	Description
type	string	Type of event to remove, default is to remove all types.

Returns:

number - Number of listeners removed.

Try it:

Usage sample

removeChild

removeChild(child)

Removes tree's root data item.

Params:

Name	Type	Description
child	anychart.data.Tree.DataItem	Child for removal.

Returns:

anychart.data.Tree.DataItem - An instance of the class for method chaining.

Try it:

Usage sample

removeChildAt

removeChildAt(index)

Removes child at specified position.

Params:

Name	Type	Description
index	number	Index of data item for removal.

Returns:

anychart.data.Tree.DataItem - Removed item or null if item is not found.

Try it:

Usage sample

removeChildren

removeChildren()

Removes children of tree.

Returns:

anychart.data.Tree - Self instance for method chaining.

Try it:

Usage sample

removeIndexOn

removeIndexOn(field)

Removes index on a specified field.

Params:

Name	Type	Description
field	string	Field name.

Returns:

anychart.data.Tree - Self instance for method chaining.

Sample for method removeIndexOn.

var rawdata = [
{name: 1, children: [
    {name: 2, children: [
        {name: 3},
        {name: 4, children: [
            {name: 5},
            {name: 6}
        ]}
    ]},
    {name: 7, children: [
        {name: 8}
    ]}
]}
];
var treeData = anychart.data.tree(rawdata, anychart.enums.TreeFillingMethod.TREE);
treeData.createIndexOn('name');
treeData.search('name', 5);
treeData.removeIndexOn('name'); // removes index

search

search(soughtField, value, comparisonFn)

Performs a data search.

Detailed description

Returns null of nothing is found, tree data item if here's a single result and array of tree data items if here are multiple matches.
Note: Search tree without indexing for certain key is inefficiently.

Params:

Name	Type	Description
soughtField	string	Field for search. Literally means the name of field of data item.
value	string \| number \| boolean	Sought value.
comparisonFn	function	Comparison function.

Returns:

anychart.data.Tree.DataItem | Array.<anychart.data.Tree.DataItem> | null - Found tree data item or null or array of found tree data items.

Try it:

Usage sample

searchItems

searchItems(soughtField, value, comparisonFn)

Performs a data search. Actually does the same as (anychart.data.Tree#search) but result is always an array.

Params:

Name	Type	Description
soughtField	string	Field for search. Literally means the name of field of data item.
value	string \| number \| boolean	Sought value
comparisonFn	function	Comparison function.

Returns:

Array.<anychart.data.Tree.DataItem> - Array of found tree data items.

Try it:

Usage sample

unlisten

unlisten(type, listener, useCapture, listenerScope)

Removes a listener added using listen() or listenOnce() methods.

Params:

Name	Type	Default	Description
type	string		The event type id.
listener	function		Callback method.
useCapture	boolean	false	Whether to fire in capture phase. Learn more about capturing https://javascript.info/bubbling-and-capturing
listenerScope	Object		Object in whose scope to call the listener.

Returns:

boolean - Whether any listener was removed.

Try it:

Usage sample

unlistenByKey

unlistenByKey(key)

Removes an event listener which was added with listen() by the key returned by listen() or listenOnce().

Params:

Name	Type	Description
key	Object	The key returned by listen() or listenOnce().

Returns:

boolean - Whether any listener was removed.

Try it:

Usage sample