|
| 1 | +--- |
| 2 | +title: Capturing Sort Events in Kendo UI Spreadsheet |
| 3 | +description: How to capture sort events in the Spreadsheet component when a user changes the sort order. |
| 4 | +type: how-to |
| 5 | +page_title: How to Implement Sort Event Handling in Kendo UI Spreadsheet |
| 6 | +slug: how-to-capture-sort-events-in-kendo-ui-spreadsheet |
| 7 | +tags: kendo-ui, spreadsheet, event-handling, sorting |
| 8 | +res_type: kb |
| 9 | +ticketid: 1669478 |
| 10 | +--- |
| 11 | + |
| 12 | +## Environment |
| 13 | + |
| 14 | +<table> |
| 15 | +<tbody> |
| 16 | +<tr> |
| 17 | +<td>Product</td> |
| 18 | +<td>Spreadsheet for Progress® Kendo UI®</td> |
| 19 | +</tr> |
| 20 | +<tr> |
| 21 | +<td>Version</td> |
| 22 | +<td>2024.3.1015</td> |
| 23 | +</tr> |
| 24 | +</tbody> |
| 25 | +</table> |
| 26 | + |
| 27 | +## Description |
| 28 | +I need to trigger a sort event in the [Spreadsheet](https://docs.telerik.com/kendo-ui/api/javascript/ui/spreadsheet) component when a user changes the sort order by using the built-in sort feature. Currently, the Spreadsheet does not natively provide sort or filter events. |
| 29 | + |
| 30 | +This KB article also answers the following questions: |
| 31 | +- How can I detect when a user sorts data in the Spreadsheet? |
| 32 | +- What approach can I use to capture sort actions in the Spreadsheet? |
| 33 | +- Is there a way to execute custom logic after sorting in the Spreadsheet? |
| 34 | + |
| 35 | +## Solution |
| 36 | +To achieve the detection of sort events in the Spreadsheet when the user changes the sort order, you can handle the click event on the filter icons. Then, bind click event listeners to the sorting actions ('Sort from A to Z' and 'Sort from Z to A') and execute the necessary logic. |
| 37 | + |
| 38 | +The following example demonstrates how to bind event listeners for sorting actions: |
| 39 | + |
| 40 | +```javascript |
| 41 | +$('.k-spreadsheet-filter').on('click', function(){ |
| 42 | + var current = this; |
| 43 | + $('li[data-dir="asc"]').click({param1: current}, function(ev){ |
| 44 | + alert('Sort ASC'); |
| 45 | + }); |
| 46 | + |
| 47 | + $('li[data-dir="desc"]').click({param1: current}, function(ev){ |
| 48 | + alert('Sort DESC'); |
| 49 | + }); |
| 50 | +}); |
| 51 | +``` |
| 52 | + |
| 53 | +The above code snippet captures both ascending and descending sort actions performed by the user and demonstrates a simple alert as a placeholder for any custom logic you might want to implement. |
| 54 | + |
| 55 | +For a practical demonstration, refer to the example below: |
| 56 | + |
| 57 | +```dojo |
| 58 | +<div id="spreadsheet" style="width: 100%"></div> |
| 59 | + <script> |
| 60 | + $(function() { |
| 61 | + var crudServiceBaseUrl = "https://demos.telerik.com/kendo-ui/service"; |
| 62 | +
|
| 63 | + var dataSource = new kendo.data.DataSource({ |
| 64 | + transport: { |
| 65 | + read: onRead, |
| 66 | + submit: onSubmit |
| 67 | + }, |
| 68 | + batch: true, |
| 69 | + sort: {field: "ProductID", dir: 'desc'}, |
| 70 | + schema: { |
| 71 | + model: { |
| 72 | + id: "ProductID", |
| 73 | + fields: { |
| 74 | + ProductID: { type: "number" }, |
| 75 | + ProductName: { type: "string" }, |
| 76 | + UnitPrice: { type: "number" }, |
| 77 | + Discontinued: { type: "boolean" }, |
| 78 | + UnitsInStock: { type: "number" } |
| 79 | + } |
| 80 | + } |
| 81 | + } |
| 82 | + }); |
| 83 | +
|
| 84 | + $("#spreadsheet").kendoSpreadsheet({ |
| 85 | + dataBound: function(){ |
| 86 | + $('.k-spreadsheet-filter').on('click', function(){ |
| 87 | +
|
| 88 | + var current = this; |
| 89 | + $('li[data-dir="asc"]').click({param1: current}, function(ev){ |
| 90 | + alert('Sort ASC') |
| 91 | + }) |
| 92 | +
|
| 93 | + $('li[data-dir="desc"]').click({param1: current}, function(ev){ |
| 94 | + alert('Sort DESC') |
| 95 | + }) |
| 96 | + }) |
| 97 | + }, |
| 98 | + columns: 20, |
| 99 | + rows: 100, |
| 100 | + toolbar: false, |
| 101 | + sheetsbar: false, |
| 102 | + sheets: [{ |
| 103 | + name: "Products", |
| 104 | + dataSource: dataSource, |
| 105 | + filter: { |
| 106 | + ref: "A1:E79", |
| 107 | + columns:[] |
| 108 | + }, |
| 109 | + rows: [{ |
| 110 | + height: 40, |
| 111 | + cells: [ |
| 112 | + { |
| 113 | + bold: "true", |
| 114 | + background: "#9c27b0", |
| 115 | + textAlign: "center", |
| 116 | + color: "white" |
| 117 | + },{ |
| 118 | + bold: "true", |
| 119 | + background: "#9c27b0", |
| 120 | + textAlign: "center", |
| 121 | + color: "white" |
| 122 | + },{ |
| 123 | + bold: "true", |
| 124 | + background: "#9c27b0", |
| 125 | + textAlign: "center", |
| 126 | + color: "white" |
| 127 | + },{ |
| 128 | + bold: "true", |
| 129 | + background: "#9c27b0", |
| 130 | + textAlign: "center", |
| 131 | + color: "white" |
| 132 | + },{ |
| 133 | + bold: "true", |
| 134 | + background: "#9c27b0", |
| 135 | + textAlign: "center", |
| 136 | + color: "white" |
| 137 | + }] |
| 138 | + }], |
| 139 | + columns: [ |
| 140 | + { width: 100 }, |
| 141 | + { width: 415 }, |
| 142 | + { width: 145 }, |
| 143 | + { width: 145 }, |
| 144 | + { width: 145 } |
| 145 | + ] |
| 146 | + }] |
| 147 | + }); |
| 148 | +
|
| 149 | +
|
| 150 | +
|
| 151 | + function onSubmit(e) { |
| 152 | + $.ajax({ |
| 153 | + url: crudServiceBaseUrl + "/Products/Submit", |
| 154 | + data: { models: kendo.stringify(e.data) }, |
| 155 | + contentType: "application/json", |
| 156 | + dataType: "jsonp", |
| 157 | + success: function (result) { |
| 158 | + e.success(result.Updated, "update"); |
| 159 | + e.success(result.Created, "create"); |
| 160 | + e.success(result.Destroyed, "destroy"); |
| 161 | + }, |
| 162 | + error: function (xhr, httpStatusMessage, customErrorMessage) { |
| 163 | + alert(xhr.responseText); |
| 164 | + } |
| 165 | + }); |
| 166 | + } |
| 167 | +
|
| 168 | + function onRead(options) { |
| 169 | + $.ajax({ |
| 170 | + url: crudServiceBaseUrl + "/Products", |
| 171 | + dataType: "jsonp", |
| 172 | + success: function (result) { |
| 173 | + options.success(result); |
| 174 | + }, |
| 175 | + error: function (result) { |
| 176 | + options.error(result); |
| 177 | + } |
| 178 | + }); |
| 179 | + } |
| 180 | + }); |
| 181 | + </script> |
| 182 | + </div> |
| 183 | +``` |
| 184 | + |
| 185 | +## See Also |
| 186 | + |
| 187 | +- [Kendo UI Spreadsheet Overview](https://docs.telerik.com/kendo-ui/controls/data-management/spreadsheet/overview) |
| 188 | +- [Kendo UI Spreadsheet API Reference](https://docs.telerik.com/kendo-ui/api/javascript/ui/spreadsheet) |
0 commit comments