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.

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.

reltable

optional

 

The table used to indicate/save relationships.

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.

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