Package de.xima.fc.form.common.items

Class XSpan

java.lang.Object

de.xima.fc.form.common.items.XSpan

All Implemented Interfaces:

IXItem, IXItemBasic

public class XSpan
extends Object
implements IXItem

Constructor Summary

Constructors

Constructor	Description
XSpan()

Method Summary

Modifier and Type	Method	Description
ArrayList<XItemPropertyDesc>	getAvailableProperties(Locale locale)	Gets a list of base properties available for this item.
String	getIcon()
String	getPrefix()	Finds the prefix for form items of this type, such as cb for checkboxes or tf for input fields.
boolean	isSubmitsValues()	Checks whether form items of this type can send values to the server when the form is submitted.
void	renderItem(com.hp.gagawa.java.elements.Div container, XItemRenderData renderData, XItemRenderCtx renderCtx, IXFormRenderContext formRenderCtx)	Creates the HTML for this form item that is included in the final rendered form.
void	renderItemPreview(com.hp.gagawa.java.elements.Div container, XItemRenderData renderData, XItemRenderCtx renderCtx, IXFormRenderContext formRenderCtx)	Similar to the IXItemBasic.renderItem(Div, XItemRenderData, XItemRenderCtx, IXFormRenderContext) method, but this is called when the form is viewed in the designer.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface de.xima.fc.form.common.models.IXItemBasic

getAutoReRender, getFieldNameConventions, isShouldRenderForAttributeOnLabel, isShouldRenderUnit, isShowInDrawerPanel, isShowInElementSelect, processUpload, validate, validate, validateGlobal

Constructor Detail

XSpan

public XSpan()

Method Detail

getAvailableProperties

public ArrayList<XItemPropertyDesc> getAvailableProperties(Locale locale)

Description copied from interface: IXItemBasic

Gets a list of base properties available for this item.

Note that plugins may extend these properties. Use de.xima.fc.web.common.fd2.XItemPropertiesHelper#getAvailableProperties to get a list of all properties, including properties added by plugins.

Note: Caching the properties returned by this method is not required. Just create the list of properties and return it.

Specified by:

getAvailableProperties in interface IXItemBasic

Parameters:

locale - The current locale that can be used for locale dependent properties.

Returns:

A list of all base properties available for this item.

getIcon

public String getIcon()

Specified by:

getIcon in interface IXItemBasic

Returns:

The CSS class for the icon of this form item, such as for example ico-fc-XCheckbox.

getPrefix

public String getPrefix()

Description copied from interface: IXItemBasic

Finds the prefix for form items of this type, such as cb for checkboxes or tf for input fields. This prefix is used, for example, in the designer to generate a default name for newly added form items (tf-1, cb-2).

Specified by:

getPrefix in interface IXItemBasic

Returns:

The prefix for form items of this type.

isSubmitsValues

public boolean isSubmitsValues()

Description copied from interface: IXItemBasic

Checks whether form items of this type can send values to the server when the form is submitted. Form items that do not submit values are, for example, not validated and no values are ever stored in the database. Form items such as pictures or charts do no submit values, while classical form elements such as input fields and checkboxes are a prime example of form items that do submit values.

Specified by:

isSubmitsValues in interface IXItemBasic

Returns:

Whether form element of this type can send values to the server when the form is submitted.

renderItem

public void renderItem(com.hp.gagawa.java.elements.Div container,
                       XItemRenderData renderData,
                       XItemRenderCtx renderCtx,
                       IXFormRenderContext formRenderCtx)

Description copied from interface: IXItemBasic

Creates the HTML for this form item that is included in the final rendered form. You should append one or more HTML elements to the container that is passed to this method.

Specified by:

renderItem in interface IXItemBasic

Parameters:

container - The container that will contain this form item in the final form. You should append children to this container.

renderData - The current render data with the properties and options of the item.

renderCtx - The current render context giving you access to the global configuration.

formRenderCtx - The form render context giving you access to the global form configuration.

See Also:

IXItemBasic.renderItemPreview(Div, XItemRenderData, XItemRenderCtx, IXFormRenderContext)

renderItemPreview

public void renderItemPreview(com.hp.gagawa.java.elements.Div container,
                              XItemRenderData renderData,
                              XItemRenderCtx renderCtx,
                              IXFormRenderContext formRenderCtx)

Description copied from interface: IXItemBasic

Similar to the IXItemBasic.renderItem(Div, XItemRenderData, XItemRenderCtx, IXFormRenderContext) method, but this is called when the form is viewed in the designer. You can, if necessary, render the form slightly differently in the desigern. This is useful, for example, when when you do not want users to be able to interact with the form element directly in the designer preview area.

Specified by:

renderItemPreview in interface IXItemBasic

Parameters:

container - The container that will contain this form item in the final form. You should append children to this container.

renderData - The current render data with the properties and options of the item.

renderCtx - The current render context giving you access to the global configuration.

formRenderCtx - The form render context giving you access to the global form configuration.

See Also:

IXItemBasic.renderItem(Div, XItemRenderData, XItemRenderCtx, IXFormRenderContext)