org.kuali.rice.krad.uif.component
Interface Component

All Superinterfaces:

Cloneable, Copyable, DictionaryBean, LifecycleElement, org.springframework.core.Ordered, ScriptEventSupport, Serializable, UifDictionaryBean

All Known Subinterfaces:

CollectionGroup, Container, ContentElement, Control, DataField, Field, Group, InputField, PageGroup, SelectControl, TextControl, Widget

All Known Implementing Classes:

Accordion, AccordionGroup, Action, ActionField, ApplicationHeader, BlockUI, BreadcrumbItem, Breadcrumbs, CheckboxControl, CheckboxGroupControl, CollectionGroupBase, ComponentBase, ComponentExhibit, ComponentLibraryView, ContainerBase, ContentElementBase, ControlBase, DataFieldBase, DataTable, DatePicker, DialogGroup, Disclosure, Div, DocumentView, FieldBase, FieldGroup, FileControl, FormView, GenericField, GroupBase, GroupControl, Growls, Header, HeadLink, Help, HiddenControl, Icon, Iframe, IframeView, Image, ImageField, InputFieldBase, Inquiry, InquiryView, Label, LightBox, LightTable, Link, LinkField, LinkGroup, LocationSuggest, LookupInputField, LookupView, MaintenanceDocumentView, Message, MessageField, MessageView, MetaTag, MultiValueControlBase, NavigationBar, NavigationGroup, OptionListControl, PageGroupBase, Pager, PasswordControl, QuickFinder, RadioGroupControl, RemoteFieldsHolder, RichTable, Scrollpane, SelectControlBase, SidebarNavigationGroup, Space, SpaceField, Spinner, SpinnerControl, Suggest, SyntaxHighlighter, TabGroup, Tabs, TextAreaControl, TextControlBase, ToggleMenu, Tooltip, TransactionalDocumentView, Tree, TreeGroup, UserControl, View, ViewHeader, WidgetBase, WizardGroup

public interface Component
extends UifDictionaryBean, LifecycleElement, Serializable, Ordered, ScriptEventSupport

Component defines basic properties and methods that all rendering element implement

All classes of the UIF that are used as a rendering element implement the component interface. All components within the framework have the following structure:

