jqgrid_utils 1.28.0 → 1.30.0

package/README.md

@@ -37,6 +37,7 @@ A module for Jqgrid_utils
     * [module.exports#_date112_to_DMY(cell_value, seperator)](#exp_module_Jqgrid_utils--module.exports+_date112_to_DMY) ⏏
     * [module.exports#date112_to_DMY(col_model, edit_field, seperator)](#exp_module_Jqgrid_utils--module.exports+date112_to_DMY) ⏏
     * [module.exports#add_formatter(col_model, edit_field, formatter)](#exp_module_Jqgrid_utils--module.exports+add_formatter) ⏏
+    * [module.exports#natural_sort(col_model, column_name)](#exp_module_Jqgrid_utils--module.exports+natural_sort) ⇒ <code>array</code> ⏏
     * [module.exports#add_html_formatter(col_model, edit_field, html)](#exp_module_Jqgrid_utils--module.exports+add_html_formatter) ⇒ <code>array</code> ⏏
     * [module.exports#add_ok_button(col_model, fields)](#exp_module_Jqgrid_utils--module.exports+add_ok_button) ⇒ <code>array</code> ⏏
     * [module.exports#get_filled_cell_table_data(_grid, fields)](#exp_module_Jqgrid_utils--module.exports+get_filled_cell_table_data) ⇒ <code>array</code> ⏏
@@ -59,6 +60,7 @@ A module for Jqgrid_utils
     * [module.exports#s_hide_del_icon()](#exp_module_Jqgrid_utils--module.exports+s_hide_del_icon) ⏏
     * [module.exports#hide_del_icon()](#exp_module_Jqgrid_utils--module.exports+hide_del_icon) ⏏
     * [module.exports#add_link_details_csv(col_model, url, edit_field, attr, keys, format, seperator)](#exp_module_Jqgrid_utils--module.exports+add_link_details_csv) ⏏
+    * [module.exports#compare(obj, column1, column2, style)](#exp_module_Jqgrid_utils--module.exports+compare) ⏏
     * [module.exports#set_styles(obj, style_column)](#exp_module_Jqgrid_utils--module.exports+set_styles) ⏏
     * [module.exports#add_link_details(col_model, url, edit_field, attr, keys)](#exp_module_Jqgrid_utils--module.exports+add_link_details) ⏏
     * [module.exports#add_link_details_separator(col_model, url, edit_field, attr, keys)](#exp_module_Jqgrid_utils--module.exports+add_link_details_separator) ⏏
@@ -301,6 +303,24 @@ Add Formatter
 var jqu = new Jqgrid_utils();
 col_model = await jqu.add_formatter(col_model,'select',{ formatter: "select", formatoptions: {value: "1:ok;0:fail", defaultValue: "1" }})
 ```
+<a name="exp_module_Jqgrid_utils--module.exports+natural_sort"></a>
+
+### module.exports#natural\_sort(col_model, column_name) ⇒ <code>array</code> ⏏
+Natural Sort Column
+
+**Kind**: Exported function  
+**Returns**: <code>array</code> - - col_model  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| col_model | <code>array</code> | grid col_model |
+| column_name | <code>string</code> | string columns names for natural sorting |
+
+**Example**  
+```js
+var jqu = new Jqgrid_utils();
+col_model = await jqu.natural_sort(col_model,'colunmename');
+```
 <a name="exp_module_Jqgrid_utils--module.exports+add_html_formatter"></a>
 
 ### module.exports#add\_html\_formatter(col_model, edit_field, html) ⇒ <code>array</code> ⏏
@@ -702,6 +722,28 @@ Convert a cell into a link/url with data from another cell and spit the value by
 var jqu = new Jqgrid_utils();
 col_model = await jqu.add_link_details_csv(col_model, host + '/html/report.html' , 'tags','target="_blank"',{"tags":"tags"},',');
 ```
+<a name="exp_module_Jqgrid_utils--module.exports+compare"></a>
+
+### module.exports#compare(obj, column1, column2, style) ⏏
+Compare 2 columns and give them a style class  when they have different content
+http://www.trirand.com/jqgridwiki/doku.php?id=wiki:methods
+
+**Kind**: Exported function  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| obj | <code>object</code> | grid object |
+| column1 | <code>string</code> | first column |
+| column2 | <code>string</code> | second column |
+| style | <code>string</code> | css class name |
+
+**Example**  
+```js
+loadComplete: async function()
+{
+  await jqu.compare(this,'value','value_report','greenlight');
+  }
+```
 <a name="exp_module_Jqgrid_utils--module.exports+set_styles"></a>
 
 ### module.exports#set\_styles(obj, style_column) ⏏

package/dist/jqgrid_utils.js

@@ -507,6 +507,73 @@ col_model = await jqu.add_formatter(col_model,'select',{ formatter: "select", fo
   return col_model;
 }
 
+/**
+* Natural Sort Column
+@alias module:Jqgrid_utils
+@param {array}  - grid col_model
+@param {string} - string columns names for natural sorting
+@returns {array} - col_model
+@example
+var jqu = new Jqgrid_utils();
+col_model = await jqu.natural_sort(col_model,'colunmename');
+*/
+
+async natural_sort(col_model, column_name)
+{
+  for(let i=0;i< col_model.length;i++)
+  {
+    if(col_model[i]['name'] === column_name)
+    {
+
+        col_model[i]['sortfunc'] = function (a, b, d) {
+            
+    if(d===undefined) { d=1; }  
+    var re = /(^-?[0-9]+(\.?[0-9]*)[df]?e?[0-9]?$|^0x[0-9a-f]+$|[0-9]+)/gi,  
+        sre = /(^[ ]*|[ ]*$)/g,  
+        dre = /(^([\w ]+,?[\w ]+)?[\w ]+,?[\w ]+\d+:\d+(:\d+)?[\w ]?|^\d{1,4}[\/\-]\d{1,4}[\/\-]\d{1,4}|^\w+, \w+ \d+, \d{4})/,  
+        hre = /^0x[0-9a-f]+$/i,  
+        ore = /^0/,  
+        i = function(s) { return self.insensitive && (''+s).toLowerCase() || ''+s },  
+        // convert all to strings strip whitespace  
+        x = i(a).replace(sre, '') || '',  
+        y = i(b).replace(sre, '') || '',  
+        // chunk/tokenize  
+        xN = x.replace(re, '\0$1\0').replace(/\0$/,'').replace(/^\0/,'').split('\0'),  
+        yN = y.replace(re, '\0$1\0').replace(/\0$/,'').replace(/^\0/,'').split('\0'),  
+        // numeric, hex or date detection  
+        xD = parseInt(x.match(hre)) || (xN.length != 1 && x.match(dre) && Date.parse(x)),  
+        yD = parseInt(y.match(hre)) || xD && y.match(dre) && Date.parse(y) || null,  
+        oFxNcL, oFyNcL;  
+    // first try and sort Hex codes or Dates  
+    if (yD)  
+        if ( xD < yD ) return -d;  
+        else if ( xD > yD ) return d;  
+    // natural sorting through split numeric strings and default strings  
+    for(var cLoc=0, numS=Math.max(xN.length, yN.length); cLoc < numS; cLoc++) {  
+        // find floats not starting with '0', string or 0 if not defined (Clint Priest)  
+        oFxNcL = !(xN[cLoc] || '').match(ore) && parseFloat(xN[cLoc]) || xN[cLoc] || 0;  
+        oFyNcL = !(yN[cLoc] || '').match(ore) && parseFloat(yN[cLoc]) || yN[cLoc] || 0;  
+        // handle numeric vs string comparison - number < string - (Kyle Adams)  
+        if (isNaN(oFxNcL) !== isNaN(oFyNcL)) { return (isNaN(oFxNcL)) ? d : -d; }  
+        // rely on string comparison if different types - i.e. '02' < 2 != '02' < '2'  
+        else if (typeof oFxNcL !== typeof oFyNcL) {  
+            oFxNcL += '';  
+            oFyNcL += '';  
+        }  
+        if (oFxNcL < oFyNcL) return -d;  
+        if (oFxNcL > oFyNcL) return d;  
+    }  
+    return 0;   
+      };
+
+
+        
+    }
+  }
+  return col_model;
+}
+
+
     
 /**
 * Add HTML Formatter 

package/jqgrid_utils.js

@@ -506,6 +506,73 @@ col_model = await jqu.add_formatter(col_model,'select',{ formatter: "select", fo
   return col_model;
 }
 
+/**
+* Natural Sort Column
+@alias module:Jqgrid_utils
+@param {array}  - grid col_model
+@param {string} - string columns names for natural sorting
+@returns {array} - col_model
+@example
+var jqu = new Jqgrid_utils();
+col_model = await jqu.natural_sort(col_model,'colunmename');
+*/
+
+async natural_sort(col_model, column_name)
+{
+  for(let i=0;i< col_model.length;i++)
+  {
+    if(col_model[i]['name'] === column_name)
+    {
+
+        col_model[i]['sortfunc'] = function (a, b, d) {
+            
+    if(d===undefined) { d=1; }  
+    var re = /(^-?[0-9]+(\.?[0-9]*)[df]?e?[0-9]?$|^0x[0-9a-f]+$|[0-9]+)/gi,  
+        sre = /(^[ ]*|[ ]*$)/g,  
+        dre = /(^([\w ]+,?[\w ]+)?[\w ]+,?[\w ]+\d+:\d+(:\d+)?[\w ]?|^\d{1,4}[\/\-]\d{1,4}[\/\-]\d{1,4}|^\w+, \w+ \d+, \d{4})/,  
+        hre = /^0x[0-9a-f]+$/i,  
+        ore = /^0/,  
+        i = function(s) { return self.insensitive && (''+s).toLowerCase() || ''+s },  
+        // convert all to strings strip whitespace  
+        x = i(a).replace(sre, '') || '',  
+        y = i(b).replace(sre, '') || '',  
+        // chunk/tokenize  
+        xN = x.replace(re, '\0$1\0').replace(/\0$/,'').replace(/^\0/,'').split('\0'),  
+        yN = y.replace(re, '\0$1\0').replace(/\0$/,'').replace(/^\0/,'').split('\0'),  
+        // numeric, hex or date detection  
+        xD = parseInt(x.match(hre)) || (xN.length != 1 && x.match(dre) && Date.parse(x)),  
+        yD = parseInt(y.match(hre)) || xD && y.match(dre) && Date.parse(y) || null,  
+        oFxNcL, oFyNcL;  
+    // first try and sort Hex codes or Dates  
+    if (yD)  
+        if ( xD < yD ) return -d;  
+        else if ( xD > yD ) return d;  
+    // natural sorting through split numeric strings and default strings  
+    for(var cLoc=0, numS=Math.max(xN.length, yN.length); cLoc < numS; cLoc++) {  
+        // find floats not starting with '0', string or 0 if not defined (Clint Priest)  
+        oFxNcL = !(xN[cLoc] || '').match(ore) && parseFloat(xN[cLoc]) || xN[cLoc] || 0;  
+        oFyNcL = !(yN[cLoc] || '').match(ore) && parseFloat(yN[cLoc]) || yN[cLoc] || 0;  
+        // handle numeric vs string comparison - number < string - (Kyle Adams)  
+        if (isNaN(oFxNcL) !== isNaN(oFyNcL)) { return (isNaN(oFxNcL)) ? d : -d; }  
+        // rely on string comparison if different types - i.e. '02' < 2 != '02' < '2'  
+        else if (typeof oFxNcL !== typeof oFyNcL) {  
+            oFxNcL += '';  
+            oFyNcL += '';  
+        }  
+        if (oFxNcL < oFyNcL) return -d;  
+        if (oFxNcL > oFyNcL) return d;  
+    }  
+    return 0;   
+      };
+
+
+        
+    }
+  }
+  return col_model;
+}
+
+
     
 /**
 * Add HTML Formatter 

package/package.json

@@ -29,5 +29,5 @@
   {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
-  "version": "1.28.0"
+  "version": "1.30.0"
 }