Spry User Guide - Support - Adobe

Style a Validation Checkbox widget (general instructions)
1 Open the SpryValidationCheckbox.css file.
2 Locate the CSS rule for the part of the widget to change. For example, to change the background color of the
Checkbox widget’s required state, edit the .checkboxRequiredState rule in the SpryValidationCheckbox.css file.
3 Make your changes to the CSS rule and save the file.
The SpryValidationCheckbox.css file contains extensive comments, explaining the code and the purpose for certain
rules. For further information, see the comments in the file.
Style Validation Checkbox widget error message text
By default, error messages for the Validation Checkbox widget appear in red with a 1-pixel solid border surrounding
the text.
❖ To change the text styling of Validation Checkbox widget error messages, use the following table to locate the
appropriate CSS rule, and then change the default properties, or add your own text styling properties and values.
Text to style Relevant CSS rule Relevant properties to change
Error message text .checkboxRequiredState .checkboxRequiredMsg,.checkboxMinSelectionsState.checkboxMinSelectionsMsg,
.checkboxMaxSelectionsState
.checkboxMaxSelectionsMsg
Customize state-related class names
Whileyoucanreplaceerrormessage-relatedclassnameswithclassnamesofyourownbychangingtherulesinthe
CSS and the class names in the HTML code, you cannot change or replace state-related class names, because the
behaviors are hard-coded as part of the Spry framework. You can, however, override the default state-related class
name with your own class name by specifying a new value in the third parameter of the widget constructor.
❖ To change widget state-related class names, add one of the overriding options to the third parameter of the widget
constructor, and specify your custom class name, as follows:
var sprycheckbox1 = new Spry.Widget.ValidationCheckbox("sprycheckbox1",
{requiredClass:"required"});
The following table provides a list of options you can use to override built-in state-related class names.
Option Description
color: #CC3333; border: 1px solid
#CC3333;
requiredClass Overrides the "checkboxRequiredState" built-in value
minSelectionsClass Overrides the "checkboxMinSelectionsState" built-in
value
maxSelectionsClass Overrides the "checkboxMaxSelectionsState" built-in
value
SPRY
User Guide
90