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. |
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. |
subtable |
optional |
|
The table used to create the subfields (options) for this field. |
subquery |
optional |
|
A query used to create the subfields (options) for this field. |
subarray |
optional |
|
An array of structures used to create the subfields (options) for this field. |
subcomp |
optional |
|
A component to use to create subfields (options) for this field. The component must be a child of the CFC_Component defined in cf_sebForm (so, either attributes.CFC_Component[attributes.subcomp] or attributes.CFC_Component.Parent[attributes.subcomp] must exist). |
subvalues |
optional |
|
Only for types of checkbox,radio,select. If subquery is provided, this would be the column in the subquery used for the values of the options. Otherwise, a comma delimited list of option values. |
subdisplays |
optional |
|
Only for types of checkbox,radio,select. If subquery is provided, this would be the column in the subquery used for the displays of the options. Otherwise, a comma delimited list of option displays. |
subtitles |
optional |
|
Only for types of checkbox,radio,select. If subquery is provided, this would be the column in the subquery used for the title of each option. |
reltable |
optional |
|
The table used to indicate/save relationships. |
relquery |
optional |
|
The query used to indicate relationships. |
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. |
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). |