list

list

list

Renders a dropdown select box, check boxes or radio buttons with data provided via a comma separated list or from a method call

Examples

Basic
<cfproperty
         ftSeq="15"
         ftFieldset="Colors"
         name="podHeaderColor"
         type="string"
         hint="Pod Header Color"
         required="false"
         default=""
         ftLabel="Pod Header Color"
         ftType="list"
         ftList="apple,orange,kiwi"/>
List with different values from text
<cfproperty
         ftSeq="15"
         ftFieldset="Colors"
         name="podHeaderColor"
         type="string"
         hint="Pod Header Color"
         required="false"
         default=""
         ftLabel="Pod Header Color"
         ftType="list"
         ftList="APP:apple,ORA:orange,KIW:kiwi"/>
List rendered as check boxes
<cfproperty
         ftSeq="15"
         ftFieldset="Colors"
         name="podHeaderColor"
         type="string"
         hint="Pod Header Color"
         required="false"
         default=""
         ftLabel="Pod Header Color"
         ftType="list"
         ftList="apple,orange,kiwi"
        ftRenderType="checkbox"/>
List rendered as radio buttons
<cfproperty
         ftSeq="15"
         ftFieldset="Colors"
         name="podHeaderColor"
         type="string"
         hint="Pod Header Color"
         required="false"
         default=""
         ftLabel="Pod Header Color"
         ftType="list"
         ftList="apple,orange,kiwi"
        ftRenderType="radio"/>
List with a method call to populate
<cfproperty
         ftSeq="15"
         ftFieldset="Colors"
         name="podHeaderColor"
         type="string"
         hint="Pod Header Color"
         required="false"
         default=""
         ftLabel="Pod Header Color"
         ftType="list"
         ftListData="myMethod"
        />
List with a method call to populate from another type component
<cfproperty
         ftSeq="15"
         ftFieldset="Colors"
         name="podHeaderColor"
         type="string"
         hint="Pod Header Color"
         required="false"
         default=""
         ftLabel="Pod Header Color"
         ftType="list"
         ftListData="myMethod"
        ftListDataTypename="dmNews"/>

Formtool Metadata

Name list
Package Path farcry.core.packages.formtools.list

Attributes

Name Default Options Required Hint
ftAjaxMethod No The function that will be used to render the html output for ajax requests of a property
ftClass No sets a class for the form element
ftDisplayMethod No The function that will be used to render the html output for displaying a property
ftEditMethod No The function that will be used to render the html output for editing a property
ftFieldset No Used if you are relying on the framework to render your form. Used to group the fields into HTML fieldsets.
ftLabel No Used by the FarCry form layout as the label of the form field. This will default to the [name].
ftLabelAlignment inline inline, block No Used by FarCry Form Layouts for positioning of labels. inline or block.
ftList No comma separated list of values or variable:value pairs to appear in the drop down. e.g apple,orange,kiwi or APP:apple,ORA:orange,KIW:kiwi
ftListData No Method call that must return a string in the same variable value pair format as the ftlist attribute OR a query containing the columns value & name. Method gets passed the objectid of the currently edited object as an argument. e.g apple,orange,kiwi or APP:apple,ORA:orange,KIW:kiwi or queryNew('value,name')
ftListDataTypename No Specific typename to call ftlistdata method on.
ftMultipleLines true true, false No for radio and checkbox only, adds a break between each checkox or radio button
ftRenderType dropdown dropdown, checkbox, radio No The way the list will get rendered.
ftSelectMultiple false true, false No used when ftRenderType=dropdown. It allows the user to select multiple items
ftSeq No Used if you are relying on the framework to render your form. Used to sort the fields on the form.
ftstyle No allows in line styles to be added to form element
ftType No Tells the framework which of the formtool ui components to use when rendering your form. This will default to the [type].
ftValidateMethod No The function that will be used to render the html output for validating (processing) a property form submission
ftValidation No List of CSS classes that can be used for js validation
ftWizardStep No Used if you are relying on the framework to render your form. Used to setup a wizard which is a multi step form process.