• Home/
• Formtools/
• array

array

Provides an interface for linking types together

Examples

Basic

<cfproperty name="playjoin" type="array" 
        ftType="array"  
        ftJoin="dmNews">

Dont allow user to create new record

<cfproperty name="playjoin" type="array"
        ftType="array"  
        ftJoin="dmNews" 
        ftAllowCreate="false">

Dont allow user to select from existing records, only create

<cfproperty name="playjoin" type="array"
        ftType="array"  
        ftJoin="dmNews" 
        ftAllowSelect="false">

Allow the user to edit the record directly from the library

<cfproperty name="playjoin"  type="array" 
        ftType="array" 
        ftJoin="dmNews" 
        ftAllowEdit="true">

Render the record library as a list with mutliple select

<cfproperty name="playjoin" type="array" 
        ftType="array"  
        ftJoin="dmNews" 
        ftRenderType="list">

Render the record library as a list without multiple select

<cfproperty name="playjoin" type="array" 
        ftType="array"  
        ftJoin="dmNews" 
        ftRenderType="list" 
        ftSelectMultiple="false">

Custom query to populate the library picker, myCustomQuery is a method in the type this property belongs

<cfproperty name="playjoin" type="array"
        ftType="array"  
        ftJoin="dmNews" 
        ftLibraryData="myCustomQuery">

Custom query with method in a different type

<cfproperty name="playjoin" type="array"
        ftType="array" 
        ftJoin="dmNews" 
        ftLibraryData="myCustomQuery" 
        ftLibraryDataTypename="dmNews">

Formtool Metadata

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

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
ftAllowCreate	true	true, false	No	Allows user create new record within the library picker
ftAllowEdit	false	true, false	No	Allows user edit new record within the library picker
ftAllowLibraryEdit	false		No	???
ftAllowRemoveAll	false	true, false	No	Allows user to remove all items at once
ftAllowSelect	true	true, false	No	Allows user to select existing records within the library picker
ftClass			No	CSS Class that can be used on the formtool input
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.
ftFirstListLabel	-- SELECT --		No	Used with ftRenderType, this is the value of the first element in the list
ftJoin		comma seperated list of types	Yes	A list of the user can select from. e.g 'dmImage,dmfile,dmflash'
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.
ftLibraryData			No	Name of a function to return the library data. By default will look for ./webskin/typename/librarySelected.cfm
ftlibrarydatasqlorderby	datetimelastupdat...		No	Nominate a specific property to order library results by.
ftlibrarydatasqlwhere			No	A simple where clause filter for the library data result set. Must be in the form PROPERTY OPERATOR VALUE. For example, status = 'approved'
ftLibraryDataTypename			No	Typename containing the function defined in ftLibraryData
ftLibraryEditWebskin	edit		No	???
ftLibraryListItemHeight			No	???
ftLibraryListItemWidth			No	???
ftLibrarySelectedListClass	arrayDetail		No	overwrite the style class of the list
ftLibrarySelectedListStyle			No	write your own inline style for the class
ftLibrarySelectedWebskin	librarySelected		No	webskin to overwrite each record in list
ftRemoveType	remove	delete, detach	No	detach will only remove from the join, delete will remove from the database
ftRenderType	Library	Library, list, checkbox or radio	No	Specify how to render the form element for the array, library pop-up, select dropdown, or list of checkbox or radio buttons.
ftSelectMultiple	true	true, false	No	Allow selection of multiple items from a select list. Values - true or false, if this property is omitted then allowing multiple select is default
ftSelectSize	10		No	Specify the number of items displayed of a select list.
ftSeq			No	Used if you are relying on the framework to render your form. Used to sort the fields on the form.
ftStyle			No	CSS Style that can be used on the formtool input
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.