Class WidgetManager

The WidgetManager is the common component responsible for creating and managing widgets. Additional widget factories can be registered by using the WidgetFactory contribution point. To identify a widget, created by a factory, the factory id and the creation options are used. This key is commonly referred to as description of the widget.

Constructors

constructor

new WidgetManager(): WidgetManager
Returns WidgetManager

Properties

`Protected` _cachedFactories

_cachedFactories: Map<string, WidgetFactory>

`Protected` `Readonly` factoryProvider

factoryProvider: ContributionProvider<WidgetFactory>

`Protected` `Readonly` logger

logger: ILogger

`Readonly` onDidCreateWidget

onDidCreateWidget: Event<DidCreateWidgetEvent> = ...

`Protected` `Readonly` onDidCreateWidgetEmitter

onDidCreateWidgetEmitter: Emitter<DidCreateWidgetEvent> = ...

`Readonly` onWillCreateWidget

onWillCreateWidget: Event<WillCreateWidgetEvent> = ...

An event can be used to participate in the widget creation. Listeners may not dispose the given widget.

`Protected` `Readonly` onWillCreateWidgetEmitter

onWillCreateWidgetEmitter: Emitter<WillCreateWidgetEvent> = ...

`Protected` `Readonly` pendingWidgetPromises

pendingWidgetPromises: Map<string, Promise<Widget>> = ...

`Protected` `Readonly` widgets

widgets: Map<string, Widget> = ...

Accessors

`Protected` factories

get factories(): Map<string, WidgetFactory>
Returns Map<string, WidgetFactory>
- Defined in packages/core/src/browser/widget-manager.ts:304

Methods

`Protected` doCreateWidget

doCreateWidget<T>(factory, options?): Promise<T>
Type Parameters
- T extends Widget
Parameters
- factory: WidgetFactory
- Optional options: any
Returns Promise<T>
- Defined in packages/core/src/browser/widget-manager.ts:257

`Protected` doGetWidget

doGetWidget<T>(key): undefined | MaybePromise<T>
Type Parameters
- T extends Widget
Parameters
- key: string
Returns undefined | MaybePromise<T>
- Defined in packages/core/src/browser/widget-manager.ts:222

findWidget

findWidget<T>(factoryId, predicate): Promise<undefined | T>
Finds a widget that matches the given test predicate.
Type Parameters
- T extends Widget
Parameters
- factoryId: string
  The widget factory id.
- predicate: ((options?) => boolean)
  The test predicate.
  - - (options?): boolean
    - Parameters
      Optional options: any
      Returns boolean
Returns Promise<undefined | T>
a promise resolving to the widget if available, else undefined.
- Defined in packages/core/src/browser/widget-manager.ts:204

`Protected` fromKey

fromKey(key): WidgetConstructionOptions
Convert the key into the widget construction options object.
Parameters
- key: string
  the key.
Returns WidgetConstructionOptions
the widget construction options object.
- Defined in packages/core/src/browser/widget-manager.ts:300

getDescription

getDescription(widget): undefined | WidgetConstructionOptions
Get the widget construction options.
Parameters
- widget: Widget
  the widget.
Returns undefined | WidgetConstructionOptions
the widget construction options if the widget was created through the manager, else undefined.
- Defined in packages/core/src/browser/widget-manager.ts:275

getOrCreateWidget

getOrCreateWidget<T>(factoryId, options?): Promise<T>
Creates a new widget or returns the existing widget for the given description.
Type Parameters
- T extends Widget
Parameters
- factoryId: string
  the widget factory id.
- Optional options: any
  the widget factory specific information.
Returns Promise<T>
a promise resolving to the widget.
- Defined in packages/core/src/browser/widget-manager.ts:237

getWidget

getWidget<T>(factoryId, options?): Promise<undefined | T>
Get the widget for the given description.
Type Parameters
- T extends Widget
Parameters
- factoryId: string
  The widget factory id.
- Optional options: any
  The widget factory specific information.
Returns Promise<undefined | T>
a promise resolving to the widget if available, else undefined.
- Defined in packages/core/src/browser/widget-manager.ts:190

