org.ametys.core.ui

Interface ClientSideElement

All Known Subinterfaces:

ClientSideRelation, ClientSideWidget, ExplorerApplication, RightAssignmentContext

All Known Implementing Classes:

AbstractContentClientSideElement, AbstractEditorStyleMenu, AbstractPageClientSideElement, AbstractPageMenu, AbstractStaticRightAssignmentContext, AddContentToCurrentSelectionClientSideElement, AddOrgUnitToCurrentClientSideElement, AddTaskClientSideElement, AdminWelcomeClientSideElement, ApogeeGlobalSynchronizationClientSideElement, ArchiveContentClientSideElement, ArchiveMenuClientSideElement, AutomaticNewsletterClientSideElement, BlankPageClientSideElement, BlogRootClientSideElement, CalendarButtonClientSideElement, CalendarExplorerApplication, CalendarsTabClientSideElement, ChooseHierarchicalContentFileImportsClientSideElement, CollectionSelectionAwareAddTaskClientSideElement, CommentClientSideElement, ConfigClientSideElement, ConfigureServiceClientSideElement, ConsistencyClientSideElement, ConsistencyClientSideElement, ContentAlertsClientSideElement, ContentConsistencyTestClientSideElement, ContentPrivacyMenu, ContentRightAssignmentContext, ContentTypeEditorToolElement, ContentTypeRightAssignmentContext, ContentTypesGallery, ContentTypesGallery, ContentTypesMenuItem, CopyODFContentClientSideElement, DefaultExplorerApplication, DeleteContentClientSideElement, DeleteContentClientSideElement, DeleteContentClientSideElement, DeleteDataSourceClientSideElement, DeleteOrgUnitClientSideElement, DeletePageClientSideElement, DeleteWorkflowClientSideElement, DesignsMenu, EditCatalogClientSideElement, EditExtractionClientSideElement, EditWorkflowClientSideElement, ExecuteExtractionClientSideElement, ExplorerClientSideElement, ExtractionDetailsToolElement, FormEditionModeMenu, FormEntriesWorkflowStepsClientSideElement, FormsContentClientSideElement, FormWorkflowClientSideElement, GlobalSynchronizationClientSideElement, HierarchicalReferenceTableClientSideElement, HTMLExpertEditClientSideElement, ImageMenu, ImagesContainerClientSideElement, ImportModelClientSideElement, ImportSkinClientSideElement, InvitationsClientSideElement, LanguageMenu, LanguageMenu, LinkMenu, LinkPageClientSideElement, LivePageClientSideElement, LockedContentClientSideElement, LogsClientSideElement, MaintenanceTaskClientSideElement, MaintenanceTaskClientSideElement, MixinContentTypesGallery, ModelsMenu, ODFRightAssignmentContext, ODFRootClientSideElement, OpenTreeControllerClientSideElement, OrderedListMenu, PageRightAssignmentContext, PageRobotsClientSideElement, PageVisibilityClientSideElement, ParametersClientSideElement, ParaStyleClientSideElement, PlantUMLClientSideElement, PreviewPageClientSideElement, ProfileAssignmentsToolClientSideElement, ProjectSuperUserClientSideElement, RedirectPageClientSideElement, ReferenceTableRightAssignmentContext, ReferenceTablesGallery, ResourceRightAssignmentContext, RichTextConfigurationFileImportsClientSideElement, SCCClientSideElement, SCCSmartContentClientSideElement, ScheduleArchivingClientSideElement, ScheduledPageClientSideElement, ScheduledSurveyClientSideElement, SearchClientSideElement, ServerLogMessageTargetFactoryElement, ServiceMenu, SessionClientSideElement, SetContentMetadataClientSideElement, SetContentMetadataClientSideElement, SetContentViewMenu, SetOrganisationChartRootClientSideElement, SetParentContentClientSideElement, SetUserDirectoryRootClientSideElement, SimpleMenu, SimpleSearchClientSideElement, SiteSelectionAwareAddTaskClientSideElement, SkinClientSideWidget, SkinLanguageMenu, SmartContentClientSideElement, SmartContentMenu, SmartContentTypesGallery, StaticClientSideElement, StaticClientSideRelation, StaticClientSideWidget, StaticFileImportsClientSideElement, StaticMenu, StaticRichTextConfiguration.StaticRichTextConfigurationClientSideElement, StringRightAssignmentContext, SubscribersClientSideElement, SuperUserClientSideElement, SuperUserClientSideElement, SurveyClientSideElement, SurveyRightAssignmentContext, SynchronizeContentRightAssignmentContext, SystemAnnouncementClientSideElement, TableMenu, TagClientSideElement, TemplatesMenu, TemplatesMenu, ThemeColorsMenu, ThesaurusGallery, TranslationFlaggingClientSideElement, TreeToolClientSideElement, UnorderedListMenu, UserDirectoryRightAssignmentContext, ValidateSurveyClientSideElement, WebContentTypeRightAssignmentContext, WebReferenceTableRightAssignmentContext, WebStringRightAssignmentContext, WorkflowStepsClientSideElement

public interface ClientSideElement

Object binding of a client side element, ie something that is loaded and executed by the browser.
Such elements may be UI controls (buttons, menu, tools, ...) but also only JS or CSS files.

This interface only covers files to be loaded, but its implementations are also meant to hold associated business-logic, if any.
To implement such logic, implementing classes should write any method, annotated with Callable, that will be directly called by the kernel upon execution of the JavaScript method serverCall('methodeName', params).

All Map<String, Object> instances found in this class and its implementations are directly converted from and to JSON to interact with browser-site JavaScript.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ClientSideElement.Script This class represents a script
static class	ClientSideElement.ScriptFile This class represents a script file

Method Summary

Modifier and Type	Method and Description
Map<String,List<String>>	getDependencies() This method returns the list of dependencies, sorted by extension point.
String	getId() Get the id of the element.
String	getPluginName() Get the plugin name where the control was declared
Map<String,String>	getRights(Map<String,Object> contextParameters) This method return the right that will be needed on client side.
List<ClientSideElement.Script>	getScripts(boolean ignoreRights, Map<String,Object> contextParameters) This method return the scripts that will be used on client side.
List<ClientSideElement.Script>	getScripts(Map<String,Object> contextParameters) This method return the scripts that will be used on client side.

Method Detail

getId

String getId()

Get the id of the element.

Returns:

the id. Can not be null.

getScripts

List<ClientSideElement.Script> getScripts(Map<String,Object> contextParameters)

This method return the scripts that will be used on client side. This class will be parametrized by initial and current parameters.

Parameters:

contextParameters - Contextuals parameters transmitted by the environment.

Returns:

The list of scripts or an empty list.

getScripts

List<ClientSideElement.Script> getScripts(boolean ignoreRights,
                                          Map<String,Object> contextParameters)

This method return the scripts that will be used on client side. This class will be parametrized by initial and current parameters.

Parameters:

ignoreRights - True to ignore the rights verification.

contextParameters - Contextuals parameters transmitted by the environment.

Returns:

The list of scripts or an empty list.

getRights

Map<String,String> getRights(Map<String,Object> contextParameters)

This method return the right that will be needed on client side. This class will be parametrized by initial and current parameters.

Parameters:

contextParameters - Contextuals parameters transmitted by the environment.

Returns:

The rights in a Map of (rightId, context). Can be empty.

getPluginName

String getPluginName()

Get the plugin name where the control was declared

Returns:

The plugin name. Can not be null.

getDependencies

Map<String,List<String>> getDependencies()

This method returns the list of dependencies, sorted by extension point.

Returns:

a map of dependencies ids by extension point.