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. |
|
size |
optional |
|
The size attribute of the form field. |
|
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. |
|
topopt |
optional |
|
The display text of the top (empty) option |
|
topoptvalue |
optional |
|
The value of the top (empty) option. |
|
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. |
|
multiple |
optional |
false |
If set to true, allows multiple selections |
|
addlink |
optional |
|
If provided, the URL to for adding (or changing) options for the drop-down. |
|
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). |