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.

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.

reltable

optional

 

The table used to indicate/save 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.

isnullable

optional

true

A boolean value. Set to false if the database field cannot contain a null value.

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

dbfield

optional

 

The name of the field in the database for this form field. Will default to the fieldname attribute if not provided.

dbdatatype

optional

 

The datatype for this field in the database. Required if the altertable attribute of the parent cf_sebForm tag is true. See Documentation for cf_dbchanges.

cfdatatype

optional

 

The ColdFusion datatype for this database field. Use this if you want database inserts or updates to use cfqueryparam (suggested). See Documentation for cfqueryparam.