Class: SingleWidgetApp¶

application.SingleWidgetApp

App is the main application class. It is instantiated once and shared.

Hierarchy¶

JupyterFrontEnd<ISingleWidgetShell>

↳ SingleWidgetApp

Constructors¶

constructor¶

• new SingleWidgetApp(options?)

Construct a new SingleWidgetApp object.

Parameters¶

Name	Type	Description
`options?`	`IOptions`	The instantiation options for an application.

Overrides¶

JupyterFrontEnd<ISingleWidgetShell>.constructor

Defined in¶

packages/application/lib/singleWidgetApp.d.ts:14

Properties¶

commandLinker¶

• Readonly commandLinker: CommandLinker

The command linker used by the application.

Inherited from¶

JupyterFrontEnd.commandLinker

Defined in¶

node_modules/@jupyterlab/application/lib/frontend.d.ts:51

commands¶

• Readonly commands: CommandRegistry

The application command registry.

Inherited from¶

JupyterFrontEnd.commands

Defined in¶

node_modules/@lumino/application/types/index.d.ts:104

contextMenu¶

• Readonly contextMenu: ContextMenuSvg

The application context menu.

Inherited from¶

JupyterFrontEnd.contextMenu

Defined in¶

node_modules/@jupyterlab/application/lib/frontend.d.ts:55

docRegistry¶

• Readonly docRegistry: DocumentRegistry

The document registry instance used by the application.

Inherited from¶

JupyterFrontEnd.docRegistry

Defined in¶

node_modules/@jupyterlab/application/lib/frontend.d.ts:59

name¶

• Readonly name: "Single Widget Application"

The name of the application.

Overrides¶

JupyterFrontEnd.name

Defined in¶

packages/application/lib/singleWidgetApp.d.ts:18

namespace¶

• Readonly namespace: "Single Widget Application"

A namespace/prefix plugins may use to denote their provenance.

Overrides¶

JupyterFrontEnd.namespace

Defined in¶

packages/application/lib/singleWidgetApp.d.ts:22

restored¶

• Readonly restored: Promise<void>

Promise that resolves when state is first restored.

Inherited from¶

JupyterFrontEnd.restored

Defined in¶

node_modules/@jupyterlab/application/lib/frontend.d.ts:63

serviceManager¶

• Readonly serviceManager: ServiceManager

The service manager used by the application.

Inherited from¶

JupyterFrontEnd.serviceManager

Defined in¶

node_modules/@jupyterlab/application/lib/frontend.d.ts:67

shell¶

• Readonly shell: ISingleWidgetShell

The application shell widget.

Notes¶

The shell widget is the root “container” widget for the entire application. It will typically expose an API which allows the application plugins to insert content in a variety of places.

Inherited from¶

JupyterFrontEnd.shell

Defined in¶

node_modules/@lumino/application/types/index.d.ts:117

started¶

• Readonly started: Promise<void>

A promise which resolves after the application has started.

Notes¶

This promise will resolve after the start() method is called, when all the bootstrapping and shell mounting work is complete.

Inherited from¶

JupyterFrontEnd.started

Defined in¶

node_modules/@lumino/application/types/index.d.ts:125

status¶

• Readonly status: LabStatus

The application busy and dirty status signals and flags.

Defined in¶

packages/application/lib/singleWidgetApp.d.ts:26

version¶

• Readonly version: string

The version of the application.

Overrides¶

JupyterFrontEnd.version

Defined in¶

packages/application/lib/singleWidgetApp.d.ts:30

Accessors¶

format¶

• get format(): U

The application form factor, e.g., desktop or mobile.

Returns¶

U

Inherited from¶

JupyterFrontEnd.format

Defined in¶

node_modules/@jupyterlab/application/lib/frontend.d.ts:71

• set format(format): void

The application form factor, e.g., desktop or mobile.

Parameters¶

Name	Type
`format`	`U`

Returns¶

void

Inherited from¶

JupyterFrontEnd.format

Defined in¶

node_modules/@jupyterlab/application/lib/frontend.d.ts:72

formatChanged¶

• get formatChanged(): ISignal<this, U>

A signal that emits when the application form factor changes.

Returns¶

ISignal<this, U>

Inherited from¶

JupyterFrontEnd.formatChanged

Defined in¶

