Skip to content

BlockSuite API Documentation / @blocksuite/blocks / FramePreview

Class: FramePreview

Extends

Constructors

new FramePreview()

new FramePreview(): FramePreview

Returns

FramePreview

Inherited from

WithDisposable(ShadowlessElement).constructor

Defined in

node_modules/@lit/reactive-element/development/reactive-element.d.ts:504

Other

_disposables

protected _disposables: DisposableGroup

Inherited from

WithDisposable(ShadowlessElement)._disposables

Defined in

packages/framework/global/dist/utils/with-disposable.d.ts:5


disposables

readonly disposables: DisposableGroup

Inherited from

WithDisposable(ShadowlessElement).disposables

Defined in

packages/framework/global/dist/utils/with-disposable.d.ts:6


disableShadowRoot

static disableShadowRoot: boolean

Inherited from

WithDisposable(ShadowlessElement).disableShadowRoot

Defined in

packages/framework/block-std/dist/view/element/shadowless-element.d.ts:4


styles

static styles: CSSResult

Overrides

WithDisposable(ShadowlessElement).styles

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:60


_originalDoc

get _originalDoc(): Doc

Returns

Doc

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:99


fillScreen

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:219


frame

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:222


frameViewportWH

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:225


previewEditor

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:231


surfaceHeight

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:234


surfaceWidth

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:237

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.

ts
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

WithDisposable(ShadowlessElement).connectedCallback

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:187


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.

ts
disconnectedCallback() {
  super.disconnectedCallback();
  window.removeEventListener('keydown', this._handleKeydown);
}

An element may be re-connected after being disconnected.

Returns

void

Overrides

WithDisposable(ShadowlessElement).disconnectedCallback

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:195

rendering

createRenderRoot()

createRenderRoot(): HTMLElement | DocumentFragment

Returns

HTMLElement | DocumentFragment

Inherited from

WithDisposable(ShadowlessElement).createRenderRoot

Defined in

packages/framework/block-std/dist/view/element/shadowless-element.d.ts:6


render()

render(): TemplateResult<1>

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

TemplateResult<1>

Overrides

WithDisposable(ShadowlessElement).render

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:200

styles

finalizeStyles()

protected static finalizeStyles(styles?): CSSResultOrNative[]

Takes the styles the user supplied via the static styles property and returns the array of styles to apply to the element. Override this method to integrate into a style management system.

Styles are deduplicated preserving the last instance in the list. This is a performance optimization to avoid duplicated styles that can occur especially when composing via subclassing. The last item is kept to try to preserve the cascade order with the assumption that it's most important that last added styles override previous styles.

Parameters

styles?: CSSResultGroup

Returns

CSSResultOrNative[]

Nocollapse

Inherited from

WithDisposable(ShadowlessElement).finalizeStyles

Defined in

packages/framework/block-std/dist/view/element/shadowless-element.d.ts:5

updates

updated()

updated(_changedProperties): void

Invoked whenever the element is updated. Implement to perform post-updating tasks via DOM APIs, for example, focusing an element.

Setting properties inside this method will trigger the element to update again after this update cycle completes.

Parameters

_changedProperties: PropertyValueMap<any> | Map<PropertyKey, unknown>

Map of changed properties with old values

Returns

void

Overrides

WithDisposable(ShadowlessElement).updated

Defined in

packages/blocks/src/root-block/edgeless/components/frame/frame-preview.ts:209