Class SidePanelHandler

A class which manages a dock panel and a related side bar. This is used for the left and right panel of the application shell.

Index

Constructors

constructor

Constructors

constructor

new SidePanelHandler(): SidePanelHandler
Returns SidePanelHandler

Properties

additionalViewsMenu

additionalViewsMenu: AdditionalViewsMenuWidget

Conditional menu placed below the tabBar. Manages overflowing/hidden tabs. Is only visible if there are overflowing tabs.

The menu placed on the sidebar bottom. Displayed as icons. Open menus when on clicks.

container

container: Panel

The panel that contains the tab bar and the dock panel. This one is hidden whenever the dock panel is empty.

`Protected` `Readonly` contextMenuRenderer

contextMenuRenderer: ContextMenuRenderer

dockPanel

dockPanel: TheiaDockPanel

The widget container is a dock panel in single-document mode, which means that the panel cannot be split.

`Protected` `Readonly` dockPanelFactory

dockPanelFactory: core.Factory

`Protected` options

options: core.Options

Options that control the behavior of the side panel.

`Protected` side

side: "left" | "right"

The shell area where the panel is placed. This property should not be modified directly, but only by calling create.

`Protected` sidebarBottomWidgetFactory

sidebarBottomWidgetFactory: (() => SidebarBottomMenuWidget)

Type declaration

- (): SidebarBottomMenuWidget
- Returns SidebarBottomMenuWidget

`Protected` sidebarTopWidgetFactory

sidebarTopWidgetFactory: (() => SidebarTopMenuWidget)

Type declaration

- (): SidebarTopMenuWidget
- Returns SidebarTopMenuWidget

`Protected` splitPositionHandler

splitPositionHandler: SplitPositionHandler

`Readonly` state

state: core.State = ...

The current state of the side panel.

tabBar

tabBar: SideTabBar

The tab bar displays the titles of the widgets in the side panel. Visibility of the widgets is controlled entirely through tab selection: a widget is revealed by setting the currentTitle accordingly in the tab bar, and the panel is hidden by setting that property to null. The tab bar itself remains visible as long as there is at least one widget.

`Protected` tabBarRendererFactory

tabBarRendererFactory: (() => TabBarRenderer)

Type declaration

- (): TabBarRenderer
- Returns TabBarRenderer

`Protected` tabBarToolBarFactory

tabBarToolBarFactory: (() => TabBarToolbar)

Type declaration

- (): TabBarToolbar
- Returns TabBarToolbar

`Protected` tabBarToolBarRegistry

tabBarToolBarRegistry: TabBarToolbarRegistry

`Protected` `Readonly` toDisposeOnCurrentTabChanged

toDisposeOnCurrentTabChanged: DisposableCollection = ...

toolBar

toolBar: SidePanelToolbar

A tool bar, which displays a title and widget specific command buttons.

topMenu

topMenu: SidebarMenuWidget

The menu placed on the sidebar top. Displayed as icons. Open menus when on clicks.

`Static` `Protected` `Readonly` rankProperty

rankProperty: AttachedProperty<Widget, undefined | number> = ...

A property that can be attached to widgets in order to determine the insertion index of their title in the tab bar.

Methods

activate

activate(id): undefined | Widget
Activate a widget residing in the side panel by ID.
Parameters
- id: string
Returns undefined | Widget
the activated widget if it was found
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:346

addBottomMenu

addBottomMenu(menu): void
Add a menu to the sidebar bottom.

If the menu is already added, it will be ignored.
Parameters
- menu: SidebarMenu
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:454

addTopMenu

addTopMenu(menu): void
Add a menu to the sidebar top.

If the menu is already added, it will be ignored.
Parameters
- menu: SidebarMenu
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:436

addWidget

addWidget(widget, options): void
Add a widget and its title to the dock panel and side bar.

If the widget is already added, it will be moved.
Parameters
- widget: Widget
- options: core.WidgetOptions
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:424

collapse

collapse(): Promise<void>
Collapse the sidebar so no items are expanded.

