Package org.opencms.gwt.client.ui.input
Class CmsCategoryField
java.lang.Object
com.google.gwt.user.client.ui.UIObject
com.google.gwt.user.client.ui.Widget
com.google.gwt.user.client.ui.Composite
org.opencms.gwt.client.ui.input.CmsCategoryField
- All Implemented Interfaces:
com.google.gwt.event.logical.shared.HasAttachHandlers
,com.google.gwt.event.shared.HasHandlers
,com.google.gwt.user.client.EventListener
,com.google.gwt.user.client.ui.HasVisibility
,com.google.gwt.user.client.ui.IsRenderable
,com.google.gwt.user.client.ui.IsWidget
,I_CmsHasInit
,I_CmsHasResizeOnShow
,I_CmsFormWidget
public class CmsCategoryField
extends com.google.gwt.user.client.ui.Composite
implements I_CmsFormWidget, I_CmsHasInit, I_CmsHasResizeOnShow
Basic category widget for forms.
- Since:
- 8.0.0
-
Nested Class Summary
Modifier and TypeClassDescriptionprotected class
Selection handler to handle check box click events and double clicks on the list items.Nested classes/interfaces inherited from class com.google.gwt.user.client.ui.UIObject
com.google.gwt.user.client.ui.UIObject.DebugIdImpl, com.google.gwt.user.client.ui.UIObject.DebugIdImplEnabled
Nested classes/interfaces inherited from interface org.opencms.gwt.client.ui.input.I_CmsFormWidget
I_CmsFormWidget.FieldType
-
Field Summary
Fields inherited from class com.google.gwt.user.client.ui.UIObject
DEBUG_ID_PREFIX
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
buildCategoryTree
(List<org.opencms.gwt.shared.CmsCategoryTreeEntry> treeEntries, Collection<String> selectedCategories) Builds and shows the category tree.Returns the site path of all shown categories.Returns the "apparent value", i.e.Returns the type of data this widget produces.Gets the selected/entered value from the widget.Gets the current value of the widget as a string.Returns the scroll panel of this widget.Returns the site path of the last category.int
Returns the count of values set to show.static void
Initializes this class.boolean
Returnstrue
if this widget is enabled.static boolean
isParentCategoryOfSelected
(String category, Collection<String> selection) Checks if the given category is a parent category of any element of the given selection.protected void
onAttach()
void
reset()
Resets the widget to its default state.void
Adjusts widget's size once it's visible.void
setAutoHideParent
(I_CmsAutoHider autoHideParent) Call this when auto hiding parents are shown.void
setEnabled
(boolean enabled) Enables or disables the widget.void
setErrorMessage
(String errorMessage) Sets the error message for this widget.void
setFormValueAsString
(String value) Sets the current value of the widget as a string.void
setHeight
(int height) Sets the height of this category field.void
setParentSelection
(boolean value) Sets if the parent category should be selected with the child or not.void
setSelected
(Object value) Sets the value of the widget.void
setSelectedAsString
(String newValue) Set the selected categories.Methods inherited from class com.google.gwt.user.client.ui.Composite
claimElement, getWidget, initializeClaimedElement, initWidget, isAttached, onBrowserEvent, onDetach, render, render, resolvePotentialElement, setWidget
Methods inherited from class com.google.gwt.user.client.ui.Widget
addAttachHandler, addBitlessDomHandler, addDomHandler, addHandler, asWidget, asWidgetOrNull, createHandlerManager, delegateEvent, doAttachChildren, doDetachChildren, fireEvent, getHandlerCount, getLayoutData, getParent, isOrWasAttached, onLoad, onUnload, removeFromParent, setLayoutData, sinkEvents, unsinkEvents
Methods inherited from class com.google.gwt.user.client.ui.UIObject
addStyleDependentName, addStyleName, ensureDebugId, ensureDebugId, ensureDebugId, getAbsoluteLeft, getAbsoluteTop, getElement, getOffsetHeight, getOffsetWidth, getStyleElement, getStyleName, getStyleName, getStylePrimaryName, getStylePrimaryName, getTitle, isVisible, isVisible, onEnsureDebugId, removeStyleDependentName, removeStyleName, setElement, setElement, setHeight, setPixelSize, setSize, setStyleDependentName, setStyleName, setStyleName, setStyleName, setStyleName, setStylePrimaryName, setStylePrimaryName, setTitle, setVisible, setVisible, setWidth, sinkBitlessEvent, toString
-
Constructor Details
-
CmsCategoryField
public CmsCategoryField()Category field widgets for ADE forms.
-
-
Method Details
-
initClass
Initializes this class. -
isParentCategoryOfSelected
Checks if the given category is a parent category of any element of the given selection.The selection might contain either category paths or site paths of categories.
- Parameters:
category
- a category pathselection
- a set containing either category paths or category site paths- Returns:
- true if the category is a parent category of any element of the given selection
-
buildCategoryTree
public void buildCategoryTree(List<org.opencms.gwt.shared.CmsCategoryTreeEntry> treeEntries, Collection<String> selectedCategories) Builds and shows the category tree.- Parameters:
treeEntries
- List of category entriesselectedCategories
- a list of all selected categories
-
getAllSitePath
Returns the site path of all shown categories.- Returns:
- the site path of all shown categories
-
getApparentValue
Description copied from interface:I_CmsFormWidget
Returns the "apparent value", i.e. either the real value if available, or else the ghost value if available, or null otherwise.- Specified by:
getApparentValue
in interfaceI_CmsFormWidget
- Returns:
- the apparent value
- See Also:
-
getFieldType
Description copied from interface:I_CmsFormWidget
Returns the type of data this widget produces.- Specified by:
getFieldType
in interfaceI_CmsFormWidget
- Returns:
- the data type
- See Also:
-
getFormValue
Description copied from interface:I_CmsFormWidget
Gets the selected/entered value from the widget.- Specified by:
getFormValue
in interfaceI_CmsFormWidget
- Returns:
- the value
- See Also:
-
getFormValueAsString
Description copied from interface:I_CmsFormWidget
Gets the current value of the widget as a string.- Specified by:
getFormValueAsString
in interfaceI_CmsFormWidget
- Returns:
- the current value of the widget
- See Also:
-
getScrollPanel
Returns the scroll panel of this widget.- Returns:
- the scroll panel
-
getSingelSitePath
Returns the site path of the last category.- Returns:
- the site path of the last category
-
getValuesSet
Returns the count of values set to show.- Returns:
- the count of values set to show
-
isEnabled
Description copied from interface:I_CmsFormWidget
Returnstrue
if this widget is enabled.- Specified by:
isEnabled
in interfaceI_CmsFormWidget
- Returns:
true
if this widget is enabled- See Also:
-
reset
Description copied from interface:I_CmsFormWidget
Resets the widget to its default state.- Specified by:
reset
in interfaceI_CmsFormWidget
- See Also:
-
resizeOnShow
Description copied from interface:I_CmsHasResizeOnShow
Adjusts widget's size once it's visible.- Specified by:
resizeOnShow
in interfaceI_CmsHasResizeOnShow
- See Also:
-
setAutoHideParent
Description copied from interface:I_CmsFormWidget
Call this when auto hiding parents are shown.- Specified by:
setAutoHideParent
in interfaceI_CmsFormWidget
- Parameters:
autoHideParent
- the auto hide parent- See Also:
-
setEnabled
Description copied from interface:I_CmsFormWidget
Enables or disables the widget.- Specified by:
setEnabled
in interfaceI_CmsFormWidget
- Parameters:
enabled
- if true, the widget will be enabled, else disabled- See Also:
-
setErrorMessage
Description copied from interface:I_CmsFormWidget
Sets the error message for this widget.If the error message is null, no error message will be displayed.
- Specified by:
setErrorMessage
in interfaceI_CmsFormWidget
- Parameters:
errorMessage
- an error message or null- See Also:
-
setFormValueAsString
Description copied from interface:I_CmsFormWidget
Sets the current value of the widget as a string.- Specified by:
setFormValueAsString
in interfaceI_CmsFormWidget
- Parameters:
value
- the new value of the widget- See Also:
-
setHeight
Sets the height of this category field.- Parameters:
height
- the height of this category field
-
setParentSelection
Sets if the parent category should be selected with the child or not.- Parameters:
value
- if the parent categories should be selected or not
-
setSelected
Sets the value of the widget.- Parameters:
value
- the new value
-
setSelectedAsString
Set the selected categories.- Parameters:
newValue
- String of selected categories separated by '|'
-
onAttach
- Overrides:
onAttach
in classcom.google.gwt.user.client.ui.Composite
- See Also:
-
Composite.onAttach()
-