Text ...
\"\n }]\n }]\n },\n {\n \"key\": \"tab2\",\n \"name\": \"Tab 2\",\n \"displayName\": \"Tab 2\",\n \"flex\": \"100\",\n \"rows\": [{\n \"name\": \"Row 2\",\n \"title\": \"This section shows some skip logic and functional input\",\n \"layout\": \"row\",\n \"fields\": [{\n \"type\": \"inputNumber\",\n \"flex\": \"30\",\n \"name\": \"weight\",\n \"title\": \"What is your weight? (kg)\",\n \"settings\": {\n \"valueType\": \"valueDecimal\",\n \"required\": true\n },\n \"value\": null\n }, {\n \"type\": \"inputNumber\",\n \"flex\": \"30\",\n \"name\": \"height\",\n \"title\": \"What is your height? (cm)\",\n \"settings\": {\n \"valueType\": \"valueInteger\",\n \"required\": true\n },\n \"value\": null\n }, {\n \"type\": \"inputNumber\",\n \"flex\": \"30\",\n \"name\": \"bmi\",\n \"title\": \"BMI\",\n \"settings\": {\n \"valueType\": \"valueDecimal\",\n \"disabled\": true\n },\n \"skipLogic\": {\n \"func\": {\n \"execute\": \"calculateBMI\",\n \"params\": [\"weight\", \"height\"],\n \"watchingVars\": [\"weight\", \"height\"]\n },\n \"checks\": [{\n \"variable\": \"form.bmi.$modelValue\",\n \"operand\": \">\",\n \"value\": 0\n }]\n },\n \"value\": null\n }]\n }]\n }\n]\n```\n\n### Skip Logic\n\nFormBuilder allows you to add skip logic and functional support to field to enhance its capabilities. Below is a skip logic setting that checks for a field called \"bmi\" and shows the field if the value is bigger than 0\n```\n\"skipLogic\": {\n \"checks\": [{\n \"variable\": \"form.bmi.$modelValue\", // variable to check, can be a FormBuilder global variable as well (e.g. global.gender)\n \"operand\": \">\", // operand to perform ( \"=\", \"!=\", \"<\", \"<=\", \">\", \">=\", \"in\", \"!in\", \"contains\", \"!contains\" )\n // 'in' check if the variable is in the value whereas 'contains' checks the inverse. I.e. if the value is in the variable.\n \"value\": 0 // value that needs to checked for.\n \"action\": \"showhide\" // action to perform on the field (\"disabled\", \"required\", \"showhide\")\n }]\n}\n```\n\nTo evaluate grouped checks such as to deal with logic gates (\"or\", \"and\"), use something like;\n```\n\"skipLogic\": {\n \"checks\": [{\n \"logicGate\": \"and\", // logic evaluation creterial to check group items against (\"or\", \"and\")\n \"action\": \"showhide\", // action to perform on the field (\"disabled\", \"required\", \"showhide\")\n \"group\": [{\n \"variable\": \"form.age.$modelValue\", // variable to check, can be a FormBuilder global variable as well (e.g. global.gender)\n \"operand\": \">=\", // operand to perform ( \"=\", \"!=\", \"<\", \"<=\", \">\", \">=\", \"in\", \"!in\", \"contains\", \"!contains\" )\n \"value\": 15 // value that needs to checked for.\n },{\n \"variable\": \"form.gender.$modelValue\", // variable to check, can be a FormBuilder global variable as well (e.g. global.gender)\n \"operand\": \"=\", // operand to perform ( \"=\", \"!=\", \"<\", \"<=\", \">\", \">=\", \"in\", \"!in\", \"contains\", \"!contains\" )\n \"value\": \"M\" // value that needs to checked for.\n }]\n }]\n}\n```\n\nBelow is a skip logic function checks that will execute a function called \"calculateBMI\" when both the \"weight\" and \"height\" fields have values. for a field called \"bmi\" and shows the field if the value is bigger than 0\n```\n\"skipLogic\": {\n \"func\": {\n \"execute\": \"placeholderForCalculateBMI\", // function to execute. !NB this must be a function attached to this property to execute successfully. The function gets executed within FormBuilder and supplies one argument to your function which will hold all the parameters and their values supplied in the \"params\" property. E.g [\"weight\", \"height\"]\n \"params\": [\"weight\", \"height\"], // params to send to the function\n \"watchingVars\": [\"weight\", \"height\"] // watch these variables and execute function with supplied params fields\n }\n}\n```\n\nThe calculateBMI function looks like the below function. This function needs to be assigned to the 'execute' property to run successfully\n```\nvar calculateBMI = function (params) {\n if (params.weight && params.height) {\n var bmi = params.weight / (params.height / 100 * params.height / 100)\n return bmi.toFixed(2)\n }\n}\n```\n\n### Asynchronous validation\n\nFormBuilder allows you to add asynchronous validation to fields. It is possible to have more than one custom asynchronous validation for each field. The validation is configured by adding a \"validation\" property to a field as illustrated in the example below. The validation field contains an array of objects containing the following properties:\n - key: a validation error code\n - message: an error message to display below the field\n - execute: a custom function to perform asynchronous validation. The function should have a single argument representing the value entered in the field and return a Promise which should resolve when there is no error, or reject in case of error.\n\nThe submit button is disabled and its label changes to 'validating ...' while the validation is in progress.\n\n```js\n{ \n \"type\": \"inputID\",\n \"flex\": \"80\", // the flex width of the input\n \"name\": \"IDNumber\", // A name which will be used to reference the value of this field in the form\n \"title\": \"ID Number\", // A label that will be displayed above the field\n \"validation\": [\n {\n \"key\": \"unique_id\", // a custom validation error code\n \"message\" : \"The id must be unique\", // an error message to display below the field\n \"execute\" : \"placeHolderForVerifyIDUniqueness\" // a custom function to perform asynchronous validation\n }\n ]\n}\n```\n\n## Input field reference (work in progress)\n\n### inputNumber\n\n```js\n{\n \"type\": \"inputNumber\",\n \"flex\": \"30\", // the flex width of the input\n \"name\": \"height\", // A name which will be used to reference the value of this field in the form\n \"title\": \"What is your height? (cm)\", // A label that will be displayed above the field\n \"settings\": {\n \"valueType\": \"valueInteger\",\n \"required\": true // (optional) whether this field is required or not\n \"min\": \"1\", // (optional) The minimum number this control accepts\n \"max\": \"250\", // (optional) The maximum number this control accepts\n \"step\": \"0.01\", // (optional) The step size in whcih the value be increased by the spinner, this also determines the allowable decimal points\n \"disableSpinner\": true // (optional) If the number spinner button should be hidden or not\n },\n \"value\": null // the initial value of this field\n}\n```\n\n### time\n\n```js\n{\n \"type\": \"time\",\n \"flex\": \"30\", // the flex width of the input\n \"name\": \"startTime\", // A name which will be used to reference the value of this field in the form\n \"title\": \"When did the procedure start? (HH:MM)\", // A label that will be displayed above the field\n \"settings\": {\n \"valueType\": \"valueString\",\n \"required\": true // (optional) whether this field is required or not\n },\n \"value\": null // the initial value of this field\n}\n```\n\n### popupLink\n\n```js\n{\n \"type\": \"popupLink\",\n \"flex\": \"30\", // the flex width of the input\n \"name\": \"popupLink\", // A name which will be used to reference the value of this field in the form\n \"title\": \"Terms and Conditions\", // The title of the popup dialog\n \"value\": \"Terms and ConditionsText ...
\" // the content of the popup dialog\n}\n```\n\n### fileInput (Currently only PDFs are supported)\n\n```js\n{\n \"type\": \"fileInput\",\n \"flex\": \"100\", // the flex width of the input\n \"name\": \"patientPdf\", // A name which will be used to reference the value of this field in the form\n \"title\": \"Patients PDF\", // The title of the file input control\n \"settings\": {\n \"filePreview\": true // (optional) whether to display the preview of the file or not\n },\n \"value\": null\n}\n```\n","maintainers":[{"email":"brett@ausmeier.co.za","name":"bausmeier"},{"email":"martin.brocker@jembi.org","name":"bmartinos"},{"email":"kaweesi@jembi.org","name":"k-joseph"},{"email":"sifubalazola@gmail.com","name":"lazola"},{"email":"rg.crichton@gmail.com","name":"rcrichton"},{"email":"tresor.mvumbi@jembi.org","name":"tmvumbi"}],"time":{"modified":"2022-06-19T17:12:07.673Z","created":"2016-10-28T09:02:25.685Z","0.0.1":"2016-10-28T09:02:25.685Z","0.0.2":"2016-10-28T11:27:00.294Z","0.0.5":"2016-10-28T12:35:06.419Z","0.0.6":"2016-10-31T12:19:08.565Z","0.0.7":"2016-11-01T07:06:38.245Z","0.0.8":"2016-11-01T07:08:05.653Z","0.0.9":"2016-11-01T07:18:21.817Z","0.0.10":"2016-11-01T07:22:26.193Z","0.1.0":"2016-11-01T08:37:25.344Z","0.1.1":"2016-11-01T08:42:13.255Z","0.2.0":"2016-11-11T06:13:49.739Z","0.2.1":"2016-11-11T06:23:34.615Z","0.2.2":"2016-11-11T06:33:32.267Z","0.2.3":"2016-11-11T06:38:10.219Z","0.2.4":"2016-11-11T06:39:44.429Z","0.2.5":"2016-11-11T08:36:46.594Z","0.2.6":"2016-11-11T08:44:11.858Z","0.2.7":"2016-11-11T08:53:24.637Z","0.2.8":"2016-11-11T09:16:04.545Z","0.2.9":"2016-11-11T09:56:16.156Z","0.2.10":"2016-11-22T10:02:12.006Z","0.3.0":"2016-11-23T13:18:30.405Z","0.4.0":"2016-11-29T14:38:31.576Z","0.4.1":"2016-11-30T08:12:38.470Z","0.5.0":"2016-12-07T15:15:35.128Z","0.5.1":"2017-02-20T09:05:42.738Z","0.5.2":"2017-02-20T10:44:20.232Z","0.5.3":"2017-02-21T14:48:36.410Z","0.5.4":"2017-06-09T09:47:44.353Z","0.5.5":"2017-07-06T12:34:15.320Z","0.5.6":"2017-07-24T08:57:50.507Z","0.6.0":"2017-09-11T08:22:27.143Z","0.6.1":"2017-09-14T11:32:44.492Z","0.6.2":"2017-09-15T07:06:26.535Z","0.6.3":"2017-09-20T11:51:38.088Z","0.6.4":"2017-09-29T09:54:46.555Z","0.7.0":"2017-10-03T06:11:19.441Z","0.7.1":"2017-10-04T09:05:26.094Z","0.8.0":"2017-10-05T08:06:18.382Z","0.9.0":"2017-10-05T09:17:24.425Z","0.9.1":"2017-10-06T13:08:10.527Z","0.9.2":"2017-10-09T12:18:24.848Z","0.9.3":"2017-10-09T12:55:33.491Z","0.9.4":"2017-10-10T10:18:19.790Z","0.9.5":"2017-10-10T11:58:52.066Z","0.9.6":"2017-10-11T08:58:50.597Z","0.9.7":"2017-10-19T11:37:04.475Z","0.10.0":"2017-10-19T11:51:26.301Z","0.10.1":"2017-10-20T08:27:07.861Z","0.10.2":"2017-10-20T08:46:28.849Z","0.10.3":"2017-10-23T07:24:27.505Z","0.10.4":"2017-10-24T14:59:09.733Z","0.11.0":"2017-10-30T09:14:35.001Z","0.11.1":"2017-11-01T08:17:40.051Z","0.12.0":"2017-11-06T06:59:19.280Z","0.13.0":"2017-11-06T14:28:28.306Z","0.13.1":"2017-11-13T09:16:14.251Z","0.13.2":"2017-11-22T12:36:34.458Z","0.13.3":"2017-11-29T08:20:49.894Z","0.14.0":"2017-12-18T11:23:32.095Z","0.14.1":"2017-12-19T12:45:07.167Z","0.14.2":"2018-04-16T07:13:48.557Z","0.14.3":"2018-04-23T14:12:18.476Z","0.14.4":"2018-04-25T10:17:59.868Z","0.14.5":"2018-04-25T13:38:33.192Z","0.14.6":"2018-04-25T14:02:09.129Z","0.14.7":"2019-06-26T11:43:24.123Z"},"homepage":"https://github.com/jembi/md-form-builder#readme","keywords":["angularjs","material design","forms"],"repository":{"type":"git","url":"git+https://github.com/jembi/md-form-builder.git"},"author":{"name":"Martin Brocker","email":"martin@jembi.org","url":"http://jembi.org"},"bugs":{"url":"https://github.com/jembi/md-form-builder/issues"},"license":"MPL-2.0","readmeFilename":"README.md"}