Returns Promise<void>
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:409

create

create(side, options): void
Create the side bar and dock panel widgets.
Parameters
- side: "left" | "right"
- options: core.Options
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:138

`Protected` createAdditionalViewsWidget

createAdditionalViewsWidget(): AdditionalViewsMenuWidget
Returns AdditionalViewsMenuWidget
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:211

`Protected` createContainer

createContainer(): Panel
Returns Panel
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:247

`Protected` createSideBar

createSideBar(): SideTabBar
Returns SideTabBar
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:152

`Protected` createSidePanel

createSidePanel(): TheiaDockPanel
Returns TheiaDockPanel
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:190

`Protected` createSidebarBottomMenu

createSidebarBottomMenu(): SidebarBottomMenuWidget
Returns SidebarBottomMenuWidget
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:222

`Protected` createSidebarMenu

createSidebarMenu<T>(factory): T
Type Parameters
- T extends SidebarMenuWidget
Parameters
- factory: (() => T)
  - - (): T
    - Returns T
Returns T
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:226

`Protected` createSidebarTopMenu

createSidebarTopMenu(): SidebarTopMenuWidget
Returns SidebarTopMenuWidget
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:218

`Protected` createToolbar

createToolbar(): SidePanelToolbar
Returns SidePanelToolbar
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:205

expand

expand(id?): undefined | Widget
Expand a widget residing in the side panel by ID. If no ID is given and the panel is currently collapsed, the last active tab of this side panel is expanded. If no tab was expanded previously, the first one is taken.
Parameters
- Optional id: string
Returns undefined | Widget
the expanded widget if it was found
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:361

`Protected` getDefaultPanelSize

getDefaultPanelSize(): undefined | number
Determine the default size to apply when the panel is expanded for the first time.

Returns undefined | number
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:575

getLayoutData

getLayoutData(): core.LayoutData
Create an object that describes the current side panel layout. This object may contain references to widgets; these need to be transformed before the layout can be serialized.

Returns core.LayoutData
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:289

`Protected` getPanelSize

getPanelSize(): undefined | number
Compute the current width of the panel. This implementation assumes that the parent of the panel container is a SplitPanel.

Returns undefined | number
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:553

`Protected` onCurrentTabChanged

onCurrentTabChanged(sender, __namedParameters): void
Handle a currentChanged signal from the sidebar. The side panel is refreshed so it displays the new selected widget.
Parameters
- sender: SideTabBar
- __namedParameters: ICurrentChangedArgs<Widget>
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:608

`Protected` onTabDetachRequested

onTabDetachRequested(sender, __namedParameters): void
Handle a tabDetachRequested signal from the sidebar. A drag is started so the widget can be moved to another application shell area.
Parameters
- sender: SideTabBar
- __namedParameters: ITabDetachRequestedArgs<Widget>
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:626

`Protected` onTabsOverflowChanged

onTabsOverflowChanged(sender, event): void
Parameters
- sender: SideTabBar
- event: {
  startIndex: number;
  titles: Title<Widget>[];
  }
  - startIndex: number
  - titles: Title<Widget>[]
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:656

`Protected` onWidgetAdded

onWidgetAdded(sender, widget): void
Parameters
- sender: DockPanel
- widget: Widget
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:668

`Protected` onWidgetRemoved

onWidgetRemoved(sender, widget): void
Parameters
- sender: DockPanel
- widget: Widget
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:690

refresh

refresh(): void
Refresh the visibility of the side bar and dock panel.

Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:476

removeBottomMenu

removeBottomMenu(menuId): void
Remove a menu from the sidebar bottom.
Parameters
- menuId: string
  id of the menu to remove
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:463

removeTopMenu

removeTopMenu(menuId): void
Remove a menu from the sidebar top.
Parameters
- menuId: string
  id of the menu to remove
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:445

resize

resize(size): void
Sets the size of the side panel.
Parameters
- size: number
  the desired size (width) of the panel in pixels.
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:541

