Spry User Guide - Support - Adobe

--Please select an item--
Item 1
. . .
Please select an item.
In the preceding CSS code, the state rule with the contextual selector .selectRequiredState . selectRequiredMsg
overrides the default error-message rule responsible for hiding the error-message text. Thus, when Spry
applies the state class to the widget container, the state rule determines the appearance of the widget, and displays
the error message inline in red with a 1-pixel solid border.
Following is a list of default error-message classes and their descriptions. You can change these classes and rename
them. If you do so, don’t forget to change them in the contextual selector also.
Error message class Description
.selectRequiredMsg Causes error message to display when the widget enters
the required state
.selectInvalidMsg Causes error message to display when the widget enters
the invalid state
Note: You cannot rename state-related class names because they are hard-coded as part of the Spry framework.
Specify when validation occurs
By default, the Validation Select widget validates when the user clicks the submit button. You can, however, set two
other options: blur or change. The validateOn:["blur"] parameter causes the widget to validate whenever the
user clicks outside the select list. The validateOn:["change"] parameter causes the widget to validate as the user
makes selections.
❖ To specify when validation occurs, add a validateOn parameter to the constructor as follows:
var spryselect1 = new Spry.Widget.ValidationSelect("spryselect1",
{validateOn:["blur"]});
As a convenience, you can discard the brackets if your validateOn parameter contains a single value (for example,
validateOn: "blur"). If the parameter contains both values, however (validateOn:["blur", "change"]),
include brackets in the syntax.
Change required status of a select list
By default, Validation Select widgets require the user to make a selection before submitting the form. You can,
however, make selections optional for the user.
❖ To change the required status of a select list, add the isRequired property to the constructor and set its value to
false, as follows:
var selectwidget1 = new Spry.Widget.ValidationSelect("selectwidget1",
{isRequired:false});
SPRY
User Guide
81