org.opencms.widgets

接口 I_CmsWidget

所有已知子接口:

I_CmsADEWidget

所有已知实现类:

A_CmsAdeGalleryWidget, A_CmsFormatterWidget, A_CmsGalleryWidget, A_CmsHtmlGalleryWidget, A_CmsHtmlWidget, A_CmsSelectWidget, A_CmsWidget, CmsAddFormatterWidget, CmsAdeDownloadGalleryWidget, CmsAdeImageGalleryWidget, CmsCalendarWidget, CmsCategoryWidget, CmsCheckboxWidget, CmsColorpickerWidget, CmsComboWidget, CmsDisplayWidget, CmsDownloadGalleryWidget, CmsGroupWidget, CmsHtmlGalleryWidget, CmsHtmlWidget, CmsHttpUploadWidget, CmsImageGalleryWidget, CmsInputWidget, CmsInputWidgetPlaintext, CmsLinkGalleryWidget, CmsLocalizationWidget, CmsMultiSelectGroupWidget, CmsMultiSelectWidget, CmsOrgUnitWidget, CmsPasswordWidget, CmsPrincipalWidget, CmsRadioSelectWidget, CmsRemoveFormatterWidget, CmsSelectGroupWidget, CmsSelectOnChangeReloadWidget, CmsSelectWidget, CmsTableGalleryWidget, CmsTextareaWidget, CmsTextareaWidgetPlaintext, CmsTinyMCEWidget, CmsTypeComboWidget, CmsUserWidget, CmsVfsFileWidget, CmsVfsImageWidget

public interface I_CmsWidget

Describes an editor widget for use in the OpenCms workplace.

从以下版本开始:

6.0.0

方法概要

方法

限定符和类型	方法和说明
java.lang.String	getConfiguration() Returns the configuration string.
java.lang.String	getDialogHtmlEnd(CmsObject cms, I_CmsWidgetDialog widgetDialog, I_CmsWidgetParameter param) Generates the html to include at the end of the dialog for this widget.
java.lang.String	getDialogIncludes(CmsObject cms, I_CmsWidgetDialog widgetDialog) Generates the necessary JavaScript inclusion code for this widget.
java.lang.String	getDialogInitCall(CmsObject cms, I_CmsWidgetDialog widgetDialog) Generates the initialisation method JavaScript code for this widget.
java.lang.String	getDialogInitMethod(CmsObject cms, I_CmsWidgetDialog widgetDialog) Generates the initialization method JavaScript code for this widget.
java.lang.String	getDialogWidget(CmsObject cms, I_CmsWidgetDialog widgetDialog, I_CmsWidgetParameter param) Generates the widget HTML for the provided widget parameter.
java.lang.String	getHelpBubble(CmsObject cms, I_CmsWidgetDialog widgetDialog, I_CmsWidgetParameter param) Creates the HTML code for the help bubble for this widget.
java.lang.String	getHelpText(I_CmsWidgetDialog widgetDialog, I_CmsWidgetParameter value) Creates a HTML <div> containing the help text for this widget.
java.lang.String	getWidgetStringValue(CmsObject cms, I_CmsWidgetDialog widgetDialog, I_CmsWidgetParameter param) Returns the I_CmsWidgetParameter.getStringValue(CmsObject) processed according to the output rules of this widget and the given widget dialog.
boolean	isCompactViewEnabled() Returns if the widget is compact view enabled.
I_CmsWidget	newInstance() Creates a duplicate of this widget instance.
void	setConfiguration(java.lang.String configuration) Sets the configuration of this widget.
void	setEditorValue(CmsObject cms, java.util.Map<java.lang.String,java.lang.String[]> formParameters, I_CmsWidgetDialog widgetDialog, I_CmsWidgetParameter param) Sets the value of in the given widget parameter by reading the "right" value from the offered map of parameters.

方法详细资料

getConfiguration

java.lang.String getConfiguration()

Returns the configuration string.

This can be used to enable / disable certain widget features that should not always be available, or to pass specific initialization information to the widget. It depends on the widget implementation on how this information is used.

返回:

the configuration string

getDialogHtmlEnd

java.lang.String getDialogHtmlEnd(CmsObject cms,
                                I_CmsWidgetDialog widgetDialog,
                                I_CmsWidgetParameter param)

