Merge pull request #16 from DHTMLX/mr-update-datacollection-api-4736

Author: mafanya23

docs/data_collection/api/datacollection_foreach_method.md

@@ -11,7 +11,7 @@ description: You can explore the forEach method of DataCollection in the documen
 @signature: {'forEach(callback: (item: object, index?: number, array?: object[]) => any): void;'}
 
 @params:
-- `callback: function` - a function that will iterate over items of a data collection. The function takes three parameters:
+- `callback: function` - a function that will iterate over items of a data collection. The function is called with the following parameters:
     - `item` - (required) the object of an item
     - `index` - (optional) the index of an item
     - `array` - (optional) an array with items

docs/data_collection/api/datacollection_map_method.md

@@ -8,18 +8,21 @@ description: You can explore the map method of DataCollection in the documentati
 
 @short: iterates through all items of the component
 
-@signature: {'map(callback: function): object[];'}
+@signature: {'map(callback: (item: object, index?: number, array?: object[]) => any): object[];'}
 
 @params:
-- `callback: function` - a function that will be called for each item of a component
+- `callback: function` - a function that will be called for each item of a component. The function is called with the following parameters:
+    - `item` - (required) the object of an item
+    - `index` - (optional) the index of an item
+    - `array` - (optional) an array with items
 
 @returns:
 A new array of items where each item is the result of the callback function.
 
 @example:
 //getting ids of all items of the component
-component.data.map(function(item){
-    return item;
+component.data.map(function(item, index, array){
+    return item.id;
 });
 
 @descr:

docs/data_collection/api/datacollection_maprange_method.md

@@ -6,20 +6,23 @@ description: You can explore the mapRange method of DataCollection in the docume
 
 # mapRange()
 
-@short: returns a new array of the items correspond to the specified parameters
+@short: returns a new array of the items according to the specified parameters
 
-@signature: {'mapRange(from: number, to: number, callback: function): object[];'}
+@signature: {'mapRange(from: number, to: number, callback: (item: object, index?: number, array?: object[]) => any): object[];'}
 
 @params:
 - `from: number` - the initial position of an item in the range
 - `to: number` - the final position of an item in the range
-- `callback: function` - a function that will be called for each item from the specified range
+- `callback: function` - a function that will be called for each item from the specified range. The function is called with the following parameters:
+    - `item` - (required) the object of an item
+    - `index` - (optional) the index of an item
+    - `array` - (optional) an array with items
 
 @returns:
 A new array of matching item objects.
 
 @example:
-const result = component.data.mapRange(0, 20, function(item, index) {
+const result = component.data.mapRange(0, 20, function(item, index, array) {
     console.log(item.id, index);
 });
 

docs/tree_collection/api/treecollection_removeall_method.md

@@ -6,11 +6,15 @@ description: You can explore the removeAll method of TreeCollection in the docum
 
 # removeAll()
 
-@short: clears the component of all controls
+@short: removes all items in the target branch
 
-@signature: {'removeAll(): void;'}
+@signature: {'removeAll(id: string | number): void;'}
+
+@params:
+
+- `id: string | number` - the id of the branch
 
 @example:
-toolbar.data.removeAll();
+toolbar.data.removeAll(id);
 
 @descr: