SidePanelHandler | Theia TypeDoc

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.

Hierarchy

SidePanelHandler

Index

Constructors

constructor

Properties

Constructors

constructor

new SidePanelHandler(): SidePanelHandler

Returns SidePanelHandler

Properties

Protected Readonly applicationStateService

applicationStateService: FrontendApplicationStateService

bottomMenu

bottomMenu: SidebarMenuWidget

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 options

options: 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: 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: string): undefined | Widget

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:322
Activate a widget residing in the side panel by ID.

Parameters
- id: string
Returns undefined | Widget

the activated widget if it was found

addBottomMenu

addBottomMenu(menu: SidebarMenu): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:430
Add a menu to the sidebar bottom.

If the menu is already added, it will be ignored.

Parameters
- menu: SidebarMenu
Returns void

addTopMenu

addTopMenu(menu: SidebarMenu): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:412
Add a menu to the sidebar top.

If the menu is already added, it will be ignored.

Parameters
- menu: SidebarMenu
Returns void

addWidget

addWidget(widget: Widget, options: WidgetOptions): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:400
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: WidgetOptions
Returns void

collapse

collapse(): Promise<void>

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:385
Collapse the sidebar so no items are expanded.

Returns Promise<void>

create

create(side: "left" | "right", options: Options): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:129
Create the side bar and dock panel widgets.

Parameters
- side: "left" | "right"
- options: Options
Returns void

Protected createContainer

createContainer(): Panel

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

Protected createSideBar

createSideBar(): SideTabBar

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

Protected createSidePanel

createSidePanel(): TheiaDockPanel

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

Protected createSidebarBottomMenu

createSidebarBottomMenu(): SidebarBottomMenuWidget

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

Protected createSidebarMenu

createSidebarMenu<T>(factory: () => T): T

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

Protected createSidebarTopMenu

createSidebarTopMenu(): SidebarTopMenuWidget

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

Protected createToolbar

createToolbar(): SidePanelToolbar

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

expand

expand(id?: string): undefined | Widget

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:337
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

Protected getDefaultPanelSize

getDefaultPanelSize(): undefined | number

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:550
Determine the default size to apply when the panel is expanded for the first time.

Returns undefined | number

getLayoutData

getLayoutData(): LayoutData

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:270
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 LayoutData

Protected getPanelSize

getPanelSize(): undefined | number

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:528
Compute the current width of the panel. This implementation assumes that the parent of the panel container is a SplitPanel.

Returns undefined | number

Protected onCurrentTabChanged

onCurrentTabChanged(sender: SideTabBar, __namedParameters: ICurrentChangedArgs<Widget>): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:583
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

Protected onTabDetachRequested

onTabDetachRequested(sender: SideTabBar, __namedParameters: ITabDetachRequestedArgs<Widget>): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:601
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

Protected onWidgetAdded

onWidgetAdded(sender: DockPanel, widget: Widget): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:635
Parameters
- sender: DockPanel
- widget: Widget
Returns void

Protected onWidgetRemoved

onWidgetRemoved(sender: DockPanel, widget: Widget): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:657
Parameters
- sender: DockPanel
- widget: Widget
Returns void

refresh

refresh(): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:452
Refresh the visibility of the side bar and dock panel.

Returns void

removeBottomMenu

removeBottomMenu(menuId: string): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:439
Remove a menu from the sidebar bottom.

Parameters
- menuId: string
  
  id of the menu to remove
Returns void

removeTopMenu

removeTopMenu(menuId: string): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:421
Remove a menu from the sidebar top.

Parameters
- menuId: string
  
  id of the menu to remove
Returns void

resize

resize(size: number): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:516
Sets the size of the side panel.

Parameters
- size: number
  
  the desired size (width) of the panel in pixels.
Returns void

setLayoutData

setLayoutData(layoutData: LayoutData): void

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:285
Apply a side panel layout that has been previously created with getLayoutData.

Parameters
- layoutData: LayoutData
Returns void

Protected setPanelSize

setPanelSize(size: number): Promise<void>

- Defined in packages/core/src/browser/shell/side-panel-handler.ts:561
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>

Protected showContextMenu

showContextMenu(e: MouseEvent): void

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

Protected updateToolbarTitle

updateToolbarTitle(): void

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

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Returns SidePanelHandler

Properties

Protected Readonly applicationStateService

bottomMenu

container

Protected Readonly contextMenuRenderer

dockPanel

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

id: string

Returns undefined | Widget

addBottomMenu

Parameters

menu: SidebarMenu

Returns void

addTopMenu

Parameters

menu: SidebarMenu

Returns void

addWidget

Parameters

widget: Widget

options: WidgetOptions

Returns void

collapse

Returns Promise<void>

create

Parameters

side: "left" | "right"

options: Options

Returns void

Protected createContainer

Returns Panel

Protected createSideBar

Returns SideTabBar

Protected createSidePanel

Returns TheiaDockPanel

Protected createSidebarBottomMenu

Returns SidebarBottomMenuWidget

Protected createSidebarMenu

Type parameters

T: SidebarMenuWidget<T>

Parameters

factory: () => T

Returns T

Returns T

Protected createSidebarTopMenu

Returns SidebarTopMenuWidget

Protected createToolbar

Returns SidePanelToolbar