BlockSuite API Documentation / @blocksuite/block-std / WidgetComponent
Class: WidgetComponent<Model, B, S>
Extends
LitElement
<this
> &DisposableClass
<this
>
Extended by
Type Parameters
• Model extends BlockModel
= BlockModel
• B extends BlockComponent
= BlockComponent
• S extends BlockService
= BlockService
Constructors
new WidgetComponent()
new WidgetComponent<
Model
,B
,S
>():WidgetComponent
<Model
,B
,S
>
Returns
WidgetComponent
<Model
, B
, S
>
Inherited from
SignalWatcher(WithDisposable(LitElement)).constructor
Defined in
node_modules/@lit/reactive-element/development/reactive-element.d.ts:504
Other
_disposables
protected
_disposables:DisposableGroup
Inherited from
SignalWatcher(WithDisposable(LitElement))._disposables
Defined in
packages/framework/global/dist/utils/with-disposable.d.ts:5
disposables
readonly
disposables:DisposableGroup
Inherited from
SignalWatcher(WithDisposable(LitElement)).disposables
Defined in
packages/framework/global/dist/utils/with-disposable.d.ts:6
virtualKeyboardPolicy
virtualKeyboardPolicy:
string
Inherited from
SignalWatcher(WithDisposable(LitElement)).virtualKeyboardPolicy
Defined in
packages/framework/global/dist/types/virtual-keyboard.d.ts:20
block
get
block():B
Returns
B
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:32
doc
get
doc():Doc
Returns
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:36
flavour
get
flavour():string
Returns
string
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:40
host
get
host():EditorHost
Returns
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:44
model
get
model():Model
Returns
Model
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:48
service
get
service():S
Returns
S
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:52
std
get
std():BlockStdScope
Returns
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:56
widgetId
get
widgetId():string
Returns
string
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:60
bindHotKey()
bindHotKey(
keymap
,options
?):void
Parameters
• keymap: Record
<string
, UIEventHandler
>
• options?
• options.global?: boolean
Returns
void
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:64
handleEvent()
handleEvent(
name
,handler
,options
?):void
Parameters
• name: "click"
| "doubleClick"
| "tripleClick"
| "pointerDown"
| "pointerMove"
| "pointerUp"
| "pointerOut"
| "dragStart"
| "dragMove"
| "dragEnd"
| "pinch"
| "pan"
| "keyDown"
| "keyUp"
| "selectionChange"
| "compositionStart"
| "compositionUpdate"
| "compositionEnd"
| "cut"
| "copy"
| "paste"
| "nativeDragStart"
| "nativeDragMove"
| "nativeDragEnd"
| "nativeDrop"
| "beforeInput"
| "blur"
| "focus"
| "contextMenu"
| "wheel"
• handler: UIEventHandler
• options?
• options.global?: boolean
Returns
void
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:20
lifecycle
connectedCallback()
connectedCallback():
void
Invoked when the component is added to the document's DOM.
In connectedCallback()
you should setup tasks that should only occur when the element is connected to the document. The most common of these is adding event listeners to nodes external to the element, like a keydown event handler added to the window.
connectedCallback() {
super.connectedCallback();
addEventListener('keydown', this._handleKeydown);
}
Typically, anything done in connectedCallback()
should be undone when the element is disconnected, in disconnectedCallback()
.
Returns
void
Overrides
SignalWatcher(WithDisposable(LitElement)).connectedCallback
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:75
disconnectedCallback()
disconnectedCallback():
void
Invoked when the component is removed from the document's DOM.
This callback is the main signal to the element that it may no longer be used. disconnectedCallback()
should ensure that nothing is holding a reference to the element (such as event listeners added to nodes external to the element), so that it is free to be garbage collected.
disconnectedCallback() {
super.disconnectedCallback();
window.removeEventListener('keydown', this._handleKeydown);
}
An element may be re-connected after being disconnected.
Returns
void
Overrides
SignalWatcher(WithDisposable(LitElement)).disconnectedCallback
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:85
rendering
render()
render():
unknown
Invoked on each update to perform rendering tasks. This method may return any value renderable by lit-html's ChildPart
- typically a TemplateResult
. Setting properties inside this method will not trigger the element to update.
Returns
unknown
Overrides
SignalWatcher(WithDisposable(LitElement)).render
Defined in
packages/framework/block-std/src/view/element/widget-component.ts:94