A subapp descriptor describes a subapp. A subapp is typically rendered as a tab inside an app. The descriptor defines the classes that read the configuration and implement the subapp.
This subapp descriptor is part of the Magnolia 6 UI framework. The fully qualified class name is info.magnolia.ui.api.app.registry.ConfiguredSubAppDescriptor
.
If you work with the Magnolia 5 UI framework, see Subapp descriptor for Magnolia 5 UI instead.
Example subapp descriptor
icon: icon-app class: info.magnolia.ui.api.app.registry.ConfiguredAppDescriptor appClass: info.magnolia.ui.framework.app.BaseApp label: Base App subApps: main: subAppClass: info.magnolia.ui.framework.app.BaseSubApp class: info.magnolia.ui.api.app.registry.ConfiguredSubAppDescriptor label: Base Subapp
Subapp descriptor properties
| required Subapp node name. The internal ID used to reference the subapp (for example, in URL fragments). |
| required Fully qualified name of the class that contains the subapp business logic. The class must implement the SubApp interface. |
| required, default is Subapp descriptor class that reads the configuration. The class must implement the SubAppDescriptor interface. Use the fully qualified class name. Another possible value is |
| optional Connects the subapp to a data source. For this to work, you have to use the If no value is specified, the subapp will inherit the app data source. |
| optional Defines actions in the subapp. Specified actions are rendered as buttons via ActionDefinition. Only the actions that are defined will be provided. |
| optional, default is Defines whether the subapp can be closed. When |
| optional CSS class that identifies an icon used for the subapp tab. See How to add SVG icons for apps. |
| optional Text or message bundle key displayed on the subapp tab. |
The order in which you configure subapps is important. The first subapp is the default subapp and is started first.
Browser descriptor
BrowserDescriptor extends the ContentSubAppDescriptor
class. It allows you to view and organize content items in tree, list and thumbnail views.
subApps: browser: subAppClass: info.magnolia.ui.contentapp.browser.Browser class: info.magnolia.ui.contentapp.configuration.BrowserDescriptor
Detail descriptor
DetailDescriptor extends the ContentSubAppDescriptor
class. It creates and edits the content items listed in the browser descriptor.
subApps: detail: subAppClass: info.magnolia.ui.contentapp.detail.ContentDetailSubApp class: info.magnolia.ui.contentapp.detail.DetailDescriptor