getWidgets

getWidgets(factoryId): Widget[]
Get the list of widgets created by the given widget factory.
Parameters
- factoryId: string
  the widget factory id.
Returns Widget[]
the list of widgets created by the factory with the given id.
- Defined in packages/core/src/browser/widget-manager.ts:142

`Protected` testPredicate

testPredicate(key, factoryId, predicate): boolean
Parameters
- key: string
- factoryId: string
- predicate: ((options?) => boolean)
  - - (options?): boolean
    - Parameters
      Optional options: any
      Returns boolean
Returns boolean
- Defined in packages/core/src/browser/widget-manager.ts:217

`Protected` toKey

toKey(options): string
Convert the widget construction options to string.
Parameters
- options: WidgetConstructionOptions
  the widget construction options.
Returns string
the widget construction options represented as a string.
- Defined in packages/core/src/browser/widget-manager.ts:290

tryGetPendingWidget

tryGetPendingWidget<T>(factoryId, options?): undefined | MaybePromise<T>
Try to get the existing widget for the given description.
Type Parameters
- T extends Widget
Parameters
- factoryId: string
  The widget factory id.
- Optional options: any
  The widget factory specific information.
Returns undefined | MaybePromise<T>
A promise that resolves to the widget, if any exists. The promise may be pending, so be cautious when assuming that it will not reject.
- Defined in packages/core/src/browser/widget-manager.ts:178

tryGetWidget

tryGetWidget<T>(factoryId, options?): undefined | T
Try to get the existing widget for the given description.
Type Parameters
- T extends Widget
Parameters
- factoryId: string
  The widget factory id.
- Optional options: any
  The widget factory specific information.
Returns undefined | T
the widget if available, else undefined.

The widget is 'available' if it has been created with the same factoryId and options by the WidgetManager. If the widget's creation is asynchronous, it is only available when the associated Promise is resolved.
- Defined in packages/core/src/browser/widget-manager.ts:162

Class WidgetManager

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Returns WidgetManager

Properties

Protected _cachedFactories

Protected Readonly factoryProvider

Protected Readonly logger

Readonly onDidCreateWidget

Protected Readonly onDidCreateWidgetEmitter

Readonly onWillCreateWidget

Protected Readonly onWillCreateWidgetEmitter

Protected Readonly pendingWidgetPromises

Protected Readonly widgets

Accessors

Protected factories

Returns Map<string, WidgetFactory>

Methods

Protected doCreateWidget

Type Parameters

Parameters

Returns Promise<T>

Protected doGetWidget

Type Parameters

Parameters

Returns undefined | MaybePromise<T>

findWidget

Type Parameters

Parameters

Parameters

Returns boolean

Returns Promise<undefined | T>

Protected fromKey

Parameters

Returns WidgetConstructionOptions

getDescription

Parameters

Returns undefined | WidgetConstructionOptions

getOrCreateWidget

Type Parameters

Parameters

Returns Promise<T>

getWidget

Type Parameters

Parameters

Returns Promise<undefined | T>

getWidgets

Parameters

Returns Widget[]

Protected testPredicate

Parameters

Parameters

Returns boolean

Returns boolean

Protected toKey

Parameters

Returns string

tryGetPendingWidget

Type Parameters

Parameters

Returns undefined | MaybePromise<T>

tryGetWidget

Type Parameters

Parameters

Returns undefined | T

Settings

Member Visibility

Theme

On This Page

`Protected` _cachedFactories

`Protected` `Readonly` factoryProvider

`Protected` `Readonly` logger

`Readonly` onDidCreateWidget

`Protected` `Readonly` onDidCreateWidgetEmitter

`Readonly` onWillCreateWidget

`Protected` `Readonly` onWillCreateWidgetEmitter

`Protected` `Readonly` pendingWidgetPromises

`Protected` `Readonly` widgets

`Protected` factories

`Protected` doCreateWidget

`Protected` doGetWidget

`Protected` fromKey

`Protected` testPredicate

`Protected` toKey