Spry User Guide - Support - Adobe

var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1",
"validation_type", {minChars:value, maxChars:value});
Note: If a validation type is not required, you can set the validation type to "none".See“Specifyavalidationtypeand
format” on page 50.
Specify minimum and maximum values
This option is only available for the "integer", "date", "time", "currency", and "real" validation types.
❖ To specify minimum or maximum values in the text field, add the minValue property or maxValue property (or
both) and a value to the constructor, as follows:
var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1",
"validation_type", {minValue:value, maxValue:value});
Change required status of a text field
By default, Validation Text Field widgets require user input when published on a web page. You can, however, make
the completion of text fields optional for the user.
❖ To change the required status of a text field, add the isRequired property to the constructor and set its value to
false, as follows:
var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1", "none",
{isRequired:false});
Note: In the preceding example, the second parameter is set to "none", but it could easily be set to any of the available
validation types (for example, "phone" or "credit_card"). See “Specify a validation type and format” on page 50.
Create a hint for a text field
Because there are so many different kinds of formats for text fields, it is helpful to give your users a hint as to what
format they need to enter. For example, a text field set with the Phone Number validation type accepts phone
numbers in the form (000) 000-0000 by default. You can enter these sample numbers as a hint so that the text field
displays the correct format when the user loads the page in a browser.
This option doesn't depend on the validation type, so you can always specify it. (Specify "none" as your validation
type, if no other validation type is required.) When the user clicks inside the text field, the hint disappears; when the
user clicks outside the text field, Spry restores the hint to the textfield if the field contains no value.
❖ To create a hint for a text field, add the hint property to the third parameter of the constructor and the text of
your hint as the value, as follows:
var textfieldwidget1 = new Spry.Widget.ValidationTextField("textfieldwidget1",
"validation_type", {hint:"some hint text here"});
SPRY
User Guide
61