Move To Next Page
Definition:
NDLLibrary.moveToNextPage(ndlParams)
Description:
Checks data validation for all Elements on the currently displayed page and if no errors found moves to the next page in the form.
Parameters:
Returns:
nothing
Code Sample 1:
This example shows the JavaScript statement which will appear in the JavaScript function generated from an Element's Event property where Move to next page is assigned to the Event:
return NDLLibrary.moveToNextPage(ndlParams);
Code Sample 2:
This example shows how to include a call to moveToNextPage in your own JavaScript function, which isn't generated from an Element's event property. In this case you will need to create an ndlParams object to pass to moveToNextPage. Note in the code sample below that you only need to include hash and form properties in your custom ndlParams; moveToNextPage doesn't use the other properties found in the default ndlParams object and so these properties are not added here:
var ndlParams = {
"hash": window.location.hash,
"form": form1,
};
return NDLLibrary.moveToNextPage(ndlParams);
Notes:
This function will check the validity of all input data for all Elements on the current page which have data validation criteria specified, if any. If any errors are found, the form will remain on the current page and will display validation errors if these have been specified in the properties for the Elements which failed data validation.
The function will also check that all previous pages in the form's page sequence are valid. A page is valid if all Elements on the page which have one or more validation rules specified have been completed satisfactorily by the user or the page has no validations set. If the current page and all previous pages are valid, the form will move forward to the next page in the sequence.
This behaviour is not affected by the value of the Nonsequential property found in the page properties of each page. However, if you have set the Nonsequential property to True, i.e. you have marked a page as being nonsequential and hence able to be accessed out of sequence, we recommend that you don't use Move to Next Page on that page. If you want to move forward, use Move To Page instead.
Using as Predefined Action in Event:
When assigned to an Event as a predefined action, this function doesn’t require any editing.
See also: