Skip to main content
Version: 8.1

system.perspective.alterDock

New in 8.1.19

This function is used in Python Scripting.

Description​

Changes configuration of a specified dock on a Perspective Page.

Syntax​

tip

This function accepts keyword arguments.

system.perspective.alterDock(dockId, [dockConfig])

Parameters​

TypeParameterDescription
StringdockIdThe ID of the dock to be altered. If no such dock exists on the current page with the given ID, a warning will be logged to the console.
ObjectdockConfigThe new configuration for the dock. All properties are optional, and any properties not specified will remain unchanged. See the dockConfig Object Shape below. [optional]

Returns​

Nothing

Scope​

Perspective Session

dockConfig Object Shape​

dockConfig {
view: string;
viewParams: object;
display: enum('visible', 'onDemand', 'auto');
resizable: boolean;
modal: boolean;
content: enum('push', 'cover', 'auto');
size: number;
autoBreakpoint: number;
anchor: enum('fixed', 'scrollable')`;
handle: enum('show', 'hide', 'autoHide');
handleIcon: string;
}

Code Examples​

Code Snippet

# Change the size of a dock with the id 'my-dock-id'
system.perspective.alterDock('my-dock-id', { 'size': 500 } )

Keywords​

system perspective alterDock, perspective.alterDock