setLayoutData

setLayoutData(layoutData): void
Apply a side panel layout that has been previously created with getLayoutData.
Parameters
- layoutData: core.LayoutData
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:305

`Protected` setPanelSize

setPanelSize(size): Promise<void>
Modify the width of the panel. This implementation assumes that the parent of the panel container is a SplitPanel.
Parameters
- size: number
Returns Promise<void>
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:586

`Protected` showContextMenu

showContextMenu(e): void
Parameters
- e: MouseEvent
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:232

`Protected` updateSashState

updateSashState(sidePanelElement, sidePanelCollapsed): void
Parameters
- sidePanelElement: null | Panel
- sidePanelCollapsed: boolean
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:695

`Protected` updateToolbarTitle

updateToolbarTitle(): void
Returns void
- Defined in packages/core/src/browser/shell/side-panel-handler.ts:468

Class SidePanelHandler

Index

Constructors

Properties

Methods

Constructors

constructor

Returns SidePanelHandler

Properties

additionalViewsMenu

Protected additionalViewsMenuFactory

Protected Readonly applicationStateService

bottomMenu

container

Protected Readonly contextMenuRenderer

dockPanel

Protected Readonly dockPanelFactory

Protected options

Protected side

Protected sidebarBottomWidgetFactory

Type declaration

Returns SidebarBottomMenuWidget

Protected sidebarTopWidgetFactory

Type declaration

Returns SidebarTopMenuWidget

Protected splitPositionHandler

Readonly state

tabBar

Protected tabBarRendererFactory

Type declaration

Returns TabBarRenderer

Protected tabBarToolBarFactory

Type declaration

Returns TabBarToolbar

Protected tabBarToolBarRegistry

Protected Readonly toDisposeOnCurrentTabChanged

toolBar

topMenu

Static Protected Readonly rankProperty

Methods

activate

Parameters

Returns undefined | Widget

addBottomMenu

Parameters

Returns void

addTopMenu

Parameters

Returns void

addWidget

Parameters

Returns void

collapse

Returns Promise<void>

create

Parameters

Returns void

Protected createAdditionalViewsWidget

Returns AdditionalViewsMenuWidget

Protected createContainer

Returns Panel

Protected createSideBar

Returns SideTabBar

Protected createSidePanel

Returns TheiaDockPanel

Protected createSidebarBottomMenu

Returns SidebarBottomMenuWidget

Protected createSidebarMenu

Type Parameters

Parameters

Returns T

Returns T

Protected createSidebarTopMenu

Returns SidebarTopMenuWidget

Protected createToolbar

Returns SidePanelToolbar

expand

Parameters

Returns undefined | Widget

Protected getDefaultPanelSize

`Protected` additionalViewsMenuFactory

`Protected` `Readonly` applicationStateService

`Protected` `Readonly` contextMenuRenderer

`Protected` `Readonly` dockPanelFactory

`Protected` options

`Protected` side

`Protected` sidebarBottomWidgetFactory

`Protected` sidebarTopWidgetFactory

`Protected` splitPositionHandler

`Readonly` state

`Protected` tabBarRendererFactory

`Protected` tabBarToolBarFactory

`Protected` tabBarToolBarRegistry

`Protected` `Readonly` toDisposeOnCurrentTabChanged

`Static` `Protected` `Readonly` rankProperty

`Protected` createAdditionalViewsWidget

`Protected` createContainer

`Protected` createSideBar

`Protected` createSidePanel

`Protected` createSidebarBottomMenu

`Protected` createSidebarMenu

`Protected` createSidebarTopMenu

`Protected` createToolbar

`Protected` getDefaultPanelSize

`Protected` getPanelSize

`Protected` onCurrentTabChanged

`Protected` onTabDetachRequested

`Protected` onTabsOverflowChanged

`Protected` onWidgetAdded

`Protected` onWidgetRemoved

`Protected` setPanelSize

`Protected` showContextMenu

`Protected` updateSashState

`Protected` updateToolbarTitle