Text Area

Use this control to display or accept input of multi-line data. Users can select multiple lines of data using the multi-select key combination for their platform.

Property Name Description

Field cell style Apply an HTML style attribute to the field body.

Example: padding-top:5px;background-color:red

Field CSS class name(s) Apply one or more CSS class styles to the field body. You can view the classes that are available for your User Application portal by logging into the User Application, navigating to Administration > Application Configuration > Theme Administration, then clicking the Preview button for the portal theme you are using.

If you leave the field blank, it defaults to the nv-fontExtraSmall class.

Example: nv-fontMedium nv-backgroundColor3 Separate class names with spaces.

Field width in pixels Use this field to configure the field’s visible width on the form. The default is 200 pixels.

Label cell style Apply an HTML style attribute to the field label.

Example: color:red

Label CSS class name(s) Apply one or more CSS class styles to the field label. You can view the classes that are available for your User Application portal by logging into the User Application, navigating to Administration > Application Configuration > Theme Administration, then clicking the Preview button for the portal theme you are using.

If you leave the field blank, it defaults to the nv-formFieldLabel class.

Example: nv-color5

Separate class names with spaces.

Lower bounds (for numbers only) The lowest number allowed for decimal or integer values.

Maximum length The maximum length for string values. Blocks input when this length is reached.

Minimum length The minimum length for string values. Validates that the user enters a string at least this long.

Number of characters allowed Specifies the number of characters a user is allowed to enter. This is related to Field width in pixels.

Upper bound (for numbers only) The highest number allowed for decimal or integer values.

Validation Mask (regular expression) An expression used for validating the field’s data. Designer provides a default set of validation masks by default. You must enable them through Windows > Preferences > Provisioning > Validation Mask.

For more information, see Section 2.3, “Setting Provisioning View Preferences,” on page 23.

Figure 5-29 Sample Text Area Control

Table 5-28 Text Area Control Properties

5.5.23 Title

Use this read-only control to label your form or provide instructions.

Property Name Description

Field cell style Apply an HTML style attribute to the field body.

Example: padding-top:5px;background-color:red Field CSS class name(s) Apply one or more CSS class styles to the field body.

You can view the classes that are available for your User Application portal by logging into the User Application, navigating to Administration > Application Configuration > Theme Administration, then clicking the Preview button for the portal theme you are using.

If you leave the field blank, it defaults to the nv-fontExtraSmall class.

Example: nv-fontMedium nv-backgroundColor3 Separate class names with spaces.

Label cell style Apply an HTML style attribute to the field label.

Example: color:red

Label CSS class name(s) Apply one or more CSS class styles to the field label.

You can view the classes that are available for your User Application portal by logging into the User Application, navigating to Administration > Application Configuration > Theme Administration, then clicking the Preview button for the portal theme you are using.

If you leave the field blank, it defaults to the nv-formFieldLabel class.

Example: nv-color5

Separate class names with spaces.

Number of columns displayed The visible width of the control; the number of characters wide.

Number of lines displayed The number of lines to display at one time.

Table 5-29 Title Control Properties

5.5.24 TrueFalseCheckBox

Use this control to allow the user to select or deselect a choice. The values returned by the control are true (selected) and false (not selected). The returned values are always strings.

NOTE: This control returns a boolean value of True or False depending on the selection made by the user. The display values of the control can be set to a more user friendly or informative value such as Yes/No or Accept/Reject depending on the intended use of the form; however, the underlying value always returns either True or False. If the control is used to return anything other than True or False or more than two values, for example (Yes/No/Maybe), by default it returns the value as False if it is not True.

You can initialize the control from a JavaScript Boolean Object. The field.getValue() returns a JavaScript Boolean Object.

Use setValues(["true"]) not setValues[true]), the setValues() method expects a string or an array of string values.

Table 5-30 TrueFalseCheckBox Control Properties Property Name Description Display title in signed

form document

When this option is set to False and the form is a signed form (using digital signatures), the title control is not displayed.

Font-size Specify small, medium, or large.

Style class Choose a font style (such as bold) and colors from a palette.

Property Name Description

Field cell style Apply an HTML style attribute to the field body.

Example: padding-top:5px;background-color:red

Field CSS class name(s) Apply one or more CSS class styles to the field body. You can view the classes that are available for your User Application portal by logging into the User Application, navigating to Administration > Application Configuration > Theme Administration, then clicking the Preview button for the portal theme you are using.

If you leave the field blank, it defaults to the nv-fontExtraSmall class.

Example: nv-fontMedium nv-backgroundColor3 Separate class names with spaces.

Field width in pixels Use this field to configure the field’s visible width on the form. The default is 200 pixels.

Label cell style Apply an HTML style attribute to the field label.

Example: color:red

5.5.25 TrueFalseRadioButtons

Use this control to display a choice of True or False as a set of radio buttons.

Figure 5-30 Sample TrueFalseRadioButtons Control

This control has no custom properties.

NOTE: This control returns a Boolean value of True or False depending on the selection made by the user. The display values of the control can be set to a more user friendly or informative value such as Yes/No or Accept/Reject depending on the intended use of the form; however, the underlying value always returns either True or False. If the control is used to return anything other than True or False or more than two values, for example (Yes/No/Maybe), by default it returns the value as False if it is not True.

5.5.26 TrueFalseSelectBox

Use this control to display a choice of True or False in a drop-down list.

Figure 5-31 Sample TrueFalseSelectBox Control

NOTE: This control returns a Boolean value of True or False depending on the selection made by the user. The display values of the control can be set to a more user friendly or informative value such as Yes/No or Accept/Reject depending on the intended use of the form; however, the underlying value always returns either True or False. If the control is used to return anything other than True or False or more than two values, for example (Yes/No/Maybe), by default it returns the value as False if it is not True.

Label CSS class name(s)

Apply one or more CSS class styles to the field label. You can view the classes that are available for your User Application portal by logging into the User Application, navigating to Administration > Application Configuration > Theme Administration, then clicking the Preview button for the portal theme you are using.

If you leave the field blank, it defaults to the nv-formFieldLabel class.

Example: nv-color5

Separate class names with spaces.

Property Name Description

Table 5-31 TrueFalsSelectBox Properties