node_modules/@jupyterlab/application/lib/frontend.d.ts:76

paths¶

• get paths(): IPaths

The JupyterLab application paths dictionary.

Returns¶

IPaths

Defined in¶

packages/application/lib/singleWidgetApp.d.ts:34

Methods¶

activatePlugin¶

▸ activatePlugin(id): Promise<void>

Activate the plugin with the given id.

Parameters¶

Name	Type	Description
`id`	`string`	The ID of the plugin of interest.

Returns¶

Promise<void>

A promise which resolves when the plugin is activated or rejects with an error if it cannot be activated.

Inherited from¶

JupyterFrontEnd.activatePlugin

Defined in¶

node_modules/@lumino/application/types/index.d.ts:170

addEventListeners¶

▸ Protected addEventListeners(): void

Add the application event listeners.

Notes¶

The default implementation of this method adds listeners for 'keydown' and 'resize' events.

A subclass may reimplement this method as needed.

Returns¶

void

Inherited from¶

JupyterFrontEnd.addEventListeners

Defined in¶

node_modules/@lumino/application/types/index.d.ts:264

attachShell¶

▸ Protected attachShell(id): void

Attach the application shell to the DOM.

Parameters¶

Name	Type	Description
`id`	`string`	The id of the host node for the shell, or `''`. #### Notes If the id is not provided, the document body will be the host. A subclass may reimplement this method as needed.

Returns¶

void

Inherited from¶

JupyterFrontEnd.attachShell

Defined in¶

node_modules/@lumino/application/types/index.d.ts:254

contextMenuHitTest¶

▸ contextMenuHitTest(fn): undefined | HTMLElement

Walks up the DOM hierarchy of the target of the active contextmenu event, testing each HTMLElement ancestor for a user-supplied function. This can be used to find an HTMLElement on which to operate, given a context menu click.

Parameters¶

Name	Type	Description
`fn`	(`node`: `HTMLElement`) => `boolean`	a function that takes an `HTMLElement` and returns a boolean for whether it is the element the requester is seeking.

Returns¶

undefined | HTMLElement

an HTMLElement or undefined, if none is found.

Inherited from¶

JupyterFrontEnd.contextMenuHitTest

Defined in¶

node_modules/@jupyterlab/application/lib/frontend.d.ts:87

evtContextMenu¶

▸ Protected evtContextMenu(event): void

A method invoked on a document 'contextmenu' event.

Parameters¶

Name	Type
`event`	`MouseEvent`

Returns¶

void

Inherited from¶

JupyterFrontEnd.evtContextMenu

Defined in¶

node_modules/@jupyterlab/application/lib/frontend.d.ts:91

evtKeydown¶

▸ Protected evtKeydown(event): void

A method invoked on a document 'keydown' event.

Notes¶

The default implementation of this method invokes the key down processing method of the application command registry.

A subclass may reimplement this method as needed.

Parameters¶

Name	Type
`event`	`KeyboardEvent`

Returns¶

void

Inherited from¶

JupyterFrontEnd.evtKeydown

Defined in¶

node_modules/@lumino/application/types/index.d.ts:274

evtResize¶

▸ Protected evtResize(event): void

A method invoked on a window 'resize' event.

Notes¶

The default implementation of this method updates the shell.

A subclass may reimplement this method as needed.

Parameters¶

Name	Type
`event`	`Event`

Returns¶

void

Inherited from¶

JupyterFrontEnd.evtResize

Defined in¶

node_modules/@lumino/application/types/index.d.ts:297

handleEvent¶

▸ handleEvent(event): void

Handle the DOM events for the application.

Parameters¶

Name	Type	Description
`event`	`Event`	The DOM event sent to the application. #### Notes This method implements the DOM `EventListener` interface and is called in response to events registered for the application. It should not be called directly by user code.

Returns¶

void

Inherited from¶

JupyterFrontEnd.handleEvent

Defined in¶

node_modules/@lumino/application/types/index.d.ts:243

hasPlugin¶

▸ hasPlugin(id): boolean

Test whether a plugin is registered with the application.

Parameters¶

Name	Type	Description
`id`	`string`	The id of the plugin of interest.

Returns¶

boolean

true if the plugin is registered, false otherwise.

Inherited from¶

JupyterFrontEnd.hasPlugin

