Interface: TopbarApi

Defines page-level APIs available to solutions.

Hierarchy

TopbarApiProperties
↳ TopbarApi

Index

Properties

Methods

Properties

customEnvLabel

• customEnvLabel: string

Inherited from TopbarApiProperties.customEnvLabel

Gets or sets a custom environment label in the shell.

Example:

topbar.customEnvLabel = 'Beta';
Copied to your clipboard
topbar.customEnvLabel = 'Beta';

solution

• solution: Solution

Inherited from TopbarApiProperties.solution

Configuration for solution name and hero.

Example:

topbar.solution = {
  icon: 'AdobeExperienceCloud',
  title: 'Adobe Experience Cloud22',
  shortTitle: 'AEC'
};
Copied to your clipboard
topbar.solution = {
  icon: 'AdobeExperienceCloud',
  title: 'Adobe Experience Cloud22',
  shortTitle: 'AEC'
};

workspaces

• workspaces: WorkspaceMenu[]

Inherited from TopbarApiProperties.workspaces

Configuration for the Shell workspaces. Workspace names should be unique, and should be localized using the unified shell locale prior to setting runtime.workspaces.

topbar.workspaces = [
  {name: 'Home', url: '/'},
  {name: 'ABC', url: '/abc'},
  {name: 'DEF', url: '/def'}
];
Copied to your clipboard
topbar.workspaces = [
  {name: 'Home', url: '/'},
  {name: 'ABC', url: '/abc'},
  {name: 'DEF', url: '/def'}
];

Unified shell also supports workspace flyout menus, where clicking on a workspace displays a dropdown menu. The top-level workspace is present in the dropdown menu as the first menu item. Menus may be nested multiple times, and used in combination with normal workspaces. By default, parent menu items will be automatically added to the sub-menu due to how the user interaction works. To prevent this functionality, simply remove the url property on the parent item and it will not be injected into the sub-menu.

topbar.workspaces = [
  {name: 'Home', url: '/'},
  {name: 'ABC', url: '/abc'},
  {
    name: 'DEF',
    url: '/def',
    menu: [
      {
        name: 'GHI',
        url: '/def/ghi',
        menu: [
          {name: 'JKL', url: '/def/ghi/jkl'}
        ]
      }
    ]
  }
];
Copied to your clipboard
topbar.workspaces = [
  {name: 'Home', url: '/'},
  {name: 'ABC', url: '/abc'},
  {
    name: 'DEF',
    url: '/def',
    menu: [
      {
        name: 'GHI',
        url: '/def/ghi',
        menu: [
          {name: 'JKL', url: '/def/ghi/jkl'}
        ]
      }
    ]
  }
];