neo.mjs 5.3.16 → 5.4.0

package/apps/ServiceWorker.mjs

@@ -20,9 +20,9 @@ class ServiceWorker extends ServiceBase {
          */
         singleton: true,
         /**
-         * @member {String} version='5.3.16'
+         * @member {String} version='5.4.0'
          */
-        version: '5.3.16'
+        version: '5.4.0'
     }
 
     /**

package/apps/form/view/pages/Page9.mjs

@@ -1,5 +1,6 @@
 import FormPageContainer from '../FormPageContainer.mjs';
-import TextField         from '../../../../src/form/field/Text.mjs';
+import HiddenField       from '../../../../src/form/field/Hidden.mjs';
+import Label             from '../../../../src/component/Label.mjs';
 
 /**
  * @class Form.view.pages.Page9
@@ -12,18 +13,24 @@ class Page9 extends FormPageContainer {
          * @protected
          */
         className: 'Form.view.pages.Page9',
+        /**
+         * @member {String} formGroup='page9'
+         */
+        formGroup: 'page9',
         /**
          * @member {Object[]} items
          */
         items: [{
-            module   : TextField,
-            labelText: 'Page 9 Field 1',
-            name     : 'page9field1',
-            required : true
+            module: Label,
+            text  : 'Hidden fields will not get mounted. Inspect the DOM.'
+        }, {
+            module: HiddenField,
+            name  : 'field1',
+            value : 'foo'
         }, {
-            module   : TextField,
-            labelText: 'Page 9 Field 2',
-            name     : 'page9field2'
+            module: HiddenField,
+            name  : 'field2',
+            value : 'bar'
         }]
     }
 }

package/examples/ServiceWorker.mjs

