Skip to main content

DockManager

Defined in: js-api/src/docking.ts:116

Window docking manager.

Dock manager manages all the dock panels in a hierarchy, similar to visual studio. It owns an HTML Div element inside which all panels are docked. Initially, the dock manager takes up the central space and acts as the root node.

Samples: https://public.datagrok.ai/js/samples/ui/docking/docking Learn more: https://github.com/coderespawn/dock-spawn for details.

Constructors​

Constructor​

new DockManager(dart): DockManager

Defined in: js-api/src/docking.ts:119

Parameters​

ParameterType
dartany

Returns​

DockManager

Properties​

PropertyTypeDefined in
dartanyjs-api/src/docking.ts:117

Accessors​

documentContainer​

Get Signature​

get documentContainer(): DockContainer

Defined in: js-api/src/docking.ts:138

The document view is then central area of the dock layout hierarchy. This is where more important panels are placed (e.g. the text editor in an IDE, 3D view in a modeling package, etc.)

Returns​

DockContainer


element​

Get Signature​

get element(): HTMLDivElement

Defined in: js-api/src/docking.ts:124

The element that hosts the docked panels.

Returns​

HTMLDivElement


onClosed​

Get Signature​

get onClosed(): Observable<HTMLElement>

Defined in: js-api/src/docking.ts:188

Fires when a docked panel is closed; emits its content element.

Returns​

Observable<HTMLElement>


onPanelHidden​

Get Signature​

get onPanelHidden(): Observable<HTMLElement>

Defined in: js-api/src/docking.ts:196

Fires when a panel stops being visible: its tab is deselected, it is undocked without being re-docked, or it is closed. Emits the panel's content element.

Returns​

Observable<HTMLElement>


onPanelShown​

Get Signature​

get onPanelShown(): Observable<HTMLElement>

Defined in: js-api/src/docking.ts:192

Fires when a panel becomes visible: its tab is selected, it is docked into a visible position, or it is floated into a dialog. Emits the panel's content element.

Returns​

Observable<HTMLElement>


rootNode​

Get Signature​

get rootNode(): DockNode

Defined in: js-api/src/docking.ts:129

The root of the dock tree.

Returns​

DockNode

Methods​

close()​

close(object): void

Defined in: js-api/src/docking.ts:170

Undocks the element.

Parameters​

ParameterTypeDescription
objectHTMLElement | DockNodeElement to undock

Returns​

void


dock()​

dock(element, dockType?, refNode?, title?, ratio?, options?): DockNode

Defined in: js-api/src/docking.ts:158

Docks the element relative to the reference node.

Parameters​

ParameterTypeDefault valueDescription
elementHTMLElement | Viewer<any>undefinedElement to dock
dockType"fill" | "left" | "right" | "up" | "down"DG.DOCK_TYPE.LEFTDock type (left
refNodeDockNode | nullnullreference node
title?stringundefinedCaption of the docked panel.
ratio?number0.5Ratio of the area to take (relative to the reference node).
options?IDockOptionsundefinedkillOnClose: kill the element when its pane is closed via the ✕ button — runs cleanups registered with Widget.registerCleanup and detaches nested widgets. Off by default; panes that are closed and later reused must not opt in.

Returns​

DockNode


findNode()​

findNode(element): DockNode | undefined

Defined in: js-api/src/docking.ts:183

Finds the node of an element.

Parameters​

ParameterTypeDescription
elementHTMLElementElement to find the node for.

Returns​

DockNode | undefined

if node is found, undefined otherwise.


loadState()​

loadState(state): void

Defined in: js-api/src/docking.ts:146

Restores a dock layout previously produced by saveState.

Parameters​

ParameterType
statestring

Returns​

void


saveState()​

saveState(): string

Defined in: js-api/src/docking.ts:143

Serializes the current dock layout (panel tree, sizes, orientations) to a JSON string.

Returns​

string