Generates the html to include at the end of the dialog for this widget.

The "help bubble" text div's are added using this method.

参数:

cms - the current users OpenCms context

widgetDialog - the dialog where the widget is used on

param - the widget parameter to generate the widget for

返回:

the html to include at the end of the dialog for this widget

getDialogIncludes

java.lang.String getDialogIncludes(CmsObject cms,
                                 I_CmsWidgetDialog widgetDialog)

Generates the necessary JavaScript inclusion code for this widget.

参数:

cms - the current users OpenCms context

widgetDialog - the dialog where the widget is used on

返回:

the JavaScript inclusion code

getDialogInitCall

java.lang.String getDialogInitCall(CmsObject cms,
                                 I_CmsWidgetDialog widgetDialog)

Generates the initialisation method JavaScript code for this widget.

参数:

cms - the current users OpenCms context

widgetDialog - the dialog where the widget is used on

返回:

the initialisation method JavaScript code

getDialogInitMethod

java.lang.String getDialogInitMethod(CmsObject cms,
                                   I_CmsWidgetDialog widgetDialog)

Generates the initialization method JavaScript code for this widget.

参数:

cms - an initialized instance of a CmsObject

widgetDialog - the dialog where the widget is used on

返回:

the initialization method JavaScript code

getDialogWidget

java.lang.String getDialogWidget(CmsObject cms,
                               I_CmsWidgetDialog widgetDialog,
                               I_CmsWidgetParameter param)

Generates the widget HTML for the provided widget parameter.

参数:

cms - an initialized instance of a CmsObject

widgetDialog - the dialog where the widget is used on

param - the widget parameter to generate the widget for

返回:

the widget HTML for the provided widget parameter

getHelpBubble

java.lang.String getHelpBubble(CmsObject cms,
                             I_CmsWidgetDialog widgetDialog,
                             I_CmsWidgetParameter param)

Creates the HTML code for the help bubble for this widget.

参数:

cms - the current users OpenCms context

widgetDialog - the dialog where the widget is used on

param - the widget parameter to generate the widget for

返回:

the HTML code for the help bubble for this widget

getHelpText

java.lang.String getHelpText(I_CmsWidgetDialog widgetDialog,
                           I_CmsWidgetParameter value)

Creates a HTML <div> containing the help text for this widget.

参数:

widgetDialog - the dialog where the widget is used on

value - the value to create the help bubble for

返回:

a HTML <div> containing the help text for this widget

getWidgetStringValue

java.lang.String getWidgetStringValue(CmsObject cms,
                                    I_CmsWidgetDialog widgetDialog,
                                    I_CmsWidgetParameter param)

Returns the I_CmsWidgetParameter.getStringValue(CmsObject) processed according to the output rules of this widget and the given widget dialog.

参数:

cms - the current users OpenCms context

widgetDialog - the dialog where the widget is used on

param - the widget parameter to generate the widget for

返回:

the I_CmsWidgetParameter.getStringValue(CmsObject) processed according to the output rules of this widget

另请参阅:

I_CmsWidgetParameter.getStringValue(CmsObject), I_CmsXmlContentValue.getStringValue(CmsObject)

isCompactViewEnabled

boolean isCompactViewEnabled()

Returns if the widget is compact view enabled.

返回:

true if the widget is compact view enabled

newInstance

I_CmsWidget newInstance()

Creates a duplicate of this widget instance.

返回:

a duplicate of this widget instance

setConfiguration

void setConfiguration(java.lang.String configuration)

Sets the configuration of this widget.

This can be used to enable / disable certain widget features that should not always be available, or to pass specific initialization information to the widget. It depends on the widget implementation on how this information is used.

参数:

configuration - the configuration to set

setEditorValue

void setEditorValue(CmsObject cms,
                  java.util.Map<java.lang.String,java.lang.String[]> formParameters,
                  I_CmsWidgetDialog widgetDialog,
                  I_CmsWidgetParameter param)

Sets the value of in the given widget parameter by reading the "right" value from the offered map of parameters.

参数:

cms - the current users OpenCms context

formParameters - the map of parameters to get the value from

widgetDialog - the dialog where the widget is used on

param - the widget parameter to generate the widget for