Skip to main content

add()

adds a new item to the component

add(new_item: IDataItem | IDataItem[], index?: number): Id | Id[];

Parameters:

  • new_item: object | array - the object of a new item or an array of item objects
  • index: number - optional, the index of the position starting from which new items will be added

Returns:

Either a string with the item's id or an array of string values 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 collectioncomponent.data.add([    {        "value": 57.44787660011765,        "id": "u1565340894584"    },    {        "value": 14.612810637958095,        "id": "u1565340894585"    },    {        "value": 83.9707181117741,        "id": "u1565340894586"    },    {        "value": 59.01285878162044,        "id": "u1565340894587"    }]);

Related sample: Data. Add

Change log:

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