Package com.day.cq.wcm.api.components
Interface EditConfig
-
- All Superinterfaces:
ComponentEditConfig,JSONItem
- All Known Implementing Classes:
CustomEditConfig
public interface EditConfig extends ComponentEditConfig
Defines the edit control configuration. A JSON serialized form needs to be written to the response when drawing the 'edit control'. Note that modifications to the config are never persisted and applied to the final, merged config. Be aware when modifying a parent config that the changes can propagate to the successive children.
-
-
Field Summary
Fields Modifier and Type Field Description static StringLISTENER_AFTERCREATEName of the edit listener that is invoked after a new component was created.static StringLISTENER_AFTERDELETEName of the edit listener that is invoked after a component was deleted.static StringLISTENER_AFTEREDITName of the edit listener that is invoked after a component was edited (and modified).static StringLISTENER_AFTERINSERTName of the edit listener that is invoked after a component was inserted in this container component.static StringLISTENER_AFTERMOVEName of the edit listener that is invoked after a component was moved within this container component.static StringLISTENER_AFTERREMOVEName of the edit listener that is invoked after a component was removed from this container component.static StringREFRESH_PAGEPredefined key for the 'CQ.wcm.EditBase.refreshPage' listener.static StringREFRESH_PARENTPredefined key for the 'CQ.wcm.EditBase.refreshParent' listener.static StringREFRESH_SELFPredefined key for the 'CQ.wcm.EditBase.refreshSelf' listener.
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Map<String,DropTarget>getDropTargets()Returns amap of configurations of drop targets.Map<String,Object>getFormParameterMap()Returns the additional form parameters to be included in the dialog.Map<String,String>getFormParameters()Returns a modifiable map for additional form parameters to be included in the dialog.Map<String,String>getListeners()Returns a modifiable map of edit listenersToolbargetToolbar()Returns the (modifiable) toolbar for the editbar/menu.voidsetDeepCancel(Boolean deepCancel)Sets if cancelling inheritance of the component sets the cq:isCancelledForChildren flag or not.voidsetDialogMode(DialogMode mode)Sets the dialog modevoidsetEmpty(boolean empty)Sets theemptyflag.voidsetEmptyText(String text)Sets the text to be displayed whenComponentEditConfig.isEmpty()istrue.voidsetInplaceEditingConfig(InplaceEditingConfig inplaceEditingConfig)Sets the inplace editing configuration.voidsetInsertBehavior(String behavior)Sets the insert behaviorvoidsetLayout(EditLayout layout)Sets the edit layout for the edit control widget.voidsetLiveRelationship(JSONItem liveRelationship)Set the computed live relationship of the component TODO seems like we are only considering this as an additional JSONItem to render - if that's confirmed we might rename this method.voidsetOrderable(Boolean orderable)Sets if the edited component is orderable.-
Methods inherited from interface com.day.cq.wcm.api.components.ComponentEditConfig
getDialogMode, getEmptyText, getInplaceEditingConfig, getInsertBehavior, getLayout, getLiveRelationship, isDeepCancel, isDefault, isEmpty, isOrderable, isTargetingDisabled
-
-
-
-
Field Detail
-
LISTENER_AFTERCREATE
static final String LISTENER_AFTERCREATE
Name of the edit listener that is invoked after a new component was created.- See Also:
getListeners(), Constant Field Values
-
LISTENER_AFTEREDIT
static final String LISTENER_AFTEREDIT
Name of the edit listener that is invoked after a component was edited (and modified).- See Also:
getListeners(), Constant Field Values
-
LISTENER_AFTERDELETE
static final String LISTENER_AFTERDELETE
Name of the edit listener that is invoked after a component was deleted.- See Also:
getListeners(), Constant Field Values
-
LISTENER_AFTERINSERT
static final String LISTENER_AFTERINSERT
Name of the edit listener that is invoked after a component was inserted in this container component.- See Also:
getListeners(), Constant Field Values
-
LISTENER_AFTERREMOVE
static final String LISTENER_AFTERREMOVE
Name of the edit listener that is invoked after a component was removed from this container component.- See Also:
getListeners(), Constant Field Values
-
LISTENER_AFTERMOVE
static final String LISTENER_AFTERMOVE
Name of the edit listener that is invoked after a component was moved within this container component.- See Also:
getListeners(), Constant Field Values
-
REFRESH_PAGE
static final String REFRESH_PAGE
Predefined key for the 'CQ.wcm.EditBase.refreshPage' listener.- See Also:
getListeners(), Constant Field Values
-
REFRESH_SELF
static final String REFRESH_SELF
Predefined key for the 'CQ.wcm.EditBase.refreshSelf' listener.- See Also:
getListeners(), Constant Field Values
-
REFRESH_PARENT
static final String REFRESH_PARENT
Predefined key for the 'CQ.wcm.EditBase.refreshParent' listener.- See Also:
getListeners(), Constant Field Values
-
-
Method Detail
-
setLayout
void setLayout(EditLayout layout)
Sets the edit layout for the edit control widget.- Parameters:
layout- edit layout
-
getDropTargets
Map<String,DropTarget> getDropTargets()
Returns amap of configurations of drop targets. the keys are the ids of the configs. Note that the map is modifiable and can be used to extend the drop targets dynamically.- Specified by:
getDropTargetsin interfaceComponentEditConfig- Returns:
- map of drop target configurations.
-
setDialogMode
void setDialogMode(DialogMode mode)
Sets the dialog mode- Parameters:
mode- the mode
-
setInplaceEditingConfig
void setInplaceEditingConfig(InplaceEditingConfig inplaceEditingConfig)
Sets the inplace editing configuration.- Parameters:
inplaceEditingConfig- The inplace editing configuration- Since:
- 5.3
-
setInsertBehavior
void setInsertBehavior(String behavior)
Sets the insert behavior- Parameters:
behavior- the behavior
-
setEmpty
void setEmpty(boolean empty)
Sets theemptyflag. Iftruethis indicates that the component has not visual content and a placeholder text should be rendered.- Parameters:
empty-trueif a placeholder text should be rendered.
-
setEmptyText
void setEmptyText(String text)
Sets the text to be displayed whenComponentEditConfig.isEmpty()istrue. Iftextisnullthen the default text is displayed.- Parameters:
text- the text ornull
-
setOrderable
void setOrderable(Boolean orderable)
Sets if the edited component is orderable.- Parameters:
orderable-trueto enable ordering ornullif the behavior is defined by the widgets.
-
getToolbar
Toolbar getToolbar()
Returns the (modifiable) toolbar for the editbar/menu.- Specified by:
getToolbarin interfaceComponentEditConfig- Returns:
- toolbar
-
getFormParameters
Map<String,String> getFormParameters()
Returns a modifiable map for additional form parameters to be included in the dialog.- Specified by:
getFormParametersin interfaceComponentEditConfig- Returns:
- map of additional form parameters
-
getFormParameterMap
Map<String,Object> getFormParameterMap()
Returns the additional form parameters to be included in the dialog. This method allows to use multi value properties for form parameters.- Specified by:
getFormParameterMapin interfaceComponentEditConfig- Returns:
- map of additional form parameters
-
getListeners
Map<String,String> getListeners()
Returns a modifiable map of edit listeners- Specified by:
getListenersin interfaceComponentEditConfig- Returns:
- map of edit listeners
-
setLiveRelationship
void setLiveRelationship(JSONItem liveRelationship)
Set the computed live relationship of the component TODO seems like we are only considering this as an additional JSONItem to render - if that's confirmed we might rename this method.- Parameters:
liveRelationship- the relationship to set
-
setDeepCancel
void setDeepCancel(Boolean deepCancel)
Sets if cancelling inheritance of the component sets the cq:isCancelledForChildren flag or not.- Parameters:
deepCancel-trueif cancel sets the flag ornullif cancel does not set the flag.
-
-