{dialog.object}clientSideValidateField Method


{dialog.object}.clientSideValidateField(colName [, rowNum [, instNum]]);



The name of the UX control to validate.


Default = 1. The row number. In a UX Component, the row number is always '1'. Always pass in a value of 1 when calling this method in a UX.


Default = 0. The Repeating Section instance number for the control. This argument is required if the control is in a Repeating Section.



If there are no errors, returns a blank string. If there are errors, returns the error message.


Executes client-side validation for a control in the UX Component.


The {dialog.object}.clientSideValidateField() method executes client-side validation rules for a control in the UX Component. This method can be used to evaluate the client-side rules on demand using JavaScript. For example:

var controlsToValidate = ['TXT1','TXT2','TXT3'];
var flagHasError = false;
var result = '';

for(var i = 0; i < controlsToValidate.length; i++) { 
    result = {dialog.object}.clientSideValidateField(controlsToValidate[i]);
    if(result != '') { flagHasError = true; }

if(!flagHasError) {dialog.object}.panelSetActive('PANELCARD_2');

To learn more, watch the video below.

Executing Client-side Validation Rules Programmatically

When you define validation rules for controls in a UX component, the rule are evaluated when the data is submitted. There are instances where you need to evaluate the validation rules for a set of controls on demand. For example, before navigating to a new Panel Card.

This video demonstrates how to use the {dialog.object}.clientSideValidateField() method to execute client-side validation rules for a set of text boxes when the user tries to navigate to a new Panel Card.

Download Component