tuain-form-manager 1.1.23 → 1.2.0

package/lib/form.js

@@ -22,6 +22,13 @@ const ROWSELECTION = 'ROWSELECTION';
 const DEFAULT_RECORDS_PAGE = 10;
 const RESTRICTED_ATTRIBUTES = ['actions', 'fields', 'recordTables', 'cookiesToSet', 'immutableData', 'returnedFile'];
 
+const FIELD_ASSIGN_ATTRIBUTES = [
+  'defaultEditable', 'defaultValue', 'alignment', 'required', 'errorCode', 'errorMessage', 'errorType',
+  'tooltip', 'info', 'format', 'intrinsicErrorMessage', 'outputOnly', 'captureType', 'title', 'type',
+  'maxLength', 'maxValue', 'minLength', 'minValue', 'validateOnServer', 'serverAction', 'visibleLabel',
+  'options',
+];
+
 const SESSION_ATTRIBUTES = {
   sessionCode: 'sessionCode',
   profileCode: 'profileCode',
@@ -70,12 +77,12 @@ class Form {
     }
 
     importExchange(requestData, this);
-    this.addActionMethod(START, () => this.start());
-    this.addActionMethod(START_OPERATION, () => this.startOperation());
-    this.addActionMethod(GETDATA, () => this.getData());
-    this.addActionMethod(VALIDATE_FIELD, () => this.executeFieldValidation());
-    this.addActionMethod(TABLE_ACCION, () => this.executeTableAction());
-    this.addActionMethod(TABLE_GET_DATA, () => this.executeTablePopulate());
+    this.onAction(START, () => this.start());
+    this.onAction(START_OPERATION, () => this.startOperation());
+    this.onAction(GETDATA, () => this.getData());
+    this.onAction(VALIDATE_FIELD, () => this.executeFieldValidation());
+    this.onAction(TABLE_ACCION, () => this.executeTableAction());
+    this.onAction(TABLE_GET_DATA, () => this.executeTablePopulate());
   }
 
   // eslint-disable-next-line class-methods-use-this
@@ -189,7 +196,7 @@ class Form {
   hideAction(code) { this.setActionAttribute(code, VISIBLE, false); }
   enableAction(code) { this.setActionAttribute(code, DISABLED, false); }
   disableAction(code) { this.setActionAttribute(code, DISABLED, true); }
-  addActionMethod(code, callback) { this._formActions[code] = callback; }
+  onAction(code, callback) { this._formActions[code] = callback; }
 
   showActions(actionArray) {
     const actionNames = (Array.isArray(actionArray)) ? actionArray : [actionArray];
@@ -236,6 +243,17 @@ class Form {
     return inputField;
   }
 
+  setFieldAttributes(code, attrObj) {
+    const field = this.getField(code);
+    if (field) {
+      Object.entries(attrObj ?? {}).forEach(([attr, value]) => {
+        if (FIELD_ASSIGN_ATTRIBUTES.includes(attr)) {
+          field[attr] = value;
+        }
+      });
+    }
+  }
+
   setFieldAttribute(fieldCode, attr, value) {
     const fieldObject = this.getField(fieldCode);
     if (fieldObject) { fieldObject[attr] = value; }
@@ -251,12 +269,12 @@ class Form {
   getFieldValue(code) { return this.getField(code)?.fieldValue ?? null; }
   demandField(code) { this.setFieldAttribute(code, REQUIRED, true); }
   giveUpField(code) { this.setFieldAttribute(code, REQUIRED, false); }
-  addFieldValidation(code, callback) { this._fieldValidations[code] = callback; }
+  onFieldValidation(code, callback) { this._fieldValidations[code] = callback; }
 
-  addFieldsValidation(fields, callback) {
+  onFieldsValidation(fields, callback) {
     if (!Array.isArray(fields) || fields?.length === 0 || !callback) { return; }
     fields?.forEach((code) => {
-      this.addFieldValidation(code, callback);
+      this.onFieldValidation(code, callback);
     });
   }
 
@@ -333,9 +351,9 @@ class Form {
 
   getTableDefinition(code) { return this._formDefinition?.tables.find(tbl => tbl.tableCode === code) ?? null; }
   getTableConstraints(tableCode) { return this.getTableDefinition(tableCode)?.constraints ?? null; }
-  addTableRowSelection(code, callback) { this.addTableAction(code, ROWSELECTION, callback); }
-  addTablePopulate(code, callback) { this._tablePopulate[code] = callback; }
-  addTableAction(tableCode, actionCode, callback) {
+  onTableRowSelection(code, callback) { this.onTableAction(code, ROWSELECTION, callback); }
+  onTablePopulate(code, callback) { this._tablePopulate[code] = callback; }
+  onTableAction(tableCode, actionCode, callback) {
     if (!this._tableActions[tableCode]) { this._tableActions[tableCode] = {}; }
     this._tableActions[tableCode][actionCode] = callback;
   }
@@ -672,6 +690,36 @@ class Form {
     }
     return errorObject;
   }
+
+  /**
+   * @deprecated Use onAction
+   */
+  addActionMethod(code, callback) { return this.onAction(code, callback); }
+
+  /**
+ * @deprecated Use onFieldValidation
+ */
+  addFieldValidation(code, callback) { return this.onFieldValidation(code, callback); }
+
+  /**
+ * @deprecated Use onFieldsValidation
+ */
+  addFieldsValidation(fields, callback) { return this.onFieldsValidation(fields, callback); }
+
+  /**
+   * @deprecated Use onTableRowSelection
+   */
+  addTableRowSelection(code, callback) { return this.onTableRowSelection(code, callback); }
+
+  /**
+ * @deprecated Use onTablePopulate
+ */
+  addTablePopulate(code, callback) { return this.onTablePopulate(code, callback); }
+
+  /**
+ * @deprecated Use onTableAction
+ */
+  addTableAction(tableCode, actionCode, callback) { return this.onTableAction(tableCode, actionCode, callback); }
 }
 
 module.exports = Form;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tuain-form-manager",
-  "version": "1.1.23",
+  "version": "1.2.0",
   "description": "Component library to perform operations on Tuain Development Framework forms to interchange information on web or mobile applications based on the data interchange of abstract forms making trnasformation on the data upon actions required on both sides (front and back)",
   "main": "index.js",
   "scripts": {