Tag Documentation

cf_sebField

Description

Builds a form field with for use with cf_sebForm.

Attributes

Data Retrieval Method: (all) table | query | CFC
Type: (all) checkbox | file | radio | select | text | textarea
(use above links to show only relevant attributes)

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.

  • ERROR
  • MAKEUNIQUE
  • OVERWRITE
  • SKIP

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