add

adds a new item to the component

string|string[] add(object|array new_item,number index);

Parameters

new_itemobject|arraythe object of a new item or an array of item objects
indexnumberoptional, the index of the position starting from which new items will be added

Returns

string|string[]the item's id or an array with ids of items

Example

// adding a new item into the beginning of a data collection 
component.data.add({"value": 57.44787660011765, "id": "u1565340894584"},0);
 
// adding an array of new items into a data collection
component.data.add([
    {
        "value": 57.44787660011765,
        "id": "u1565340894584"
    },
    {
        "value": 14.612810637958095,
        "id": "u1565340894585"
    },
    {
        "value": 83.9707181117741,
        "id": "u1565340894586"
    },
    {
        "value": 59.01285878162044,
        "id": "u1565340894587"
    }
]);

Related samples

See also
Change log

possibility to pass an array of items is added in v6.1

Back to top