[add] getSortingStates() method page for data/treecollection

Author: mafanya23

docs/data_collection/api/datacollection_getsortingstates_method.md

@@ -0,0 +1,46 @@
+---
+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
+
+:::note
+The method allows sorting data by multiple columns.
+:::
+
+## Usage
+
+~~~jsx 
+interface ISortingState {
+    by?: string | number, // the id of a data field (a column of Grid) to sort by
+    dir?: "asc" | "desc", // the direction of sorting: "asc" or "desc"
+    as?: (a) => any, // a custom function of converting values before comparing
+    rule?: (a, b) => number, // a custom sorting function
+    smartSorting?: boolean // (if can be applied) specifies whether a sorting rule should be applied each time after changing the data set
+}
+
+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 return object includes the following properties:
+
+- `by` - (*string|number*) the id of a data field (a column of Grid) to sort by
+- `dir` - (*"asc"|"desc"*) the direction of sorting: "asc" or "desc"
+- `as` - (*function*) a custom function of converting values before comparing
+- `rule` - (*function*) a custom sorting function
+- `smartSorting` - (*boolean*) (if can be applied) specifies whether a sorting rule should be applied each time after changing the data set
+
+@changelog:
+added in v9.1

docs/tree_collection/api/treecollection_getsortingstates_method.md

@@ -0,0 +1,45 @@
+---
+sidebar_label: getSortingStates()
+title: JavaScript TreeCollection - getSortingStates Method 
+description: You can explore the getSortingStates method of TreeCollection 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
+
+:::note
+The method allows sorting data by multiple columns.
+:::
+
+## Usage
+
+~~~jsx 
+interface ISortingState {
+    by?: string | number, // the id of a data field (a column of Grid) to sort by
+    dir?: "asc" | "desc", // the direction of sorting: "asc" or "desc"
+    as?: (a) => any, // a custom function of converting values before comparing
+    rule?: (a, b) => number, // a custom sorting function
+    smartSorting?: boolean // (if can be applied) specifies whether a sorting rule should be applied each time after changing the data set
+}
+
+getSortingStates(): ISortingState[];
+~~~
+
+@returns:
+An array of objects with the current parameters of sorting applied to the data.
+
+@example:
+const state = component.data.getSortingStates(); 
+
+@descr:
+The return object includes the following properties:
+
+- `by` - (*string|number*) the id of a data field (a column of Grid) to sort by
+- `dir` - (*"asc"|"desc"*) the direction of sorting: "asc" or "desc"
+- `as` - (*function*) a custom function of converting values before comparing
+- `rule` - (*function*) a custom sorting function
+- `smartSorting` - (*boolean*) (if can be applied) specifies whether a sorting rule should be applied each time after changing the data set
+
+@changelog:
+added in v9.1

sidebars.js

@@ -4569,6 +4569,7 @@ module.exports = {
               "data_collection/api/datacollection_getinitialdata_method",
               "data_collection/api/datacollection_getitem_method",
               "data_collection/api/datacollection_getlength_method",
+              "data_collection/api/datacollection_getsortingstates_method",
               "data_collection/api/datacollection_group_method",
               "data_collection/api/datacollection_isdataloaded_method",
               "data_collection/api/datacollection_isgrouped_method",
@@ -4770,6 +4771,7 @@ module.exports = {
               "tree_collection/api/treecollection_getlength_method",
               "tree_collection/api/treecollection_getparent_method",
               "tree_collection/api/treecollection_getroot_method",
+              "tree_collection/api/treecollection_getsortingstates_method",
               "tree_collection/api/treecollection_haveitems_method",
               "tree_collection/api/treecollection_issaved_method",
               "tree_collection/api/treecollection_load_method",