Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Riena/Navigation
Contents
The goal of the Riena navigation concept is to make navigation as easy and comfortable as possible for the enterprise user.
Subapplications
The Riena application ist made up from possibly multiple subapplications identifyable by the handles in the top area of the application window.
This example shows a Riena client application with 2 subapplications called 'Navigation' and 'Playground'. The 'Navigation' subapplication is currently selected.
Module Groups, Modules and Submodules
Each subapplication may contain multiple module groups, each module group may contain multiple modules and each module may contain multiple submodules.
|
The picture to the left shows 3 module groups, the first one containing two modules (named 'Module 1.1.1' and 'Module 1.1.2'). The second and third module group each contain one module only (named 'Module 1.2.1' and 'Navigate', resp). The module named 'Module 1.2.1' cannot be closed by the user as indicated by the absence of the 'X' button in the right corner of the module widget.
Note that only the first module within the first module group is expanded, ie its submodules are visible within the navigation tree. This is because that module is currently selected. We can also see that the first submodule (named 'SubModule 1.1.1.1') is the parent of another submodule (unfortunately also named 'SubModule 1.1.1.1') and has a sibling (named 'SubModule 1.1.1.2') within the same module. Selecting a subapplication, module group or module automatically activates the first submodule within that context. This implies the there is no work area associated with modules, module groups or subapplications - only submodules can have an associated work area (ie view and optionally a controller) |
The Riena navigation therefore can be thought of as a tree where the root is the application node and the leafs are the submodule nodes.
There are some properties that can be defined for all navigation nodes:
- id - The id is made up from two parts, a type and an instance part. This is explained later on this page.
- children - The type of children depends on the parent, a module node eg can only have submodule nodes as children.
Navigation nodes except module group nodes may also have a label and/or an icon.