About the Validation Confirm widget

The Validation Confirm Widget is a text field or a password form field that displays valid or invalid states when a user enters a value that does not match the value of a similar field in the same form. For example, you can add a Validation Confirm widget to a form that requires a user to retype the password they've specified in a previous field. If the user fails to type the password exactly as they've specified it previously, the widget returns an error message stating that the values do not match.

You can also use a Validation Confirm widget in conjunction with a Validation Text Field widget to validate email addresses.

Note: You should be familiar with Spry validation widgets before you work with the Confirm widget. If you’re not familiar with them, see Working with the Validation Text Field widget, or any of the other validation widget overviews before proceeding. This overview does not present all basic validation widget concepts.

The following illustration shows a typical setup for a Confirm widget:

A.
A password field or Spry Password Validation widget

B.
Confirm widget

The Validation Confirm widget includes a number of states (for example, valid, invalid, required, and so on). You can alter the properties of these states by editing the corresponding CSS file (SpryValidationConfirm.css), depending on the desired validation results. A Validation Confirm widget can validate at various points—for example, when the site visitor clicks outside the widget, when they type, or when they try to submit the form.

Initial state
When the page loads in the browser, or when the user resets the form.

Focus state
When the user places the insertion point in the widget.

Valid state
When the user enters information correctly, and the form can be submitted.

Invalid state
When the user enters text that does not match the text entered in a previous text field, Validation Text Field widget, or Validation Password widget.

Required state
When the user fails to enter required text in the text field.

For a more comprehensive explanation of how Validation Confirm widgets work, as well as additional information about widget structure, see www.adobe.com/go/learn_dw_spryconfirm_en.