jsxgrid 2.3.1 → 2.4.0

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,38 @@
             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()). Controller-backed data follows
+            // the same rule sorting already does elsewhere: pageLoading sends
+            // sortField/sortOrder to the server via loadData()'s filter, while
+            // plain (non-paged) controller data is left as the controller
+            // returns it, same as clicking a sortable header would leave it.
+            if($.isArray(this.data) && this.data.length) {
+                this._sortData();
+            }
+        },
+
         _initInstanceLocale: function(locale) {
             if(!locale) {
                 return;
@@ -533,6 +567,10 @@
                         .on("click", $.proxy(function() {
                             this.sort(index);
                         }, this));
+
+                    if(field === this._sortField) {
+                        $th.addClass(this._sortOrder === SORT_ORDER_ASC ? this.sortAscClass : this.sortDescClass);
+                    }
                 }
             });