jsxgrid 2.3.1 → 2.4.1

package/src/fields/jsgrid.field.Xselect.js

@@ -1,11 +1,11 @@
-(function(jsGrid, $, undefined) {
-
-    if (!jsGrid) {
-        if (window.console) {
-            console.error("[jsxgrid] jsgrid.field.Xselect.js was loaded before the jsxgrid engine (jsxgrid.js) - include the engine first.");
-        }
-        return;
-    }
+(function(jsGrid, $, undefined) {
+
+    if (!jsGrid) {
+        if (window.console) {
+            console.error("[jsxgrid] jsgrid.field.Xselect.js was loaded before the jsxgrid engine (jsxgrid.js) - include the engine first.");
+        }
+        return;
+    }
 
 
     // Standalone: does not extend jsGrid.SelectField, only jsGrid.Field.
@@ -35,7 +35,8 @@
         valueType: NUMBER_VALUE_TYPE,
         pseudoElement: null,//pseudoElement that will be unsifted to start of select data in filters
         select2: null,
-        defaultSelected: null,
+        defaultSelected: null,//value to preselect in the filter, applied once on first filter render then reset
+        defaultValue: null,//value to preselect in the insert row, applied every time a fresh insert row is built (not reset after use, unlike defaultSelected)
 
         itemTemplate: function (value) {
             var items = this.items,
@@ -64,7 +65,11 @@
             if (!this.inserting)
                 return "";
 
-            return this.insertControl = this._createSelect();
+            var $result = this.insertControl = this._createSelect();
+            if (this.defaultValue !== null) {
+                $result.val(this.defaultValue);
+            }
+            return $result;
         },
 
         editTemplate: function (value) {

package/src/fields/jsgrid.field.Xtext.js

@@ -20,6 +20,7 @@
         autosearch: true,
         readOnly: false,
         defaultSelected: null,//value to preset the filter input with, applied once on first filter render then reset
+        defaultValue: null,//value to prefill the insert row with, applied every time a fresh insert row is built (not reset after use, unlike defaultSelected)
 
         filterTemplate: function () {
             if (!this.filtering)
@@ -49,7 +50,11 @@
             if (!this.inserting)
                 return "";
 
-            return this.insertControl = this._createTextBox();
+            var $result = this.insertControl = this._createTextBox();
+            if (this.defaultValue !== null) {
+                $result.val(this.defaultValue);
+            }
+            return $result;
         },
 
         editTemplate: function (value) {

package/src/fields/jsgrid.field.Xtextarea.js

@@ -1,11 +1,11 @@
-(function(jsGrid, $, undefined) {
-
-    if (!jsGrid) {
-        if (window.console) {
-            console.error("[jsxgrid] jsgrid.field.Xtextarea.js was loaded before the jsxgrid engine (jsxgrid.js) - include the engine first.");
-        }
-        return;
-    }
+(function(jsGrid, $, undefined) {
+
+    if (!jsGrid) {
+        if (window.console) {
+            console.error("[jsxgrid] jsgrid.field.Xtextarea.js was loaded before the jsxgrid engine (jsxgrid.js) - include the engine first.");
+        }
+        return;
+    }
 
 
     // Standalone: does not extend jsGrid.TextAreaField, only jsGrid.Field.
@@ -21,6 +21,7 @@
         readOnly: false,
         maxShowSymbols: 50,
         defaultSelected: null,//value to preset the filter input with, applied once on first filter render then reset
+        defaultValue: null,//value to prefill the insert row with, applied every time a fresh insert row is built (not reset after use, unlike defaultSelected)
 
         filterTemplate: function () {
             if (!this.filtering)
@@ -54,7 +55,11 @@
             if (!this.inserting)
                 return "";
 
-            return this.insertControl = this._createTextArea();
+            var $result = this.insertControl = this._createTextArea();
+            if (this.defaultValue !== null) {
+                $result.val(this.defaultValue);
+            }
+            return $result;
         },
 
         editTemplate: function (value) {

package/src/jsgrid.core.js

@@ -136,6 +136,13 @@
         sortAscClass: "jsgrid-header-sort jsgrid-header-sort-asc",
         sortDescClass: "jsgrid-header-sort jsgrid-header-sort-desc",
 
+        // jsxgrid extension: initial sort applied once at construction (field
+        // name/index/reference + "asc"/"desc"), baked into the first render/load
+        // instead of requiring a separate sort() call (and the extra
+        // refresh/reload that would trigger) right after creating the grid.
+        sortField: null,
+        sortOrder: null,
+
         paging: false,
         pagerContainer: null,
         pageIndex: 1,
@@ -209,11 +216,54 @@
             this._initLoadStrategy();
             this._initController();
             this._initFields();
+            this._initSorting();
             this._attachWindowLoadResize();
             this._attachWindowResizeCallback();
             this._callEventHandler(this.onInit)
         },
 
+        _initSorting: function() {
+            if(!this.sortField) {
+                return;
+            }
+
+            var field = this._normalizeField(this.sortField);
+            if(!field) {
+                return;
+            }
+
+            this._sortField = field;
+            this._sortOrder = this.sortOrder || SORT_ORDER_ASC;
+
+            // Static in-memory data (already present at construction time, not
+            // fetched via a controller) needs an explicit sort here - normal
+            // rendering never sorts on its own, only an actual sort() call does
+            // (see DirectLoadingStrategy.sort()).
+            if($.isArray(this.data) && this.data.length) {
+                this._sortData();
+                return;
+            }
+
+            // Controller-backed, non-paged grid: data isn't loaded yet at this
+            // point (arrives later via finishLoad), so there's nothing to sort
+            // here. Without this flag the header would still show the sort
+            // arrow (see _createHeaderRow()) while the actual rows stay in
+            // whatever order the controller returned - and the first real
+            // click on that same header would then look like it skips
+            // straight past the "ascending" pass, since _setSortingParams()
+            // reverses the order when clicking the field _sortField already
+            // points at. Picked up once, in _handleOptionChange's "data" case,
+            // as soon as the first load actually lands.
+            // pageLoading grids are excluded - sorting for those already
+            // happens server-side, from the sortField/sortOrder this same
+            // init sends along in the very first loadData() filter (see
+            // _sortingParams()); sorting the current page again client-side on
+            // top of that would be redundant at best.
+            if(!this.pageLoading) {
+                this._pendingInitialSort = true;
+            }
+        },
+
         _initInstanceLocale: function(locale) {
             if(!locale) {
                 return;
@@ -382,6 +432,12 @@
                     this.render();
                     break;
                 case "data":
+                    if(this._pendingInitialSort) {
+                        this._pendingInitialSort = false;
+                        this._sortData();
+                    }
+                    this.refresh();
+                    break;
                 case "editing":
                 case "heading":
                 case "filtering":
@@ -533,6 +589,10 @@
                         .on("click", $.proxy(function() {
                             this.sort(index);
                         }, this));
+
+                    if(field === this._sortField) {
+                        $th.addClass(this._sortOrder === SORT_ORDER_ASC ? this.sortAscClass : this.sortDescClass);
+                    }
                 }
             });