Defined in¶

node_modules/@lumino/application/types/index.d.ts:133

listPlugins¶

▸ listPlugins(): string[]

List the IDs of the plugins registered with the application.

Returns¶

string[]

A new array of the registered plugin IDs.

Inherited from¶

JupyterFrontEnd.listPlugins

Defined in¶

node_modules/@lumino/application/types/index.d.ts:139

registerPlugin¶

▸ registerPlugin(plugin): void

Parameters¶

Name	Type	Description
`plugin`	`IPlugin`<`SingleWidgetApp`, `any`>	The plugin to register. #### Notes An error will be thrown if a plugin with the same id is already registered, or if the plugin has a circular dependency. If the plugin provides a service which has already been provided by another plugin, the new service will override the old service.

Returns¶

void

Inherited from¶

JupyterFrontEnd.registerPlugin

Defined in¶

node_modules/@lumino/application/types/index.d.ts:152

registerPluginModule¶

▸ registerPluginModule(mod): void

Parameters¶

Name	Type	Description
`mod`	`IPluginModule`	The plugin module to register.

Returns¶

void

Defined in¶

packages/application/lib/singleWidgetApp.d.ts:40

registerPluginModules¶

▸ registerPluginModules(mods): void

Parameters¶

Name	Type	Description
`mods`	`IPluginModule`[]	The plugin modules to register.

Returns¶

void

Defined in¶

packages/application/lib/singleWidgetApp.d.ts:46

registerPlugins¶

▸ registerPlugins(plugins): void

Parameters¶

Name	Type	Description
`plugins`	`IPlugin`<`SingleWidgetApp`, `any`>[]	The plugins to register. #### Notes This calls `registerPlugin()` for each of the given plugins.

Returns¶

void

Inherited from¶

JupyterFrontEnd.registerPlugins

Defined in¶

node_modules/@lumino/application/types/index.d.ts:161

resolveOptionalService¶

▸ resolveOptionalService<U>(token): Promise<null | U>

Resolve an optional service of a given type.

Type parameters¶

Name
`U`

Parameters¶

Name	Type	Description
`token`	`Token`<`U`>	The token for the service type of interest.

Returns¶

Promise<null | U>

A promise which resolves to an instance of the requested service, or null if it cannot be resolved.

Notes¶

Services are singletons. The same instance will be returned each time a given service token is resolved.

If the plugin which provides the service has not been activated, resolving the service will automatically activate the plugin.

User code will not typically call this method directly. Instead, the optional services for the user’s plugins will be resolved automatically when the plugin is activated.

Inherited from¶

JupyterFrontEnd.resolveOptionalService

Defined in¶

node_modules/@lumino/application/types/index.d.ts:210

resolveRequiredService¶

▸ resolveRequiredService<U>(token): Promise<U>

Resolve a required service of a given type.

Type parameters¶

Name
`U`

Parameters¶

Name	Type	Description
`token`	`Token`<`U`>	The token for the service type of interest.

Returns¶

Promise<U>

A promise which resolves to an instance of the requested service, or rejects with an error if it cannot be resolved.

Notes¶

Services are singletons. The same instance will be returned each time a given service token is resolved.

If the plugin which provides the service has not been activated, resolving the service will automatically activate the plugin.

User code will not typically call this method directly. Instead, the required services for the user’s plugins will be resolved automatically when the plugin is activated.

Inherited from¶

JupyterFrontEnd.resolveRequiredService

Defined in¶

node_modules/@lumino/application/types/index.d.ts:190

start¶

▸ start(options?): Promise<void>

Start the application.

Parameters¶

Name	Type	Description
`options?`	`IStartOptions`	The options for starting the application.

Returns¶

Promise<void>

A promise which resolves when all bootstrapping work is complete and the shell is mounted to the DOM.

Notes¶

This should be called once by the application creator after all initial plugins have been registered.

If a plugin fails to the load, the error will be logged and the other valid plugins will continue to be loaded.

Bootstrapping the application consists of the following steps:

Activate the startup plugins
Wait for those plugins to activate
Attach the shell widget to the DOM
Add the application event listeners

Inherited from¶

JupyterFrontEnd.start

Defined in¶

node_modules/@lumino/application/types/index.d.ts:232

application

Class: SingleWidgetShell