| Package: | CQ |
| Class: | WCM |
| Extends: | Object |
| Clientlib: | cq.widgets |
| Property | Defined By | |
|---|---|---|
|
ACTION_COPY : String
<static> The action when an item gets added to the clipboard by copying
(Ctrl + C).
|
WCM | |
|
ACTION_CUT : String
<static> The action when an item gets added to the clipboard by cutting
(Ctrl + X).
|
WCM | |
|
EDITABLE_SCRIPT_FINDER : String <static> String used to find the DOM script tag corresponding to an editable path.
$PATH$ is replaced by the ed...
<static> String used to find the DOM script tag corresponding to an editable path.
$PATH$ is replaced by the editable path.
|
WCM | |
|
LAYERS_COOKIE : String
<static> The name of the cookie holding the layers.
|
WCM | |
|
LAYERS_COOKIE_PATH : String
<static> The path for the cookie holding the layers.
|
WCM | |
|
LAYER_LCSTATUS : String
<static> The name of the layer for the Live Copy status.
|
WCM | |
|
MODE_ANALYTICS : String
<static> The value for the analytics mode.
|
WCM | |
|
MODE_COOKIE : String
<static> The name of the cookie holding the mode.
|
WCM | |
|
MODE_COOKIE_PATH : String
<static> The path for of the cookie holding the mode.
|
WCM | |
|
MODE_DESIGN : String
<static> The value for the design mode.
|
WCM | |
|
MODE_EDIT : String
<static> The value for the edit mode.
|
WCM | |
|
MODE_PREVIEW : String
<static> The value for the preview mode.
|
WCM | |
|
MODE_TIMEWARP : String
<static> The value for the timewarp mode.
|
WCM | |
|
PREVIEW_RESPONSIVE : String
<static> The value for the responsive preview mode.
|
WCM | |
|
TIMEWARP_COOKIE : String
<static> The name of the cookie holding timewarp information.
|
WCM | |
|
altKey : Boolean
<static> True if the alt key is held down.
|
WCM | |
|
getTopWindow : Object Deprecated: since 5.5, use CQ.shared.Util.getTopWindow instead
<static> Returns the last accessible ascendant window. |
WCM | |
| Method | Defined By | |
|---|---|---|
|
areEditablesReady() : Boolean Returns if all editables of the page are ready.
Returns if all editables of the page are ready.
Added in CQ 5.4.
Parameters:
|
WCM | |
|
clearClipboard() : void <static> Clears the clipboard.
<static> Clears the clipboard.
Parameters:
|
WCM | |
copy( Object/Object[] item, [Boolean additive], [Boolean move] ) : Object <static> Copies an item to the clipboard.
<static> Copies an item to the clipboard.
Parameters:
|
WCM | |
cut( Object/Object[] item, [Boolean additive] ) : Object <static> Copies an item to the clipboard and marks it for deletion
after pasting (if the clipboard is cleared b...
<static> Copies an item to the clipboard and marks it for deletion
after pasting (if the clipboard is cleared before, the item
will not be deleted). Shorthand for copy (with move
parameter true implicitly).
Parameters:
|
WCM | |
deselect( Object item, [Boolean additive] ) : Object <static> Removes an item from the selection.
<static> Removes an item from the selection.
Parameters:
|
WCM | |
edit( Object config ) : CQ.wcm.EditBase <static> Shorthand for makeEditable.
<static> Shorthand for makeEditable.
Parameters:
|
WCM | |
|
endMakeEditablesQueue() : void Ends the queue mode for the makeEditable: all queued editable configs will be built and
editables created.
Ends the queue mode for the makeEditable: all queued editable configs will be built and
editables created.
Parameters:
|
WCM | |
|
getClipboardRecords() : Object[] <static> Returns the items in the clipboard as Records.
This method does not remove cut items from the clipboar...
|
WCM | |
getComponentConfig( String resourceType ) : Object <static> Returns the page-specific config of the component with the
specified resource type.
<static> Returns the page-specific config of the component with the
specified resource type.
Parameters:
|
WCM | |
getComponentList( String path ) : CQ.wcm.ComponentList <static> Returns a ComponentList object for the specified page. If path is
null, the component list of the curr...
<static> Returns a ComponentList object for the specified page. If path is
null, the component list of the current page is returned.
Parameters:
|
WCM | |
getContainerStepOptions( String path, Object record ) : Object[] <static> Returns workflow model options. The list of workflow models is slightly modified in a way, that it exc...
<static> Returns workflow model options. The list of workflow models is slightly modified in a way, that it excludes the
defining model itself. This reduces (but not completely prevents) the building of workflow loops.
The method parameters follow the signature of the optionsProvider interface.
Added in CQ 5.4.
Parameters:
|
WCM | |
|
getContentFinder() : CQ.wcm.ContentFinder <static> Returns the Content Finder (or
null if none is available).
<static> Returns the Content Finder (or
null if none is available).
Parameters:
|
WCM | |
|
getContentUrl() : String <static> Returns the URL of the content window, independent of the
presence of the Content Finder.
<static> Returns the URL of the content window, independent of the
presence of the Content Finder.
Parameters:
|
WCM | |
|
getContentWindow() : Window <static> Returns the window of the content page, independent of the
presence of the Content Finder.
<static> Returns the window of the content page, independent of the
presence of the Content Finder.
Parameters:
|
WCM | |
getDesign( String path ) : CQ.wcm.Design <static> Returns a design object of the page that is specified by path.
<static> Returns a design object of the page that is specified by path.
Parameters:
|
WCM | |
getDialog( String/Object config, [String key], [Boolean nocreate] ) : CQ.Dialog <static> Creates and/or returns a Dialog using the
specified configuration (which may also be a URL serving one...
<static> Creates and/or returns a Dialog using the
specified configuration (which may also be a URL serving one of the
configurations below).
Single Panel:
Add a title to create a TabPanel with a single Panel:
An entire TabPanel:
An entire Dialog (e.g. with a Tab Panel):
The entire dialog config accepts all dialog specific config options:
Parameters:
|
WCM | |
getDialogConfig( String/Object config ) : Object <static> Completes and returns the specified dialog config (see
getDialog for options).
<static> Completes and returns the specified dialog config (see
getDialog for options).
Parameters:
|
WCM | |
|
getDialogs() : Object <static> Returns all dialogs of the content page.
<static> Returns all dialogs of the content page.
Parameters:
|
WCM | |
|
getDropTargetComponents() : CQ.Ext.Component[] Gets an array of all currently registered components that work as external drop
targets.
Gets an array of all currently registered components that work as external drop
targets.
Added in CQ 5.3.
Parameters:
|
WCM | |
getEditable( String path ) : CQ.wcm.EditBase <static> Returns the edit component for the specified content path.
Example:
var editBar = CQ.WCM.getEditable("...
<static> Returns the edit component for the specified content path.
Example:
Edit components must be registered using makeEditable.
Parameters:
|
WCM | |
getEditableFromDOM( Node element ) : void Finds the next editable which "contains" the given element.
Note that this only returns final editables. Use getEdita...
Finds the next editable which "contains" the given element.
Note that this only returns final editables. Use getEditablePathFromDOM
if you want to get the path of an editable, which works as soon as the editable
was registered using makeEditable.
Parameters:
|
WCM | |
getEditablePathFromDOM( Node element ) : void Finds the path of the next editable which "contains" the given element.
This will return the path even if an editable...
Finds the path of the next editable which "contains" the given element.
This will return the path even if an editable is already registered
using makeEditable but not yet fully built as ext component. In this case
a following call to CQ.WCM.getEditable(foundPath) would return null, since the
final editable has not been created yet.
Parameters:
|
WCM | |
|
getEditables() : Object <static> Returns all edit components of the content page.
<static> Returns all edit components of the content page.
Parameters:
|
WCM | |
|
getLanguageOptions() : Object[] <static> Returns the available languages as options. This method can be used
directly as CQ.Selection.optionsPr...
<static> Returns the available languages as options. This method can be used
directly as CQ.Selection.optionsProvider to draw a language
selector.
Added in CQ 5.3.
Parameters:
|
WCM | |
|
getLayers() : Object <static> Returns all layers of the content page.
<static> Returns all layers of the content page.
Parameters:
|
WCM | |
getMode( [Boolean force] ) : String <static> Returns either the current WCM mode: MODE_EDIT,
MODE_PREVIEW and MODE_DESIGN,
or MODE_TIMEWARP if the ...
<static> Returns either the current WCM mode: MODE_EDIT,
MODE_PREVIEW and MODE_DESIGN,
or MODE_TIMEWARP if the TIMEWARP_COOKIE is set.
Parameters:
|
WCM | |
getNestedEditables( String path ) : String[] <static> Returns all the path of the CQ.wcm.EditBase nested into the given content path.
Example:
var nestedCmp...
<static> Returns all the path of the CQ.wcm.EditBase nested into the given content path.
Example:
Parameters:
|
WCM | |
getPage( String path, Boolean skipWorkflow ) : CQ.wcm.Page <static> Returns a page object for the specified path.
<static> Returns a page object for the specified path.
Parameters:
|
WCM | |
getPageInfo( String path, [Boolean forceLoad], [Boolean skipWorkflow] ) : Object Returns the page information for the current user.
Returns the page information for the current user.
Parameters:
|
WCM | |
getPageLanguage( String path ) : String Returns the content language of the page.
Returns the content language of the page.
Added in CQ 5.4.
Parameters:
|
WCM | |
getPageLocale( String path ) : Object Returns the content language of the page as a locale object.
Returns the content language of the page as a locale object.
Added in CQ 5.4.
Parameters:
|
WCM | |
|
getPagePath() : String <static> Returns the path of the current page usually set by launchSidekick.
If it is not set the path will be ...
<static> Returns the path of the current page usually set by launchSidekick.
If it is not set the path will be retrieved from the current window location.
Parameters:
|
WCM | |
|
getPreviewMode() : String <static> Returns the current WCM preview mode: MODE_PREVIEW
or NULL.
<static> Returns the current WCM preview mode: MODE_PREVIEW
or NULL.
Parameters:
|
WCM | |
|
getSelectedItems() : Object[] <static> Returns the items in the selection for processing. This will not
clear the selection, so this method c...
<static> Returns the items in the selection for processing. This will not
clear the selection, so this method can be called multiple times
for processing the selected items.
Parameters:
|
WCM | |
| getSidekick() : CQ.wcm.Sidekick | WCM | |
getStyleOptions( String contentPath ) : Object[] <static> Returns the styles defined by the design of the component at
the specified content path as options. Th...
<static> Returns the styles defined by the design of the component at
the specified content path as options. This method can be used
directly as CQ.Selection.optionsProvider to draw a style
selector.
Added in CQ 5.3.
Parameters:
|
WCM | |
getWorkflowPackageOptions( Object packages ) : Object[] <static> Returns the currently defined workflow packages as options. This method can be used
directly as CQ.Sel...
<static> Returns the currently defined workflow packages as options. This method can be used
directly as CQ.Selection.optionsProvider to draw a workflow package
selector.
Added in CQ 5.4.
Parameters:
|
WCM | |
|
hide() : void <static> Hides all edit components of the content page (i.e. switching to
preview mode).
<static> Hides all edit components of the content page (i.e. switching to
preview mode).
Parameters:
|
WCM | |
hideLayer( String layer ) : void <static> Hides the specified layer.
<static> Hides the specified layer.
Parameters:
|
WCM | |
hidePlaceholders( Element element ) : void <static> Hides the placeholders for the specified element.
<static> Hides the placeholders for the specified element.
Parameters:
|
WCM | |
isAnalyticsMode( [Boolean force] ) : Boolean <static> Returns true if the current WCM mode equals
MODE_ANALYTICS.
<static> Returns true if the current WCM mode equals
MODE_ANALYTICS.
Parameters:
|
WCM | |
isContentWindow( [Window win] ) : Boolean <static> Returns true if the specified window is the window displaying
the content page, independent of the pre...
<static> Returns true if the specified window is the window displaying
the content page, independent of the presence of the
Content Finder. If no window is
specified, the current window will be checked.
Parameters:
|
WCM | |
|
isContentWindowLoading() : Boolean <static> Returns true if the content window is loading.
<static> Returns true if the content window is loading.
Parameters:
|
WCM | |
isDesignMode( [Boolean force] ) : Boolean <static> Returns true if the current WCM mode equals
MODE_DESIGN.
<static> Returns true if the current WCM mode equals
MODE_DESIGN.
Parameters:
|
WCM | |
isEditMode( [Boolean force] ) : Boolean
|
WCM | |
isPreviewMode( [Boolean force] ) : Boolean <static> Returns true if the current WCM mode equals
MODE_PREVIEW.
<static> Returns true if the current WCM mode equals
MODE_PREVIEW.
Parameters:
|
WCM | |
|
isResponsiveMode() : Boolean <static> Returns true if the current WCM preview mode equals
PREVIEW_RESPONSIVE.
<static> Returns true if the current WCM preview mode equals
PREVIEW_RESPONSIVE.
Parameters:
|
WCM | |
isShownLayer( String layer ) : Boolean <static> Returns true if the specified layer is currently shown.
<static> Returns true if the specified layer is currently shown.
Parameters:
|
WCM | |
|
isSidekickReady() : Boolean Returns if the sidekick is ready, i.e. rendered and shown.
Returns if the sidekick is ready, i.e. rendered and shown.
Added in CQ 5.4.
Parameters:
|
WCM | |
isTimewarpMode( [Boolean force] ) : Boolean <static> Returns true if the TIMEWARP_COOKIE is set.
<static> Returns true if the TIMEWARP_COOKIE is set.
Parameters:
|
WCM | |
launchSidekick( [String path], Object config, Function setup ) : void <static> Creates and/or returns the Sidekick.
The Content Finder invokes this method
without a path. Later, whe...
<static> Creates and/or returns the Sidekick.
The Content Finder invokes this method
without a path. Later, when the frame itself will be loaded (or if
the page is loaded without Content Finder), path will be the
content path of the current page.
Parameters:
|
WCM | |
loadToolbar( CQ.Ext.Toolbar/Object toolbar ) : void <static> Loads the global editing toolbar with the specified
CQ.Ext.Toolbar (or a toolbar config object}.
This ...
<static> Loads the global editing toolbar with the specified
CQ.Ext.Toolbar (or a toolbar config object}.
This will override the default set of toolbar actions.
Note that you must create the toolbar in the right
context (for example: CQ.WCM.getTopWindow().CQ.Ext.Toolbar), if
you specify a toolbar instead of a config object.
Parameters:
|
WCM | |
makeEditable( Object config ) : CQ.wcm.EditBase <static> Creates an edit component using the specified configuration,
making a certain area of a content page e...
<static> Creates an edit component using the specified configuration,
making a certain area of a content page editable for authors.
Config options:
Example:
Parameters:
|
WCM | |
onClipboardChange( Function listener ) : void <static> Adds a listener to track clipboard changes.
add Listeners will
be called with the following arguments...
<static> Adds a listener to track clipboard changes.
add Listeners will
be called with the following arguments:
clear Listeners will
be called with the following arguments:
remove Listeners will
be called with the following arguments:
Parameters:
|
WCM | |
onEditableBeforeRender( Function listener, [Object scope] ) : void <static> Adds a listener that is called before the specified edit
component is rendered.
<static> Adds a listener that is called before the specified edit
component is rendered.
Parameters:
|
WCM | |
onEditableReady( Function listener, [Object scope] ) : void <static> Adds a listener that is called as soon as the specified edit
component is ready.
<static> Adds a listener that is called as soon as the specified edit
component is ready.
Parameters:
|
WCM | |
onSelectionChange( Function listener ) : void <static> Adds a listener to track selection changes.
add Listeners will
be called with the following arguments...
<static> Adds a listener to track selection changes.
add Listeners will
be called with the following arguments:
clear Listeners will
be called with the following arguments:
remove Listeners will
be called with the following arguments:
Parameters:
|
WCM | |
|
paste() : Object[] <static> Returns the items in the clipboard as an array for processing.
For copied items, this method can be ca...
<static> Returns the items in the clipboard as an array for processing.
For copied items, this method can be called multiple times,
whereas cut items can only be processed once: those must
be removed after the first paste (see remove).
Parameters:
|
WCM | |
registerDialog( CQ.Dialog dlg, String key ) : void <static> Registers the specified dialog under the specified key.
<static> Registers the specified dialog under the specified key.
Parameters:
|
WCM | |
registerDropTargetComponent( CQ.Ext.Component dropTargetComp ) : void Registers the specified Ext component that is neither part of a dialog, nor
an editable, but should nevertheless work...
Registers the specified Ext component that is neither part of a dialog, nor an editable, but should nevertheless work as a drop target. If a component is used inside a CQ.Dialog, you must not use this method, as the component is automatically detected as a valid drop target. Note that you should always explicitly unregister any component you previously registered.
Parameters:
|
WCM | |
remove( Object item ) : void <static> Removes the specified item from both the selection and the clipboard,
then attempts to remove the item...
<static> Removes the specified item from both the selection and the clipboard,
then attempts to remove the item from the content page.
Parameters:
|
WCM | |
select( Object/Object[] item, [Boolean additive], [Boolean lock] ) : Object <static> Adds an item to the selection.
<static> Adds an item to the selection.
Parameters:
|
WCM | |
setMode( String mode ) : String <static> Sets the WCM mode. Supported WCM modes are: MODE_EDIT,
MODE_PREVIEW or MODE_DESIGN.
Clears the value o...
<static> Sets the WCM mode. Supported WCM modes are: MODE_EDIT,
MODE_PREVIEW or MODE_DESIGN.
Clears the value of TIMEWARP_COOKIE.
Parameters:
|
WCM | |
setPreviewMode( String mode ) : String <static> Sets the WCM preview mode. Supported preview modes are:
PREVIEW_RESPONSIVE or NULL.
<static> Sets the WCM preview mode. Supported preview modes are:
PREVIEW_RESPONSIVE or NULL.
Parameters:
|
WCM | |
|
show() : void <static> Shows all edit components of the content page (i.e. switching to
edit mode). If the content page has b...
<static> Shows all edit components of the content page (i.e. switching to
edit mode). If the content page has been loaded in preview mode,
this method will trigger a reload.
Parameters:
|
WCM | |
showLayer( String layer ) : void <static> Shows the specified layer.
<static> Shows the specified layer.
Parameters:
|
WCM | |
showPlaceholders( Element element ) : void <static> Shows the placeholders for the specified element.
<static> Shows the placeholders for the specified element.
Parameters:
|
WCM | |
|
startMakeEditablesQueue() : void Starts the queue mode for makeEditable: all subsequent calls to makeEditable
will be queued. Only a call to endMakeEd...
Starts the queue mode for makeEditable: all subsequent calls to makeEditable
will be queued. Only a call to endMakeEditablesQueue will create the editables.
Parameters:
|
WCM | |
toggleEditables( Boolean show, String filter ) : void Toggles the editables.
Toggles the editables.
Parameters:
|
WCM | |
unClipboardChange( Function listener ) : void Removes the specified listener from clipboard change listeners.
Removes the specified listener from clipboard change listeners.
Parameters:
|
WCM | |
unSelectionChange( Function listener ) : void Removes the specified listener from selection change listeners.
Removes the specified listener from selection change listeners.
Parameters:
|
WCM | |
|
unloadToolbar() : void <static> Restores the default set of toolbar actions to the global
editing toolbar.
<static> Restores the default set of toolbar actions to the global
editing toolbar.
Parameters:
|
WCM | |
unregisterDialog( String key ) : void <static> Unregisters the dialog with the specified key.
<static> Unregisters the dialog with the specified key.
Parameters:
|
WCM | |
unregisterDropTargetComponent( CQ.Ext.Component dropTarget ) : void Unregisters the specified component as an external drop target (= a drop
target that is neither part of a dialog, nor...
Unregisters the specified component as an external drop target (= a drop target that is neither part of a dialog, nor an editable). If the specified component has not been registered before, the call to this method is ignored silently.
Parameters:
|
WCM | |
| Event | Defined By | |
|---|---|---|
editableready : ( CQ.wcm.EditBase editable ) Fires when a single editable is ready.
Not to be confused with editablesready which is called when
ALL initial page e...
Fires when a single editable is ready.
Added in CQ 5.6.
Not to be confused with editablesready which is called when ALL initial page editables are ready.
Listeners will be called with the following arguments:
|
WCM | |
editablesready : ( CQ.WCM this ) Fires when all the page editables are ready
Not to be confused with editableready which is called when
a single edita...
Fires when all the page editables are ready
Added in CQ 5.4.
Not to be confused with editableready which is called when a single editable is ready.
Listeners will be called with the following arguments:
|
WCM | |
pageinfoloaded : ( CQ.WCM this, Object pageinfo ) Fires when page info are loaded
Fires when page info are loaded
Added in CQ 5.4.
Listeners will be called with the following arguments:
|
WCM | |
sidekickready : ( CQ.WCM this, CQ.wcm.Sidekick sidekick ) Fires when the sidekick is ready
Fires when the sidekick is ready
Added in CQ 5.4.
Listeners will be called with the following arguments:
|
WCM | |
wcmmodechange : ( CQ.WCM this, Object wcmmode ) Fires when the wcm mode changed
Fires when the wcm mode changed
Added in CQ 5.5.
Listeners will be called with the following arguments:
|
WCM | |