Page History
...
- Local navigation is only needed when dashboards require elements such as nodes, dependencies, favorites, or subdashboards. Simple applications do not require it:contentReference[oaicite:0]{index=0}.
- The dashboard navigation boardlet must always remain the same in form and appearance within a breakpoint; it may not be changed:contentReference[oaicite:1]{index=1}.
- Local navigation always controls only the current dashboard and can vary from dashboard to dashboard:contentReference[oaicite:2]{index=2}.
- Local navigation tasks include navigating between dashboard nodes, filtering dependencies, and accessing subdashboards:contentReference[oaicite:3]{index=3}.

Usage
- Use the component to switch between a defined set of dashboards; specify the list and order via
dashboardsso users can move between views without returning to the library. - Match the navigation orientation to the available space by setting
directionto"horizontal"for row-based navigation or"vertical"for column-based navigation. - If onboarding is needed, make the control discoverable by enabling the hotspot and supplying localized helper copy with
enableAsHotspot,guidedTourHotSpotTitle, andguidedTourHotSpotDescription.
Sizing & Layout
- Choose
direction: "horizontal"when there are few items and scanning should be left-to-right; choose"vertical"when items are numerous or labels are longer. - Add outer breathing room using
paddingClassto prevent the control from touching adjacent UI.
Visibility & Authorization
- Gate visibility for roles or policy sets with
visibilityPolicySetIdto avoid exposing navigation to users who shouldn’t access those dashboards. - Use
displayConditionsto hide the navigation in steps of a flow where it should not be available.
Paired Do & Don’t
| Do | Don’t | Article setting(s) |
|---|---|---|
| Define all destinations and their order once during initialization to keep navigation stable. | Reorder items unpredictably during usage. | dashboards, events.ON_INIT |
| Combine conditional rules into a single, mutually exclusive predicate to prevent flicker. | Use overlapping displayConditions that rapidly toggle visibility. | displayConditions |
...