Panel

Extend this class to show a custom panel to the user, whose contents are displayed in a sandboxed
iframe controlled by your extension.

To pass a message to a script running in the panel, call sendMessage. The data you pass in will be
sent to the iframe with window.postMessage.

To pass messages back from the panel to this class, call parent.postMessage from within the iframe.
The data sent will be passed along to the messageFromFrame implementation on your Panel class.

Extends

• IframeUI

---

Constructors

new Panel()

ts

new Panel(client, config): Panel

Parameters

Parameter	Type
client	EditorClient
config	PanelConfig

Returns

Panel

Overrides

IframeUI.constructor

---

Properties

client

ts

protected readonly client: EditorClient;

Inherited from

IframeUI.client

---

config

ts

protected readonly config: PanelConfig;

---

framePosition

ts

protected framePosition: object;

The location of this frame within the top-level browser window. This is always updated immediately before
messageFromFrame is called.

h

ts

h: number = 1;

w

ts

w: number = 1;

x

ts

x: number = 0;

y

ts

y: number = 0;

Inherited from

IframeUI.framePosition

---

loaded

ts

protected loaded: boolean = false;

True after the iframe has fired an onload event (not all scripts are necessarily finished executing)

Inherited from

IframeUI.loaded

---

messageActionName

ts

protected messageActionName: string;

Inherited from

IframeUI.messageActionName

---

Methods

frameClosed()

ts

protected frameClosed(): void

Called when the iframe has been removed from the DOM

Returns

void

Inherited from

IframeUI.frameClosed

---

frameLoaded()

ts

protected frameLoaded(): void

Called when the iframe has been constructed, its srcdoc set, and the window loaded event has fired

Returns

void

Inherited from

IframeUI.frameLoaded

---

hide()

ts

hide(): void

Hide this panel if the panel is in the rightDock and it is currently visible.

Returns

void

---

hookMessages()

ts

protected hookMessages(): void

Subclasses must call hookMessages some time before the UI is displayed. A Modal
will call this when the open() method is called, where a Panel will need to do
this in the constructor to watch for the user opening the panel.

Returns

void

Inherited from

IframeUI.hookMessages

---

messageFromFrame()

ts

protected messageFromFrame(message): void

Receives messages sent from the iframe via parent.postMessage(, '*')

Parameters

Parameter	Type	Description
message	any	data sent from the iframe

Returns

void

Inherited from

IframeUI.messageFromFrame

---

sendMessage()

ts

sendMessage(data): Promise<void>

Send a message to this UI component's iframe via window.postMessage.

Parameters

Parameter	Type	Description
data	JsonSerializable	Data to send to the iframe

Returns

Promise<void>

Inherited from

IframeUI.sendMessage

---

show()

ts

show(): void

Show this panel if the panel is in the rightDock and it is not already visible.

Returns

void

---

unhookMessages()

ts

protected unhookMessages(): void

Subclasses must call unhookMessages to allow them to be garbage collected.

Returns

void

Inherited from

IframeUI.unhookMessages