Insert the validation checkbox widget – Adobe Dreamweaver CS3 User Manual
Page 483
DREAMWEAVER CS3
User Guide
476
A. Validation checkbox widget group, minimum number of selections state B. Validation Checkbox widget, required state
The Validation Checkbox widget includes a number of states (for example, valid, invalid, required value, and so on).
You can alter the properties of these states using the Property inspector, depending on the desired validation results.
A Validation Checkbox widget can validate at various points—for example, when the user clicks outside the widget,
as the user makes selections, or when the user tries to submit the form.
Initial state
The widget state when the page loads in the browser, or when the user resets the form.
Valid state
The widget state when the user has made a selection, or the correct number of selections, and the form
can be submitted.
Required state
The widget state when the user has failed to make a required selection.
Minimum Number Of Selections state
The widget state when the user has selected fewer than the minimum number
of check boxes required.
Maximum Number Of Selections state
The widget state when the user has selected greater than the maximum
number of check boxes allowed.
Whenever a Validation Checkbox widget enters one of these states through user interaction, the Spry framework
logic applies a specific CSS class to the HTML container for the widget at run time. For example, if a user tries to
submit a form, but has made no selections, Spry applies a class to the widget that causes it to display the error
message, “Please make a selection.” The rules that control the style and display states of error messages reside in the
CSS file that accompanies the widget, SpryValidationCheckbox.css.
The default HTML for the Validation Checkbox widget, usually inside of a form, comprises a container tag
that surrounds the tag of the check box. The HTML for the Validation Checkbox widget
also includes script tags in the head of the document and after the widget’s HTML markup.
For a more comprehensive explanation of how the Validation Checkbox widget works, including a full anatomy of
the Validation Checkbox widget’s code, see
.
Insert the Validation Checkbox widget
1
Select Insert > Spry > Spry Validation Checkbox.
2
Complete the Input Tag Accessibility Attributes dialog box and click OK.
Note: You can also insert a Validation Checkbox widget by using the Spry category in the Insert bar.
See also
“Create accessible HTML forms” on page 612
A
B
September 4, 2007