Recipe 11.18 Validating a Multipage Form

11.18.1 Problem

You want to validate elements within a multipage form.

11.18.2 Solution

Create and invoke a validate( ) method for the custom MultiPageForm class.

11.18.3 Discussion

You can create a MultiPageForm.validate( ) method that leverages the Form.validate( ) method and works in much the same way. Add the following code to your Form.as file for easy inclusion in other projects:

MultiPageForm.prototype.validate = function (  ) {
  var vRes;

  // Loop through all the form pages.
  for (var i = 0; i < this.forms.length; i++) {

    // Call the validate(  ) method for each page of the form. If validate(  ) returns 
    // something other than true, some form element didn't validate. In that case,
    // display that page of the form and return the name of the offending element.
    vRes = this.forms[i].validate(  );
    if (!vRes) {
      this.setPage(i + 1);
      return vRes;
    }
  }
  return true;
};

You can use the validate( ) method for multipage forms as you did for single-page forms:

submitBtn_pb.onRelease = function (  ) {
  // Call the validate(  ) method of the multipage form.
  var valid = _root.myMultiForm.validate(  );
 
  // If the form validates, submit the form. Otherwise, display the name of the form
  // element that needs to be corrected. If an element fails to validate, the
  // multipage form automatically displays the page with the problem.
  if (valid) {
    // Submit form
  } else {
    trace(valid);
  }
};

11.18.4 See Also

Recipe 11.14 and Recipe 11.15