@@ -20,9 +20,9 @@ class ServiceWorker extends ServiceBase {
          */
         singleton: true,
         /**
-         * @member {String} version='5.3.16'
+         * @member {String} version='5.4.0'
          */
-        version: '5.3.16'
+        version: '5.4.0'
     }
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "neo.mjs",
-    "version": "5.3.16",
+    "version": "5.4.0",
     "description": "The webworkers driven UI framework",
     "type": "module",
     "repository": {
@@ -56,8 +56,8 @@
         "neo-jsdoc": "^1.0.1",
         "neo-jsdoc-x": "^1.0.5",
         "postcss": "^8.4.21",
-        "sass": "^1.60.0",
-        "webpack": "^5.77.0",
+        "sass": "^1.61.0",
+        "webpack": "^5.78.0",
         "webpack-cli": "^5.0.1",
         "webpack-dev-server": "4.13.2",
         "webpack-hook-plugin": "^1.0.7",

package/resources/examples/data/formSideNav.json

@@ -13,7 +13,7 @@
         {"id":  9, "cardIndex":    6, "isHeader": false, "isValid": null, "name": "Fieldsets"},
         {"id": 10, "cardIndex": null, "isHeader": true,  "isValid": null, "name": "3. More data"},
         {"id": 11, "cardIndex":    7, "isHeader": false, "isValid": null, "name": "NumberFields"},
-        {"id": 12, "cardIndex":    8, "isHeader": false, "isValid": null, "name": "Page 9"},
+        {"id": 12, "cardIndex":    8, "isHeader": false, "isValid": null, "name": "HiddenFields"},
         {"id": 13, "cardIndex":    9, "isHeader": false, "isValid": null, "name": "Page 10"},
         {"id": 14, "cardIndex": null, "isHeader": true,  "isValid": null, "name": "3. Optional data"},
         {"id": 15, "cardIndex":   10, "isHeader": false, "isValid": null, "name": "Page 11"},

package/src/DefaultConfig.mjs

@@ -237,12 +237,12 @@ const DefaultConfig = {
     useVdomWorker: true,
     /**
      * buildScripts/injectPackageVersion.mjs will update this value
-     * @default '5.3.16'
+     * @default '5.4.0'
      * @memberOf! module:Neo
      * @name config.version
      * @type String
      */
-    version: '5.3.16'
+    version: '5.4.0'
 };
 
 Object.assign(DefaultConfig, {

package/src/form/Fieldset.mjs

@@ -1,12 +1,12 @@
-import Container from '../container/Base.mjs';
-import Legend    from '../component/Legend.mjs';
-import NeoArray  from '../util/Array.mjs';
+import FormContainer from '../form/Container.mjs';
+import Legend        from '../component/Legend.mjs';
+import NeoArray      from '../util/Array.mjs';
 
 /**
  * @class Neo.form.Fieldset
- * @extends Neo.container.Base
+ * @extends Neo.form.Container
  */
-class Fieldset extends Container {
+class Fieldset extends FormContainer {
     static config = {
         /**
          * @member {String} className='Neo.form.Fieldset'
@@ -67,9 +67,9 @@ class Fieldset extends Container {
          */
         title_: '',
         /**
-         * @member {Object} _vdom={tag:'fieldset',cn:[]}
+         * @member {Object} vdom={tag:'fieldset',cn:[]}
          */
-        _vdom:
+        vdom:
         {tag: 'fieldset', cn: []}
     }
 

package/src/form/field/Hidden.mjs

@@ -0,0 +1,28 @@
+import Base from './Base.mjs';
+
+/**
+ * @class Neo.form.field.Hidden
+ * @extends Neo.form.field.Base
+ */
+class Hidden extends Base {
+    static config = {
+        /**
+         * @member {String} className='Neo.form.field.Hidden'
+         * @protected
+         */
+        className: 'Neo.form.field.Hidden',
+        /**
+         * @member {String} ntype='hiddenfield'
+         * @protected
+         */
+        ntype: 'hiddenfield',
+        /**
+         * @member {Boolean} hidden=true
+         */
+        hidden: true
+    }
+}
+
+Neo.applyClassConfig(Hidden);
+
+export default Hidden;

package/src/form/field/Number.mjs

@@ -32,6 +32,20 @@ class Number extends Text {
          * @member {String[]} baseCls=['neo-numberfield','neo-textfield']
          */
         baseCls: ['neo-numberfield', 'neo-textfield'],
+        /**
+         * data passes maxLength, minLength & valueLength properties
+         * @member {Function} errorTextMaxValue=data=>`Max value violation: ${data.value} / ${data.maxValue}`
+         */
+        errorTextMaxValue: data => `Max value violation: ${data.value} / ${data.maxValue}`,
+        /**
+         * data passes maxLength, minLength & valueLength properties
+         * @member {Function} errorTextMinValue=data=>`Min value violation: ${data.value} / ${data.minValue}`
+         */
+        errorTextMinValue: data => `Min value violation: ${data.value} / ${data.minValue}`,
+        /**
+         * @member {String} errorTextStepSize='Required'
+         */
+        errorTextStepSize: data => `step-size violation: ${data.value} / ${data.stepSize}`,
         /**
          * @member {Number[]|null} excluded=null
          */
@@ -322,6 +336,47 @@ class Number extends Text {
 
         me.triggers = triggers;
     }
+
+    /**
+     * Checks for client-side field errors
+     * @param {Boolean} silent=true
+     * @returns {Boolean} Returns true in case there are no client-side errors
+     */
+    validate(silent=true) {
+        let me          = this,
+            errorField  = silent ? '_error' : 'error',
+            value       = me.value,
+            isNumber    = Neo.isNumber(value),
+            maxValue    = me.maxValue,
+            minValue    = me.minValue,
+            stepSize    = me.stepSize,
+            returnValue = true,
+            errorParam  = {maxValue, minValue, stepSize, value};
+
+        if (!silent) {
+            // in case we manually call validate(false) on a form or field before it is mounted, we do want to see errors.
+            me.clean = false;
+        }
+
+        if (Neo.isNumber(maxValue) && isNumber && value > maxValue) {
+            me[errorField] = me.errorTextMaxValue(errorParam);
+            returnValue = false;
+        } else if (Neo.isNumber(minValue) && isNumber && value < minValue) {
+            me[errorField] = me.errorTextMinValue(errorParam);
+            returnValue = false;
+        } else if (value % me.stepSize !== 0) {
+            me[errorField] = me.errorTextStepSize(errorParam);
+            returnValue = false;
+        }
+
+        if (returnValue) {
+            me[errorField] = null;
+        }
+
+        !me.clean && me.updateError(me[errorField], silent);
+
+        return !returnValue ? false : super.validate(silent);
+    }
 }
 
 Neo.applyClassConfig(Number);