Builds a form field with for use with cf_sebForm.
Attribute |
Req/Opt |
Default |
Description |
---|---|---|---|
fieldname |
optional |
|
Name of the form field. Optional only for the following types: submit, reset, button, cancel, delete. |
name |
optional |
|
Shortcut for "fieldname" attribute. |
type |
optional |
|
The type of form field. Types that start with "x" require access to the librarypath set in cf_sebForm, require JavaScript, will not work with semantic format, and may not be XHTML compliant. |
length |
optional |
|
The length of the field. This will be used for any create/alter table statements and will be used for maxlength if relevant. |
title |
optional |
|
The title attribute of the form field. |
label |
optional |
|
The label of the field. Will default to the value of the fieldname attribute if not provided. |
defaultValue |
optional |
|
The default value for the field. |
setValue |
optional |
|
If used, this will force the value of the field to the value of this attribute. |
required |
optional |
false |
Specifies whether this field is required. Will cause both client-side and server-side verification that a non-empty value is chosen. |
regex |
optional |
|
A regular expression to be used for both client and server side validation. |
stripregex |
optional |
|
A regular expression defining text to remove from the value submitted in the form. |
locked |
optional |
false |
If set to true, the field cannot be edited. |
cols |
optional |
40 |
An integer. Only used for type=textarea. Sets the cols attribute of the textarea tag which determines the width of the form element. |
rows |
optional |
8 |
An integer. Only used for type=textarea. Sets the rows attribute of the textarea tag which determines the height of the form element. |
wrap |
optional |
|
Only used for type=textarea.
|
qformmethods |
optional |
|
Any qform methods that you wish to invoke against the current field. validateEmail()/isEmail() and validateSSN()/isSSN() will be checked on both the client and the server. See qForms Documentation for more methods. |
input_prefix |
optional |
|
Text to add just before the form input. |
input_suffix |
optional |
|
Text to add just after the form input. |
GeneratedContent |
optional |
|
This can be used to pass in text as though it were between opening and closing cf_sebField tags. |
help |
optional |
|
Instructions about the field (generally appears directly after the field). |