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. |
|
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). |
|
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. |
|
accept |
optional |
|
Only used for type=file. If this field is populated, it will cause server-side verification to check that the uploaded file contains one of the listed mime-types. (comma delimited list) |
|
extensions |
optional |
|
Only used for type=file. If this field is populated, it will cause client-side verification to check that the uploaded file contains one of the listed extensions. (comma delimited list) |
|
destination |
optional |
|
Only used for type=file. Required for type=file. The absolute path in which to put the uploaded file. Make sure that you have a different destination folder for each field in the database. |
|
urlpath |
optional |
|
Only used for type=file. The URL path to the directory containing the uploaded file. |
|
folder |
optional |
|
Only used for type=file. If UploadFilePath and UploadBrowserPath are set in sebForm, this will be the folder beneath those values. Used to automatically set urlpath and destination. |
|
nameconflict |
optional |
ERROR |
Only used for type=file. The response taken by the server in case the uploaded file has the same name as another file in the same directory. See Documentation for cffile.
|
|
mode |
optional |
|
Only used for type=file. The Unix mode for the uploaded file. Has no effect on Windows systems. |
|
showFile |
optional |
true |
Indicates if sebField should display the image or file name if it exists. |
|
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). |