Merge branch 'next' into grid-column-properties-guide-4802

Author: mafanya23

docs/assets/grid/multi_level_nesting.png

@@ -252,7 +252,7 @@ const chart = new dhx.Chart("chart_container", {
 
 **Related sample**: [Chart. Value template](https://snippet.dhtmlx.com/o7ke2f1s)
 
-When you need to show values for data items on the Pie, Pie3D and Donut charts, you can use the **valueTemplate** option of [series](chart/configuration_properties.md#the-list-of-config-options-for-series-for-charts-without-scales-pie-pie3d-donut) to specify the necessary template function. For example:
+When you need to show values for data items on the Pie, Pie3D and Donut charts, you can use the **valueTemplate** option of [series](chart/configuration_properties.md/#pie-pie-3d-and-donut-chart) to specify the necessary template function. For example:
 
 ~~~jsx {6-8}
 const chart = new dhx.Chart("chart_container", {

docs/assets/grid/multisort_grouped_data.png

@@ -14,12 +14,12 @@ description: You can explore the filter method of DataCollection in the document
 - `rule: function | object` - the filtering criteria
     - If set as a *function*, filtering will be applied by the rule specified in the function. The function takes an object of a data item as a parameter and returns *true/false*
     - If set as an *object*, the parameter has the following attributes:
-        - `by: string | number` - mandatory, the id of a data field (the column of Grid)
+        - `by: string | number` - mandatory, the id of a data field 
         - `match: string` - mandatory, a pattern to match
         - `compare: function` - optional, a function for extended filtering that takes three parameters:
-            - `value` - the value to compare (e.g. a column in a row for Grid)
+            - `value` - the value to compare 
             - `match` - a pattern to match
-            - `item` - a data item the values of which should be compared (e.g. a row)
+            - `item` - a data item the values of which should be compared 
 - `config: object` - optional, defines the parameters of filtering. It may contain the following properties: 
     - `id: string` - optional, the id of the filter
     - `add: boolean` - optional, defines whether each next filtering will be applied to the already filtered data (<i>true</i>), or to the initial data (<i>false</i>, default)

docs/assets/grid/multisorting_data.png

@@ -11,10 +11,10 @@ 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:
-    - `item` - (required) the object of an item
-    - `index` - (optional) the index of an item
-    - `array` - (optional) an array with items
+- `callback: function` - a function that will iterate over items of a data collection. The function is called with the following parameters:
+    - `item` - the object of an item
+    - `index` - the index of an item
+    - `array` - an array of items the method was called upon
 
 @example:
 component.data.forEach(function(item, index, array) {

docs/assets/grid/row_expander.png

@@ -15,7 +15,7 @@ description: You can explore the getFilters method of DataCollection in the docu
 - `permanent: boolean` - optional, <i>false</i> by default. Allows getting the list of permanent filters
 
 @returns:
-- `filters: object` - an object with the applied filters, where the key is the id of a filter and the value is an object with the [**rule** and **config** properties](data_collection/api/datacollection_filter_method.md)
+- `filters: object` - an object with the applied filters, where the key is the id of a filter and the value is an object with the [`rule` and `config` properties](data_collection/api/datacollection_filter_method.md)
 
 @example:
 const filters = grid.data.getFilters();

docs/assets/grid/subgrid_specific_rows.png

@@ -0,0 +1,61 @@
+---
+sidebar_label: getSortingStates()
+title: JavaScript DataCollection - getSortingStates Method 
+description: You can explore the getSortingStates method of DataCollection in the documentation of the DHTMLX JavaScript UI library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Suite.
+---
+
+# getSortingStates()
+
+@short: returns an array of objects with the current parameters of sorting applied to the data
+
+## Usage
+
+~~~jsx 
+interface ISortingState {
+    by: string | number, 
+    dir: "asc" | "desc", 
+    as?: (a) => any,
+    rule?: (a, b) => number, 
+    smartSorting?: boolean 
+}
+
+getSortingStates(): ISortingState[];
+~~~
+
+@returns:
+An array of objects with the current parameters of sorting applied to the data.
+
+@example:
+const state = grid.data.getSortingStates(); 
+// -> [{by: "country", dir: "desc"}, {by: "population", dir: "desc"}]
+
+@descr:
+The array returned by the method contains objects with the following properties:
+
+<table>
+    <tbody>
+        <tr>
+            <td><b>by</b></td>
+            <td>(<i>string | number</i>) the id of a data field to sort by</td>
+        </tr>
+        <tr>
+            <td><b>dir</b></td>
+            <td>(<i>string</i>) the direction of sorting: "asc" or "desc"</td>
+        </tr>
+        <tr>
+            <td><b>as</b></td>
+            <td>(<i>function</i>) optional, a custom function of converting values before comparing</td>
+        </tr>
+        <tr>
+            <td><b>rule</b></td>
+            <td>(<i>function</i>) optional, a custom sorting function</td>
+        </tr>
+        <tr>
+            <td><b>smartSorting</b></td>
+            <td>(<i>boolean</i>) optional, (if applied) specifies whether a sorting rule should be applied each time after changing the data set</td>
+        </tr>
+    </tbody>
+</table>
+
+@changelog:
+added in v9.1