• Dictionary Configuration/Composition
• Java Class (the Component implementation
• >JSP Template Renderer

There are three basic types of components:

• Container Components: View, Group
• Field Components: Field
• Widget Components: Widget

Author:

Kuali Rice Team (rice.collab@kuali.org)

See Also:

Container, Field, Widget

Field Summary

Fields inherited from interface org.kuali.rice.krad.uif.component.Ordered

INITIAL_ORDER_VALUE

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Method Summary

void	addDataAttribute(String key, String value) Add a data attribute to the dataAttributes map
void	addScriptDataAttribute(String key, String value) Add a script data attribute to the scriptDataAttributes map
void	addStyleClass(String styleClass) Adds a single style to the list of styles on this component
void	addWrapperCssClass(String cssClass) Add a cell css class to the cell classes list
void	appendToStyle(String itemStyle) Appends to the inline style set on a component
void	completeValidation(ValidationTrace tracer) Validates different requirements of component compiling a series of reports detailing information on errors found in the component.
List<String>	getAdditionalComponentsToRefresh() Returns a list of componentIds which will be also be refreshed when this component is refreshed
String	getAdditionalComponentsToRefreshJs() Returns a string for representing the list of additional components to be refreshed as a JavaScript value
List<String>	getAdditionalCssClasses() Convenience property for adding css class names to the end of the list of cssClasses that may already exist on this Component (this is to avoid explicitly having to set list merge in the bean definition)
List<String>	getAdditionalTemplates() Gets additional templates that will be required during the rendering of this component.
String	getAlign() Horizontal alignment of the component within its container
String	getCellWidth() Width setting for the cell containing the component (only applies within table based layouts)
int	getColSpan() Number of places the component should take up horizontally in the container
List<ComponentModifier>	getComponentModifiers() ComponentModifier instances that should be invoked to initialize the component
ComponentSecurity	getComponentSecurity() Security object that indicates what authorization (permissions) exist for the component
String	getComponentTypeName() The name for the component type
String	getConditionalRefresh() Spring EL expression, which when evaluates to true, causes this component to be refreshed
String	getConditionalRefreshConditionJs() A JavaScript expression constructed from getProgressiveRender()
List<String>	getConditionalRefreshControlNames() The list of control names (ids) extracted from getConditionalRefresh()
List<String>	getCssClasses() CSS style class(s) to be applied to the component
Map<String,String>	getDataAttributes() The DataAttributes that will be written to the html element for this component as data-
String	getEventHandlerScript() String containing JavaScript code for registering event handlers for this component (blur, focus, click, etc.)
List<Object>	getFinalizeMethodAdditionalArguments() The List of Object instances that should be passed as arguments to the finalize method
MethodInvokerConfig	getFinalizeMethodInvoker() MethodInvokerConfig instance for the method that should be invoked for finalizing the component configuration
String	getFinalizeMethodToCall() The name of the method that should be invoked for finalizing the component configuration (full method name, without parameters or return type)
List<String>	getLibraryCssClasses()
String	getMethodToCallOnRefresh() Gets the method to call on refresh.
int	getOrder() Order of a component within a List of other components
String	getPostRenderContent() Raw html or string content to render after this component renders
String	getPreRenderContent() Raw html or string content to render before this component renders
String	getProgressiveDisclosureConditionJs() A JavaScript expression constructed from getConditionalRefresh()
List<String>	getProgressiveDisclosureControlNames() List of control names (ids) extracted from getProgressiveRender()
String	getProgressiveRender() Spring EL expression, which when evaluates to true, makes this component visible
List<Component>	getPropertyReplacerComponents() List of components that are contained within the List of PropertyReplacer in component
List<PropertyReplacer>	getPropertyReplacers() gets a list of PropertyReplacer instances
int	getRefreshTimer() Time in seconds after which the component is automatically refreshed
List<String>	getRefreshWhenChangedPropertyNames() Specifies a property by name that when its value changes will automatically perform a refresh on this component
String	getRenderedHtmlOutput() Rendering output for the component that will be sent as part of the response (can contain static text and HTML)
Boolean	getRequired() Indicates whether the component is required
int	getRowSpan() Number of places the component should take up vertically in the container
Map<String,String>	getScriptDataAttributes() The DataAttributes that will be written to the html as a script call to data for this component (these cannot be used for jQuery selection directly)
String	getScriptDataAttributesJs() Returns a js string that can be used to right js data attributes to for the component
String	getSimpleDataAttributes() The string that can be put into a the tag of a component to add data attributes inline
String	getStyle() CSS style string to be applied to the component
String	getStyleClassesAsString() Gets a string representing all CSS style classes.
String	getTemplate() The path to the JSP file that should be called to render the component
String	getTemplateName() The name for which the template can be invoked by
Map<String,String>	getTemplateOptions() The options that are passed through to the Component renderer
String	getTemplateOptionsJSString() Builds a string from the underlying Map of template options that will export that options as a JavaScript Map for use in js and jQuery plugins
String	getTitle() The component title
Tooltip	getToolTip() The Tooltip widget that renders a tooltip with additional information about the element on specified trigger event
String	getValign() Vertical alignment of the component within its container
String	getWidth() Width the component should take up in the container
List<String>	getWrapperCssClasses() The cellCssClasses property defines the classes that will be placed on the corresponding td (or th) elements relating to this component when used in a table backed layout.
String	getWrapperStyle() CSS style string to be applied to the cell containing the component (only applies within table based layouts)
boolean	isDisableSessionPersistence() Disables the storage of the component in session (when the framework determines it needs to be due to a refresh condition)
boolean	isDisclosedByAction() If true if this component is disclosed by an action in js, a placeholder will be put in this components place if render is also false.
boolean	isForceSessionPersistence() Indicates whether the component should be stored with the session view regardless of configuration
boolean	isHidden() Indicates whether the component should be hidden in the UI
boolean	isProgressiveRenderAndRefresh() Determines whether the component will always be retrieved from the server and shown
boolean	isProgressiveRenderViaAJAX() Indicates whether the component will be stored on the client, but hidden, after the first retrieval
boolean	isReadOnly() Indicates whether the component can be edited
boolean	isRefreshedByAction() Indicates the component can be refreshed by an action
boolean	isRendered() Indicates whether the component has been fully rendered.
boolean	isResetDataOnRefresh() Indicates whether data contained within the component should be reset (set to default) when the component is refreshed
boolean	isRetrieveViaAjax() When true, this component will render as a placeholder component instead of rendering normally because the content will be later retrieved through manually ajax retrieval calls in the js
boolean	isSelfRendered() Indicates whether the component contains its own render output (through the renderOutput property)
void	setAdditionalComponentsToRefresh(List<String> additionalComponentsToRefresh) Setter for alsoRefreshComponents
void	setAdditionalCssClasses(List<String> styleClasses) Set the additionalCssClasses
void	setAlign(String align) Sets the components horizontal alignment
void	setCellWidth(String cellWidth) Setter for the containing cell width
void	setColSpan(int colSpan) Setter for the components column span
void	setComponentModifiers(List<ComponentModifier> componentModifiers) Setter for the components List of ComponentModifier instances
void	setComponentSecurity(ComponentSecurity componentSecurity) Setter for the components security object
void	setConditionalRefresh(String conditionalRefresh) Setter for conditionalRefresh Spring EL expression
void	setCssClasses(List<String> styleClasses) Setter for the components style classes
void	setDataAttributes(Map<String,String> dataAttributes) Setter for data attributes to include for the component
void	setDisableSessionPersistence(boolean disableSessionPersistence) Setter for disabling storage of the component in session
void	setDisclosedByAction(boolean disclosedByAction) Set if this component is disclosed by some outside action
void	setForceSessionPersistence(boolean persistInSession) Setter for the indicator to force persistence of the component in session
void	setHidden(boolean hidden) Setter for the hidden indicator
void	setLibraryCssClasses(List<String> libraryCssClasses)
void	setOrder(int order) Setter for the component's order
void	setPostRenderContent(String postRenderContent) Set the postRenderContent
void	setPreRenderContent(String preRenderContent) Set the preRenderContent
void	setProgressiveRender(String progressiveRender) Setter for progressiveRender Spring EL expression
void	setProgressiveRenderAndRefresh(boolean progressiveRenderAndRefresh) Setter for the progressiveRenderAndRefresh flag
void	setProgressiveRenderViaAJAX(boolean progressiveRenderViaAJAX) Setter for the progressiveRenderViaAJAX flag
void	setPropertyReplacers(List<PropertyReplacer> propertyReplacers) Setter for the components property substitutions
void	setReadOnly(boolean readOnly) Setter for the read only indicator
void	setRefreshedByAction(boolean refreshedByAction) Setter for the refreshed by action indicator
void	setRefreshTimer(int refreshTimer) Setter for refreshTimer
void	setRefreshWhenChangedPropertyNames(List<String> refreshWhenChangedPropertyNames) Setter for the list of property names that trigger a refresh
void	setRenderedHtmlOutput(String renderOutput) Setter for the component's render output
void	setRequired(Boolean required) Setter for the required indicator
void	setResetDataOnRefresh(boolean resetDataOnRefresh) Setter for the reset data on refresh indicator
void	setRetrieveViaAjax(boolean useAjaxCallForContent) When true, this component will render as a placeholder component instead of rendering normally because the content will be later retrieved through manually ajax retrieval calls in the js
void	setRowSpan(int rowSpan) Setter for the component row span
void	setScriptDataAttributes(Map<String,String> dataAttributes) Setter for script data attributes to include for the component
void	setSelfRendered(boolean selfRendered) Setter for the self render indicator
void	setStyle(String style) Setter for the components style
void	setTemplate(String template) Setter for the components template
void	setTemplateName(String templateName) Setter for the name of the template (a name which can be used to invoke)
void	setTemplateOptions(Map<String,String> templateOptions) Setter for the template's options
void	setTemplateOptionsJSString(String templateOptionsJSString) Setter for the template's options
void	setTitle(String title) Setter for the component's title
void	setToolTip(Tooltip toolTip) Setter for the component tooltip widget instance
void	setValign(String valign) Setter for the component's vertical align
void	setViewStatus(String status) Set the view lifecycle processing status for this component, explicitly.
void	setWidth(String width) Setter for the components width
void	setWrapperCssClasses(List<String> cellCssClasses) Set the cellCssClasses property which defines the classes that will be placed on the corresponding td (or th) relating to this component when used in a table backed layout.
void	setWrapperStyle(String cellStyle) Setter for the cell style attribute

Methods inherited from interface org.kuali.rice.krad.datadictionary.uif.UifDictionaryBean

getExpressionGraph, getPropertyExpression, getPropertyExpressions, setExpressionGraph, setPropertyExpressions

Methods inherited from interface org.kuali.rice.krad.datadictionary.DictionaryBean

dataDictionaryPostProcessing, getComponentCode, getNamespaceCode

Methods inherited from interface org.kuali.rice.krad.uif.util.LifecycleElement

checkMutable, getContext, getId, getPhasePathMapping, getViewPath, getViewStatus, initializePendingTasks, isFinal, isInitialized, isModelApplied, isMutable, isRender, notifyCompleted, performApplyModel, performFinalize, performInitialization, pushAllToContext, pushObjectToContext, setContext, setId, setPhasePathMapping, setRender, setViewPath, setViewStatus, skipLifecycle

Methods inherited from interface org.kuali.rice.krad.datadictionary.Copyable

clone, copy, preventModification, unwrap

Methods inherited from interface org.kuali.rice.krad.uif.component.ScriptEventSupport

getOnBlurScript, getOnChangeScript, getOnClickScript, getOnCloseScript, getOnDblClickScript, getOnDocumentReadyScript, getOnFocusScript, getOnInputScript, getOnKeyDownScript, getOnKeyPressScript, getOnKeyUpScript, getOnLoadScript, getOnMouseDownScript, getOnMouseMoveScript, getOnMouseOutScript, getOnMouseOverScript, getOnMouseUpScript, getOnSubmitScript, getOnUnloadScript, setOnBlurScript, setOnChangeScript, setOnClickScript, setOnCloseScript, setOnDblClickScript, setOnDocumentReadyScript, setOnFocusScript, setOnInputScript, setOnKeyDownScript, setOnKeyPressScript, setOnKeyUpScript, setOnLoadScript, setOnMouseDownScript, setOnMouseMoveScript, setOnMouseOutScript, setOnMouseOverScript, setOnMouseUpScript, setOnSubmitScript, setOnUnloadScript

Method Detail

getComponentTypeName

String getComponentTypeName()

The name for the component type

This is used within the rendering layer to pass the component instance into the template. The component instance is exported under the name given by this method.

Returns:

String type name

isRendered

boolean isRendered()

Indicates whether the component has been fully rendered.

Returns:

True if the component has fully rendered, false if not.

setViewStatus

void setViewStatus(String status)

Set the view lifecycle processing status for this component, explicitly.

Parameters:

status - The view status for this component.

getTemplate

String getTemplate()

The path to the JSP file that should be called to render the component

The path should be relative to the web root. An attribute will be available to the component to use under the name given by the method getComponentTypeName. Based on the component type, additional attributes could be available for use. See the component documentation for more information on such attributes.

e.g. '/krad/WEB-INF/jsp/tiles/component.jsp'

Returns:

String representing the template path

setTemplate

void setTemplate(String template)

Setter for the components template

Parameters:

template -

getAdditionalTemplates

List<String> getAdditionalTemplates()

Gets additional templates that will be required during the rendering of this component.

If a parent or sibling component is referred to by this component's template, include that component's template here to ensure that it has been compiled already during bottom-up inline rendering.

Returns:

additional templates required during rendering

getTemplateName

String getTemplateName()

The name for which the template can be invoked by

Whether the template name is needed depends on the underlying rendering engine being used. In the example of Freemarker, the template points to the actual source file, which then loads a macro. From then on the macro is simply invoked to execute the template

e.g. 'uif_text'

Returns:

template name

setTemplateName

void setTemplateName(String templateName)

Setter for the name of the template (a name which can be used to invoke)

Parameters:

templateName -

getTitle

String getTitle()

The component title

Depending on the component can be used in various ways. For example with a Container component the title is used to set the header text. For components like controls other other components that render an HTML element it is used to set the HTML title attribute.

Returns:

String title for component

setTitle

void setTitle(String title)

Setter for the component's title

Parameters:

title -

getPropertyReplacerComponents

List<Component> getPropertyReplacerComponents()

List of components that are contained within the List of PropertyReplacer in component

Used to get all the nested components in the property replacers.

Returns:

List PropertyReplacer child components

getComponentModifiers

List<ComponentModifier> getComponentModifiers()

ComponentModifier instances that should be invoked to initialize the component

These provide dynamic initialization behavior for the component and are configured through the components definition. Each initializer will get invoked by the initialize method.

Returns:

List of component modifiers

See Also:

RunComponentModifiersTask

setComponentModifiers

void setComponentModifiers(List<ComponentModifier> componentModifiers)

Setter for the components List of ComponentModifier instances

Parameters:

componentModifiers -

isRetrieveViaAjax

boolean isRetrieveViaAjax()

When true, this component will render as a placeholder component instead of rendering normally because the content will be later retrieved through manually ajax retrieval calls in the js

This flag does not imply any automation, there must be a js call invoked for the content to be retrieved by the server, but this does mark it with a placeholder component which KRAD js uses during these calls. This placeholder component is used for ajax retrievals. In particular, this flag is useful for use in combination with the showLightboxComponent js function which will automatically retrieve the real content of a component through ajax if a placeholder component is detected. This allows for the full content to only be retrieved when the lightbox is first opened. When this flag is set to true, the forceSessionPersistence flag is set to true AUTOMATICALLY because it is implied that this component will be retrieved by an ajax call in the future. This may also be useful for direct custom calls to retrieveComponent function, as well, which also relies on the placeholder being present.

Returns:

true if this component is being rendered as a placeholder for use in replacement during and ajax call, false otherwise

setRetrieveViaAjax

void setRetrieveViaAjax(boolean useAjaxCallForContent)

When true, this component will render as a placeholder component instead of rendering normally because the content will be later retrieved through manually ajax retrieval calls in the js

Parameters:

useAjaxCallForContent -

isHidden

boolean isHidden()

Indicates whether the component should be hidden in the UI

How the hidden data is maintained depends on the views persistence mode. If the mode is request, the corresponding data will be rendered to the UI but not visible. If the mode is session, the data will not be rendered to the UI but maintained server side.

For a Container component, the hidden setting will apply to all contained components (making a section hidden makes all fields within the section hidden)

Returns:

boolean true if the component should be hidden, false if it should be visible

setHidden

void setHidden(boolean hidden)

Setter for the hidden indicator

Parameters:

hidden -

isReadOnly

boolean isReadOnly()

Indicates whether the component can be edited

When readOnly the controls and widgets of Field components will not be rendered. If the Field has an underlying value it will be displayed readOnly to the user.

For a Container component, the readOnly setting will apply to all contained components (making a section readOnly makes all fields within the section readOnly).

Returns:

boolean true if the component should be readOnly, false if is allows editing

setReadOnly

void setReadOnly(boolean readOnly)

Setter for the read only indicator

Parameters:

readOnly -

getRequired

Boolean getRequired()

Indicates whether the component is required

At the general component level required means there is some action the user needs to take within the component. For example, within a section it might mean the fields within the section should be completed. At a field level, it means the field should be completed. This provides the ability for the renderers to indicate the required action.

Returns:

boolean true if the component is required, false if it is not required

setRequired

void setRequired(Boolean required)

Setter for the required indicator

Parameters:

required -

getAlign

String getAlign()

Horizontal alignment of the component within its container

All components belong to a Container and are placed using a LayoutManager. This property specifies how the component should be aligned horizontally within the container. During the finalize phase the CSS text-align style will be created for the align setting.

Returns:

String horizontal align

See Also:

CssConstants.TextAligns

setAlign

void setAlign(String align)

Sets the components horizontal alignment

Parameters:

align -

getValign

String getValign()

Vertical alignment of the component within its container

All components belong to a Container and are placed using a LayoutManager. This property specifies how the component should be aligned vertically within the container. During the finalize phase the CSS vertical-align style will be created for the valign setting.

Returns:

String vertical align

See Also:

CssConstants.VerticalAligns

setValign

void setValign(String valign)

Setter for the component's vertical align

Parameters:

valign -

getWidth

String getWidth()

Width the component should take up in the container

All components belong to a Container and are placed using a LayoutManager. This property specifies a width the component should take up in the Container. This is not applicable for all layout managers. During the finalize phase the CSS width style will be created for the width setting.

e.g. '30%', '55px'

Returns:

String width string

setWidth

void setWidth(String width)

Setter for the components width

Parameters:

width -

getStyle

String getStyle()

CSS style string to be applied to the component

Any style override or additions can be specified with this attribute. This is used by the renderer to set the style attribute on the corresponding element.

e.g. 'color: #000000;text-decoration: underline;'

Returns:

String css style string

setStyle

void setStyle(String style)

Setter for the components style

Parameters:

style -

getLibraryCssClasses

List<String> getLibraryCssClasses()

setLibraryCssClasses

void setLibraryCssClasses(List<String> libraryCssClasses)

getCssClasses

List<String> getCssClasses()

CSS style class(s) to be applied to the component

Declares style classes for the component. Multiple classes are specified with a space delimiter. This is used by the renderer to set the class attribute on the corresponding element. The class(s) declared must be available in the common style sheets or the style sheets specified for the view

Returns:

List css style classes to appear on the 'class' attribute

setCssClasses

void setCssClasses(List<String> styleClasses)

Setter for the components style classes

Parameters:

styleClasses -

getAdditionalCssClasses

List<String> getAdditionalCssClasses()

Convenience property for adding css class names to the end of the list of cssClasses that may already exist on this Component (this is to avoid explicitly having to set list merge in the bean definition)

Returns:

the additionalCssClasses

setAdditionalCssClasses

void setAdditionalCssClasses(List<String> styleClasses)

Set the additionalCssClasses

Parameters:

styleClasses -

addStyleClass

void addStyleClass(String styleClass)

Adds a single style to the list of styles on this component

Parameters:

styleClass -

appendToStyle

void appendToStyle(String itemStyle)

Appends to the inline style set on a component

Parameters:

itemStyle -

getColSpan

int getColSpan()

Number of places the component should take up horizontally in the container

All components belong to a Container and are placed using a LayoutManager. This property specifies how many places horizontally the component should take up within the container. This is only applicable for table based layout managers. Default is 1

TODO: this should not be on component interface since it only applies if the layout manager supports it, need some sort of layoutOptions map for field level options that depend on the manager

Returns:

int number of columns to span

setColSpan

void setColSpan(int colSpan)

Setter for the components column span

Parameters:

colSpan -

getRowSpan

int getRowSpan()

Number of places the component should take up vertically in the container

All components belong to a Container and are placed using a LayoutManager. This property specifies how many places vertically the component should take up within the container. This is only applicable for table based layout managers. Default is 1

TODO: this should not be on component interface since it only applies if the layout manager supports it, need some sort of layoutOptions map for field level options that depend on the manager

Returns:

int number of rows to span

setRowSpan

void setRowSpan(int rowSpan)

Setter for the component row span

Parameters:

rowSpan -

getWrapperCssClasses

List<String> getWrapperCssClasses()

The cellCssClasses property defines the classes that will be placed on the corresponding td (or th) elements relating to this component when used in a table backed layout. This property has no effect on other layouts.

Returns:

the css classes to apply to the wrapping td (or th) element for this component

setWrapperCssClasses

void setWrapperCssClasses(List<String> cellCssClasses)

Set the cellCssClasses property which defines the classes that will be placed on the corresponding td (or th) relating to this component when used in a table backed layout. This property has no effect on other layouts.

Parameters:

cellCssClasses -

addWrapperCssClass

void addWrapperCssClass(String cssClass)

Add a cell css class to the cell classes list

Parameters:

cssClass - the name of the class to add

getWrapperStyle

String getWrapperStyle()

CSS style string to be applied to the cell containing the component (only applies within table based layouts)

e.g. 'align: right;'

Returns:

String css style string

setWrapperStyle

void setWrapperStyle(String cellStyle)

Setter for the cell style attribute

Parameters:

cellStyle -

getCellWidth

String getCellWidth()

Width setting for the cell containing the component (only applies within table based layouts)

Returns:

String width ('25%', '155px')

setCellWidth

void setCellWidth(String cellWidth)

Setter for the containing cell width

Parameters:

cellWidth -

getPropertyReplacers

List<PropertyReplacer> getPropertyReplacers()

gets a list of PropertyReplacer instances

They will be evaluated during the view lifecycle to conditionally set properties on the Component based on expression evaluations

Returns:

List replacers to evaluate

setPropertyReplacers

void setPropertyReplacers(List<PropertyReplacer> propertyReplacers)

Setter for the components property substitutions

Parameters:

propertyReplacers -

getTemplateOptions

Map<String,String> getTemplateOptions()

The options that are passed through to the Component renderer

The Map key is the option name, with the Map value as the option value. See documentation on the particular widget render for available options.

Returns:

Map options

setTemplateOptions

void setTemplateOptions(Map<String,String> templateOptions)

Setter for the template's options

Parameters:

templateOptions -

getTemplateOptionsJSString

String getTemplateOptionsJSString()

Builds a string from the underlying Map of template options that will export that options as a JavaScript Map for use in js and jQuery plugins

See documentation on the particular component render for available options.

Returns:

String options

setTemplateOptionsJSString

void setTemplateOptionsJSString(String templateOptionsJSString)

Setter for the template's options

Parameters:

templateOptionsJSString -

getOrder

int getOrder()

Order of a component within a List of other components

Lower numbers are placed higher up in the list, while higher numbers are placed lower in the list

Specified by:

getOrder in interface org.springframework.core.Ordered

Returns:

int ordering number

See Also:

Ordered.getOrder()

setOrder

void setOrder(int order)

Setter for the component's order

Parameters:

order -

See Also:

Ordered.getOrder()

getToolTip

Tooltip getToolTip()

The Tooltip widget that renders a tooltip with additional information about the element on specified trigger event

Returns:

Tooltip

setToolTip

void setToolTip(Tooltip toolTip)

Setter for the component tooltip widget instance

Parameters:

toolTip -

getEventHandlerScript

String getEventHandlerScript()

String containing JavaScript code for registering event handlers for this component (blur, focus, click, etc.)

Returns:

JS event handler script

getFinalizeMethodToCall

String getFinalizeMethodToCall()

The name of the method that should be invoked for finalizing the component configuration (full method name, without parameters or return type)

Note the method can also be set with the finalizeMethodInvoker targetMethod property. If the method is on the configured ViewHelperService, only this property needs to be configured

The model backing the view will be passed as the first argument method and then the Component instance as the second argument. If any additional method arguments are declared with the finalizeMethodAdditionalArguments, they will then be passed in the order declared in the list

If the component is selfRendered, the finalize method can return a string which will be set as the component's renderOutput. The selfRendered indicator will also be set to true on the component.

Returns:

String method name

getFinalizeMethodAdditionalArguments

List<Object> getFinalizeMethodAdditionalArguments()

The List of Object instances that should be passed as arguments to the finalize method

These arguments are passed to the finalize method after the standard model and component arguments. They are passed in the order declared in the list

Returns:

List