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. |
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). |