# Interface: `ISingleWidgetShell` [@jupyterlite/application](../modules/jupyterlite_application.md).ISingleWidgetShell The single widget application shell interface. ## Hierarchy - [`SingleWidgetShell`](../classes/jupyterlite_application.SingleWidgetShell.md) ↳ **``ISingleWidgetShell``** ## Properties ### `node` > > `Readonly` **`node`**: `HTMLElement` Get the DOM node owned by the widget. #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[node](../classes/jupyterlite_application.SingleWidgetShell.md#node) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:37 ## Accessors ### `currentChanged` > > `get` **`currentChanged`**(): `ISignal`<[`ISingleWidgetShell`](../modules/jupyterlite_application.md#isinglewidgetshell), `IChangedArgs`<`Widget`\>\> A signal emitted when the current widget changes. #### Returns `ISignal`<[`ISingleWidgetShell`](../modules/jupyterlite_application.md#isinglewidgetshell), `IChangedArgs`<`Widget`\>\> #### Inherited from SingleWidgetShell.currentChanged #### Defined in [packages/application/src/singleWidgetShell.ts:46](https://github.com/jupyterlite/jupyterlite/blob/999c7f0/packages/application/src/singleWidgetShell.ts#L46) ### `currentWidget` > > `get` **`currentWidget`**(): ``null`` \| `Widget` The current widget in the shell's main area. #### Returns ``null`` \| `Widget` #### Inherited from SingleWidgetShell.currentWidget #### Defined in [packages/application/src/singleWidgetShell.ts:53](https://github.com/jupyterlite/jupyterlite/blob/999c7f0/packages/application/src/singleWidgetShell.ts#L53) ### `dataset` > > `get` **`dataset`**(): `DOMStringMap` The dataset for the widget's DOM node. #### Returns `DOMStringMap` #### Inherited from SingleWidgetShell.dataset #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:81 ### `disposed` > > `get` **`disposed`**(): `ISignal`<`this`, `void`\> A signal emitted when the widget is disposed. #### Returns `ISignal`<`this`, `void`\> #### Inherited from SingleWidgetShell.disposed #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:33 ### `hiddenMode` > > `get` **`hiddenMode`**(): `HiddenMode` Get the method for hiding the widget. #### Returns `HiddenMode` #### Inherited from SingleWidgetShell.hiddenMode #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:85 > > `set` **`hiddenMode`**(`value`): `void` Set the method for hiding the widget. #### Parameters | Name | Type | | :------ | :------ | | `value` | `HiddenMode` | #### Returns `void` #### Inherited from SingleWidgetShell.hiddenMode #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:89 ### `id` > > `get` **`id`**(): `string` Get the id of the widget's DOM node. #### Returns `string` #### Inherited from SingleWidgetShell.id #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:73 > > `set` **`id`**(`value`): `void` Set the id of the widget's DOM node. #### Parameters | Name | Type | | :------ | :------ | | `value` | `string` | #### Returns `void` #### Inherited from SingleWidgetShell.id #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:77 ### `isAttached` > > `get` **`isAttached`**(): `boolean` Test whether the widget's node is attached to the DOM. #### Returns `boolean` #### Inherited from SingleWidgetShell.isAttached #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:45 ### `isDisposed` > > `get` **`isDisposed`**(): `boolean` Test whether the widget has been disposed. #### Returns `boolean` #### Inherited from SingleWidgetShell.isDisposed #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:41 ### `isHidden` > > `get` **`isHidden`**(): `boolean` Test whether the widget is explicitly hidden. #### Returns `boolean` #### Inherited from SingleWidgetShell.isHidden #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:49 ### `isVisible` > > `get` **`isVisible`**(): `boolean` Test whether the widget is visible. #### Notes A widget is visible when it is attached to the DOM, is not explicitly hidden, and has no explicitly hidden ancestors. #### Returns `boolean` #### Inherited from SingleWidgetShell.isVisible #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:57 ### `layout` > > `get` **`layout`**(): ``null`` \| `Layout` Get the layout for the widget. #### Returns ``null`` \| `Layout` #### Inherited from SingleWidgetShell.layout #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:109 > > `set` **`layout`**(`value`): `void` Set the layout for the widget. #### Notes The layout is single-use only. It cannot be changed after the first assignment. The layout is disposed automatically when the widget is disposed. #### Parameters | Name | Type | | :------ | :------ | | `value` | ``null`` \| `Layout` | #### Returns `void` #### Inherited from SingleWidgetShell.layout #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:119 ### `parent` > > `get` **`parent`**(): ``null`` \| `Widget` Get the parent of the widget. #### Returns ``null`` \| `Widget` #### Inherited from SingleWidgetShell.parent #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:93 > > `set` **`parent`**(`value`): `void` Set the parent of the widget. #### Notes Children are typically added to a widget by using a layout, which means user code will not normally set the parent widget directly. The widget will be automatically removed from its old parent. This is a no-op if there is no effective parent change. #### Parameters | Name | Type | | :------ | :------ | | `value` | ``null`` \| `Widget` | #### Returns `void` #### Inherited from SingleWidgetShell.parent #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:105 ### `title` > > `get` **`title`**(): `Title`<`Widget`\> The title object for the widget. #### Notes The title object is used by some container widgets when displaying the widget alongside some title, such as a tab panel or side bar. Since not all widgets will use the title, it is created on demand. The `owner` property of the title is set to this widget. #### Returns `Title`<`Widget`\> #### Inherited from SingleWidgetShell.title #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:69 ## Methods ### `activate` > > **`activate`**(): `void` Post an `'activate-request'` message to the widget. #### Notes This is a simple convenience method for posting the message. #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[activate](../classes/jupyterlite_application.SingleWidgetShell.md#activate) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:204 ### `activateById` > > **`activateById`**(`id`): `void` Activate a widget in its area. #### Parameters | Name | Type | | :------ | :------ | | `id` | `string` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[activateById](../classes/jupyterlite_application.SingleWidgetShell.md#activatebyid) #### Defined in [packages/application/src/singleWidgetShell.ts:60](https://github.com/jupyterlite/jupyterlite/blob/999c7f0/packages/application/src/singleWidgetShell.ts#L60) ### `add` > > **`add`**(`widget`, `area?`, `options?`): `void` Add a widget to the application shell. #### Parameters | Name | Type | Description | | :------ | :------ | :------ | | `widget` | `Widget` | The widget being added. | | `area?` | ``"main"`` | Optional region in the shell into which the widget should be added. | | `options?` | `IOpenOptions` | Optional open options. | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[add](../classes/jupyterlite_application.SingleWidgetShell.md#add) #### Defined in [packages/application/src/singleWidgetShell.ts:78](https://github.com/jupyterlite/jupyterlite/blob/999c7f0/packages/application/src/singleWidgetShell.ts#L78) ### `addClass` > > **`addClass`**(`name`): `void` Add a class name to the widget's DOM node. #### Parameters | Name | Type | Description | | :------ | :------ | :------ | | `name` | `string` | The class name to add to the node. #### Notes If the class name is already added to the node, this is a no-op. The class name must not contain whitespace. | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[addClass](../classes/jupyterlite_application.SingleWidgetShell.md#addclass) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:157 ### `children` > > **`children`**(): `IterableIterator`<`Widget`\> Create an iterator over the widget's children. #### Returns `IterableIterator`<`Widget`\> A new iterator over the children of the widget. #### Notes The widget must have a populated layout in order to have children. If a layout is not installed, the returned iterator will be empty. #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[children](../classes/jupyterlite_application.SingleWidgetShell.md#children) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:130 ### `clearFlag` > > **`clearFlag`**(`flag`): `void` Clear the given widget flag. #### Notes This will not typically be called directly by user code. #### Parameters | Name | Type | | :------ | :------ | | `flag` | `Flag` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[clearFlag](../classes/jupyterlite_application.SingleWidgetShell.md#clearflag) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:259 ### `close` > > **`close`**(): `void` Send a `'close-request'` message to the widget. #### Notes This is a simple convenience method for sending the message. #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[close](../classes/jupyterlite_application.SingleWidgetShell.md#close) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:211 ### `contains` > > **`contains`**(`widget`): `boolean` Test whether a widget is a descendant of this widget. #### Parameters | Name | Type | Description | | :------ | :------ | :------ | | `widget` | `Widget` | The descendant widget of interest. | #### Returns `boolean` `true` if the widget is a descendant, `false` otherwise. #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[contains](../classes/jupyterlite_application.SingleWidgetShell.md#contains) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:138 ### `dispose` > > **`dispose`**(): `void` Dispose of the widget and its descendant widgets. #### Notes It is unsafe to use the widget after it has been disposed. All calls made to this method after the first are a no-op. #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[dispose](../classes/jupyterlite_application.SingleWidgetShell.md#dispose) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:29 ### `fit` > > **`fit`**(): `void` Post a `'fit-request'` message to the widget. #### Notes This is a simple convenience method for posting the message. #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[fit](../classes/jupyterlite_application.SingleWidgetShell.md#fit) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:197 ### `hasClass` > > **`hasClass`**(`name`): `boolean` Test whether the widget's DOM node has the given class name. #### Parameters | Name | Type | Description | | :------ | :------ | :------ | | `name` | `string` | The class name of interest. | #### Returns `boolean` `true` if the node has the class, `false` otherwise. #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[hasClass](../classes/jupyterlite_application.SingleWidgetShell.md#hasclass) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:146 ### `hide` > > **`hide`**(): `void` Hide the widget and make it hidden to its parent widget. #### Notes This causes the [isHidden](jupyterlite_application.ISingleWidgetShell.md#ishidden) property to be `true`. If the widget is explicitly hidden, this is a no-op. #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[hide](../classes/jupyterlite_application.SingleWidgetShell.md#hide) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:229 ### `notifyLayout` > > `Protected` **`notifyLayout`**(`msg`): `void` Invoke the message processing routine of the widget's layout. #### Parameters | Name | Type | Description | | :------ | :------ | :------ | | `msg` | `Message` | The message to dispatch to the layout. #### Notes This is a no-op if the widget does not have a layout. This will not typically be called directly by user code. | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[notifyLayout](../classes/jupyterlite_application.SingleWidgetShell.md#notifylayout) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:279 ### `onActivateRequest` > > `Protected` **`onActivateRequest`**(`msg`): `void` A message handler invoked on an `'activate-request'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onActivateRequest](../classes/jupyterlite_application.SingleWidgetShell.md#onactivaterequest) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:314 ### `onAfterAttach` > > `Protected` **`onAfterAttach`**(`msg`): `void` A message handler invoked on an `'after-attach'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onAfterAttach](../classes/jupyterlite_application.SingleWidgetShell.md#onafterattach) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:356 ### `onAfterDetach` > > `Protected` **`onAfterDetach`**(`msg`): `void` A message handler invoked on an `'after-detach'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onAfterDetach](../classes/jupyterlite_application.SingleWidgetShell.md#onafterdetach) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:370 ### `onAfterHide` > > `Protected` **`onAfterHide`**(`msg`): `void` A message handler invoked on an `'after-hide'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onAfterHide](../classes/jupyterlite_application.SingleWidgetShell.md#onafterhide) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:342 ### `onAfterShow` > > `Protected` **`onAfterShow`**(`msg`): `void` A message handler invoked on an `'after-show'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onAfterShow](../classes/jupyterlite_application.SingleWidgetShell.md#onaftershow) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:328 ### `onBeforeAttach` > > `Protected` **`onBeforeAttach`**(`msg`): `void` A message handler invoked on a `'before-attach'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onBeforeAttach](../classes/jupyterlite_application.SingleWidgetShell.md#onbeforeattach) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:349 ### `onBeforeDetach` > > `Protected` **`onBeforeDetach`**(`msg`): `void` A message handler invoked on a `'before-detach'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onBeforeDetach](../classes/jupyterlite_application.SingleWidgetShell.md#onbeforedetach) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:363 ### `onBeforeHide` > > `Protected` **`onBeforeHide`**(`msg`): `void` A message handler invoked on a `'before-hide'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onBeforeHide](../classes/jupyterlite_application.SingleWidgetShell.md#onbeforehide) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:335 ### `onBeforeShow` > > `Protected` **`onBeforeShow`**(`msg`): `void` A message handler invoked on a `'before-show'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onBeforeShow](../classes/jupyterlite_application.SingleWidgetShell.md#onbeforeshow) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:321 ### `onChildAdded` > > `Protected` **`onChildAdded`**(`msg`): `void` A message handler invoked on a `'child-added'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `ChildMessage` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onChildAdded](../classes/jupyterlite_application.SingleWidgetShell.md#onchildadded) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:377 ### `onChildRemoved` > > `Protected` **`onChildRemoved`**(`msg`): `void` A message handler invoked on a `'child-removed'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `ChildMessage` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onChildRemoved](../classes/jupyterlite_application.SingleWidgetShell.md#onchildremoved) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:384 ### `onCloseRequest` > > `Protected` **`onCloseRequest`**(`msg`): `void` A message handler invoked on a `'close-request'` message. #### Notes The default implementation unparents or detaches the widget. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onCloseRequest](../classes/jupyterlite_application.SingleWidgetShell.md#oncloserequest) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:286 ### `onFitRequest` > > `Protected` **`onFitRequest`**(`msg`): `void` A message handler invoked on a `'fit-request'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onFitRequest](../classes/jupyterlite_application.SingleWidgetShell.md#onfitrequest) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:307 ### `onResize` > > `Protected` **`onResize`**(`msg`): `void` A message handler invoked on a `'resize'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `ResizeMessage` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onResize](../classes/jupyterlite_application.SingleWidgetShell.md#onresize) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:293 ### `onUpdateRequest` > > `Protected` **`onUpdateRequest`**(`msg`): `void` A message handler invoked on an `'update-request'` message. #### Notes The default implementation of this handler is a no-op. #### Parameters | Name | Type | | :------ | :------ | | `msg` | `Message` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[onUpdateRequest](../classes/jupyterlite_application.SingleWidgetShell.md#onupdaterequest) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:300 ### `processMessage` > > **`processMessage`**(`msg`): `void` Process a message sent to the widget. #### Parameters | Name | Type | Description | | :------ | :------ | :------ | | `msg` | `Message` | The message sent to the widget. #### Notes Subclasses may reimplement this method as needed. | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[processMessage](../classes/jupyterlite_application.SingleWidgetShell.md#processmessage) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:268 ### `removeClass` > > **`removeClass`**(`name`): `void` Remove a class name from the widget's DOM node. #### Parameters | Name | Type | Description | | :------ | :------ | :------ | | `name` | `string` | The class name to remove from the node. #### Notes If the class name is not yet added to the node, this is a no-op. The class name must not contain whitespace. | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[removeClass](../classes/jupyterlite_application.SingleWidgetShell.md#removeclass) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:168 ### `setFlag` > > **`setFlag`**(`flag`): `void` Set the given widget flag. #### Notes This will not typically be called directly by user code. #### Parameters | Name | Type | | :------ | :------ | | `flag` | `Flag` | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[setFlag](../classes/jupyterlite_application.SingleWidgetShell.md#setflag) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:252 ### `setHidden` > > **`setHidden`**(`hidden`): `void` Show or hide the widget according to a boolean value. #### Parameters | Name | Type | Description | | :------ | :------ | :------ | | `hidden` | `boolean` | `true` to hide the widget, or `false` to show it. #### Notes This is a convenience method for `hide()` and `show()`. | #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[setHidden](../classes/jupyterlite_application.SingleWidgetShell.md#sethidden) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:238 ### `show` > > **`show`**(): `void` Show the widget and make it visible to its parent widget. #### Notes This causes the [isHidden](jupyterlite_application.ISingleWidgetShell.md#ishidden) property to be `false`. If the widget is not explicitly hidden, this is a no-op. #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[show](../classes/jupyterlite_application.SingleWidgetShell.md#show) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:220 ### `testFlag` > > **`testFlag`**(`flag`): `boolean` Test whether the given widget flag is set. #### Notes This will not typically be called directly by user code. #### Parameters | Name | Type | | :------ | :------ | | `flag` | `Flag` | #### Returns `boolean` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[testFlag](../classes/jupyterlite_application.SingleWidgetShell.md#testflag) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:245 ### `toggleClass` > > **`toggleClass`**(`name`, `force?`): `boolean` Toggle a class name on the widget's DOM node. #### Parameters | Name | Type | Description | | :------ | :------ | :------ | | `name` | `string` | The class name to toggle on the node. | | `force?` | `boolean` | Whether to force add the class (`true`) or force remove the class (`false`). If not provided, the presence of the class will be toggled from its current state. | #### Returns `boolean` `true` if the class is now present, `false` otherwise. #### Notes The class name must not contain whitespace. #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[toggleClass](../classes/jupyterlite_application.SingleWidgetShell.md#toggleclass) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:183 ### `update` > > **`update`**(): `void` Post an `'update-request'` message to the widget. #### Notes This is a simple convenience method for posting the message. #### Returns `void` #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[update](../classes/jupyterlite_application.SingleWidgetShell.md#update) #### Defined in node_modules/@lumino/widgets/types/widget.d.ts:190 ### `widgets` > > **`widgets`**(`area`): `IterableIterator`<`Widget`\> Return the list of widgets for the given area. #### Parameters | Name | Type | Description | | :------ | :------ | :------ | | `area` | ``"main"`` | The area | #### Returns `IterableIterator`<`Widget`\> #### Inherited from [SingleWidgetShell](../classes/jupyterlite_application.SingleWidgetShell.md).[widgets](../classes/jupyterlite_application.SingleWidgetShell.md#widgets) #### Defined in [packages/application/src/singleWidgetShell.ts:103](https://github.com/jupyterlite/jupyterlite/blob/999c7f0/packages/application/src/singleWidgetShell.ts#L103)