View

Defined in: src/views/view.ts:211

A view is typically docked in the main document area of the Grok platform. See [TableView], [SketchView], etc

Extends

• ViewBase

Extended by

• TableView
• ScriptView
• DataQueryView
• DockView
• CardView

Constructors

Constructor

new View(dart): View

Defined in: src/views/view.ts:217

Parameters

Parameter	Type
dart	any

Returns

View

Constructs

View

Overrides

ViewBase.constructor

Properties

Property	Modifier	Type	Default value	Description	Overrides	Inherited from	Defined in
_functions	protected	Func[]	[]	-	-	ViewBase._functions	src/widgets/base.ts:243
_name	protected	string	'New View'	-	-	ViewBase._name	src/views/view.ts:100
_properties	protected	Property[]	[]	-	-	ViewBase._properties	src/widgets/base.ts:242
_root	protected	HTMLElement	undefined	-	-	ViewBase._root	src/widgets/base.ts:241
dart	public	any	undefined	-	-	ViewBase.dart	src/views/view.ts:46
factory	public	Func | null	null	Constructor function. No parameters, returns [Widget].	-	ViewBase.factory	src/widgets/base.ts:239
isDetached	public	boolean	false	-	-	ViewBase.isDetached	src/widgets/base.ts:247
props	public	any	undefined	-	-	ViewBase.props	src/widgets/base.ts:244
subs	public	Subscription[]	undefined	-	-	ViewBase.subs	src/views/view.ts:47
temp	public	any	undefined	Contains auxiliary information	ViewBase.temp	-	src/views/view.ts:214
ALL_VIEW_TYPES	readonly	string[]	undefined	-	-	-	src/views/view.ts:366
APPS	readonly	"apps"	'apps'	-	-	-	src/views/view.ts:336
BROWSE	readonly	"browse"	'browse'	-	-	-	src/views/view.ts:363
DATA_CONNECTIONS	readonly	"connections"	'connections'	-	-	-	src/views/view.ts:350
DATA_JOB_RUNS	readonly	"jobs"	'jobs'	-	-	-	src/views/view.ts:351
DATA_QUERY_RUNS	readonly	"queryruns"	'queryruns'	-	-	-	src/views/view.ts:353
DATABASES	readonly	"databases"	'databases'	-	-	-	src/views/view.ts:346
DOCKERS	readonly	"dockers"	'dockers'	-	-	-	src/views/view.ts:364
EMAILS	readonly	"emails"	'emails'	-	-	-	src/views/view.ts:354
FILES	readonly	"files"	'files'	-	-	-	src/views/view.ts:352
FORUM	readonly	"forum"	'forum'	-	-	-	src/views/view.ts:341
FUNCTIONS	readonly	"functions"	'functions'	-	-	-	src/views/view.ts:349
GROUPS	readonly	"groups"	'groups'	-	-	-	src/views/view.ts:355
HELP	readonly	"help"	'help'	-	-	-	src/views/view.ts:344
JS_EDITOR	readonly	"js"	'js'	-	-	-	src/views/view.ts:362
MODELS	readonly	"models"	'models'	-	-	-	src/views/view.ts:356
NOTEBOOKS	readonly	"notebooks"	'notebooks'	-	-	-	src/views/view.ts:343
OPEN_TEXT	readonly	"text"	'text'	-	-	-	src/views/view.ts:345
PACKAGE_REPOSITORIES	readonly	"repositories"	'repositories'	-	-	-	src/views/view.ts:361
PACKAGES	readonly	"packages"	'packages'	-	-	-	src/views/view.ts:360
PROJECTS	readonly	"projects"	'projects'	-	-	-	src/views/view.ts:342
QUERIES	readonly	"queries"	'queries'	-	-	-	src/views/view.ts:357
SCRIPT	readonly	"script"	'script'	-	-	-	src/views/view.ts:339
SCRIPTS	readonly	"scripts"	'scripts'	-	-	-	src/views/view.ts:358
SETTINGS	readonly	"settings"	'settings'	-	-	-	src/views/view.ts:337
SKETCH	readonly	"sketch"	'sketch'	-	-	-	src/views/view.ts:340
USERS	readonly	"users"	'users'	-	-	-	src/views/view.ts:359
VIEW_LAYOUTS	readonly	"layouts"	'layouts'	-	-	-	src/views/view.ts:348
WEB_SERVICES	readonly	"webservices"	'webservices'	-	-	-	src/views/view.ts:347
WELCOME	readonly	"welcome"	'welcome'	-	-	-	src/views/view.ts:338

Accessors

basePath

Get Signature

get basePath(): string

Defined in: src/views/view.ts:125

Deprecated

use path instead

Returns

string

Set Signature

set basePath(s): void

Defined in: src/views/view.ts:126

Parameters

Parameter	Type
s	string

Returns

void

Inherited from

ViewBase.basePath

---

box

Get Signature

get box(): boolean

Defined in: src/views/view.ts:73

Returns

boolean

Set Signature

set box(b): void

Defined in: src/views/view.ts:74

Parameters

Parameter	Type
b	boolean

Returns

void

Inherited from

ViewBase.box

---

children

Get Signature

get children(): Widget<any>[]

Defined in: src/widgets/base.ts:320

Parent widget up the DOM tree, or null.

Returns

Widget<any>[]

Inherited from

ViewBase.children

---

closing

Get Signature

get closing(): boolean

Defined in: src/views/view.ts:143

Whether the view is currently closing.

Returns

boolean

Set Signature

set closing(c): void

Defined in: src/views/view.ts:144

Parameters

Parameter	Type
c	boolean

Returns

void

Inherited from

ViewBase.closing

---

description

Get Signature

get description(): string

Defined in: src/views/view.ts:279

View description. Used in UI and AI.

Returns

string

Set Signature

set description(s): void

Defined in: src/views/view.ts:280

Parameters

Parameter	Type
s	string

Returns

void

Overrides

ViewBase.description

---

entity

Get Signature

get entity(): object | null

Defined in: src/views/view.ts:121

Returns

object | null

Set Signature

set entity(_e): void

Defined in: src/views/view.ts:122

Parameters

Parameter	Type
_e	object | null

Returns

void

Inherited from

ViewBase.entity

---

helpUrl

Get Signature

get helpUrl(): string | null

Defined in: src/views/view.ts:283

Returns

string | null

View help URL.

Set Signature

set helpUrl(url): void

Defined in: src/views/view.ts:284

Parameters

Parameter	Type
url	string | null

Returns

void

View help URL.

Overrides

ViewBase.helpUrl

---

id

Get Signature

get id(): string

Defined in: src/views/view.ts:274

Returns

string

---

isPinned

Get Signature

get isPinned(): boolean

Defined in: src/views/view.ts:287

Returns

boolean

Whether the view is pinned. Pinned views are not closed when a new view is opened.

---

name

Get Signature

get name(): string

Defined in: src/views/view.ts:318

View name. It gets shown in the tab handle.

Returns

string

Set Signature

set name(s): void

Defined in: src/views/view.ts:323

Parameters

Parameter	Type
s	string

Returns

void

Overrides

ViewBase.name

---

parent

Get Signature

get parent(): Widget<any> | null

Defined in: src/widgets/base.ts:317

Parent widget up the DOM tree, or null.

Returns

Widget<any> | null

Inherited from

ViewBase.parent

---

parentCall

Get Signature

get parentCall(): FuncCall | undefined

Defined in: src/views/view.ts:112

Returns

FuncCall | undefined

Set Signature

set parentCall(s): void

Defined in: src/views/view.ts:113

Parameters

Parameter	Type
s	FuncCall | undefined

Returns

void

Inherited from

MultiView.parentCall

---

parentView

Get Signature

get parentView(): ViewBase

Defined in: src/views/view.ts:115

Returns

ViewBase

Set Signature

set parentView(s): void

Defined in: src/views/view.ts:116

Parameters

Parameter	Type
s	ViewBase

Returns

void

Inherited from

ViewBase.parentView

---

path

Get Signature

get path(): string

Defined in: src/views/view.ts:170

View URI, relative to the view root

Returns

string

Set Signature

set path(s): void

Defined in: src/views/view.ts:171

Parameters

Parameter	Type
s	string

Returns

void

Inherited from

ViewBase.path

---

ribbonMenu

Get Signature

get ribbonMenu(): Menu

Defined in: src/views/view.ts:135

View menu. Sample: https://public.datagrok.ai/js/samples/ui/views/ribbon

Returns

Menu

Set Signature

set ribbonMenu(menu): void

Defined in: src/views/view.ts:136

Parameters

Parameter	Type
menu	Menu

Returns

void

Inherited from

ViewBase.ribbonMenu

---

root

Get Signature

get root(): HTMLElement

Defined in: src/views/view.ts:266

Returns the content (visual root) of this view.

Returns

HTMLElement

Overrides

ViewBase.root

---

statusBarPanels

Get Signature

get statusBarPanels(): HTMLDivElement[]

Defined in: src/views/view.ts:139

Status bar panels to be shown on the bottom

Returns

HTMLDivElement[]

Set Signature

set statusBarPanels(panels): void

Defined in: src/views/view.ts:140

Parameters

Parameter	Type
panels	HTMLDivElement[]

Returns

void

Inherited from

ViewBase.statusBarPanels

---

toolbox

Get Signature

get toolbox(): HTMLElement

Defined in: src/views/view.ts:130

View toolbox. Sample: https://public.datagrok.ai/js/samples/ui/views/toolbox

Returns

HTMLElement

Set Signature

set toolbox(x): void

Defined in: src/views/view.ts:131

Parameters

Parameter	Type
x	HTMLElement

Returns

void

Inherited from

ViewBase.toolbox

---

type

Get Signature

get type(): string

Defined in: src/views/view.ts:270

View type

Returns

string

Overrides

ViewBase.type

Methods

_onAdded()

_onAdded(): void

Defined in: src/views/view.ts:331

Returns

void

---

acceptsPath()

acceptsPath(_urlPath): boolean

Defined in: src/views/view.ts:178

Checks if URL path is acceptable. Override in subclasses.

Parameters

Parameter	Type
_urlPath	string

Returns

boolean

"true" if path is acceptable, "false" otherwise.

Inherited from

ViewBase.acceptsPath

---

append()

append(item): HTMLElement

Defined in: src/views/view.ts:183

Appends an item to this view. Use appendAll for appending multiple elements.

Parameters

Parameter	Type	Description
item	any	-

Returns

HTMLElement

Inherited from

ViewBase.append

---

appendAll()

appendAll(items): HTMLElement

Defined in: src/views/view.ts:190

Appends multiple elements this view. Use append for appending a single element.

Parameters

Parameter	Type	Description
items	HTMLElement[]	-

Returns

HTMLElement

Inherited from

ViewBase.appendAll

---

apply()

apply(properties): Widget

Defined in: src/widgets/base.ts:284

Parameters

Parameter	Type	Description
properties	object	-

Returns

Widget

Inherited from

ViewBase.apply

---

close()

close(): void

Defined in: src/views/view.ts:200

Closes this view.

Returns

void

Inherited from

ViewBase.close

---

detach()

detach(): void

Defined in: src/views/view.ts:195

Detaches this view.

Returns

void

Inherited from

ViewBase.detach

---

getDartProperties()

getDartProperties(): any[]

Defined in: src/widgets/base.ts:305

Returns

any[]

Inherited from

ViewBase.getDartProperties

---

getFunctions()

getFunctions(): Func[]

Defined in: src/views/view.ts:263

Functions that are applicable to this particular widget. Used in the UI to display context actions, and for the AI integrations.

Returns

Func[]

Overrides

ViewBase.getFunctions

---

getIcon()

getIcon(): HTMLElement | null

Defined in: src/views/view.ts:159

Returns

HTMLElement | null

View icon. Override in subclasses.

Inherited from

ViewBase.getIcon

---

getInfo()

getInfo(): ViewLayout

Defined in: src/views/view.ts:312

Saves view as a ViewInfo. Only applicable to certain views, such as TableView.

Returns

ViewLayout

---

getProperties()

getProperties(): Property[]

Defined in: src/views/view.ts:262

Returns all properties of this widget.

Returns

Property[]

Overrides

ViewBase.getProperties

---

getRibbonPanels()

getRibbonPanels(): HTMLElement[][]

Defined in: src/views/view.ts:154

Returns

HTMLElement[][]

Inherited from

ViewBase.getRibbonPanels

---

getWidgetStatus()

getWidgetStatus(): IWidgetStatus

Defined in: src/widgets/base.ts:371

Returns the widget's runtime structure for automated testing and introspection.

Returns

IWidgetStatus

Inherited from

ViewBase.getWidgetStatus

---

handlePath()

handlePath(_urlPath): void

Defined in: src/views/view.ts:174

Handles URL path. Override in subclasses.

Parameters

Parameter	Type
_urlPath	string

Returns

void

Inherited from

ViewBase.handlePath

---

loadLayout()

loadLayout(layout, pickupColumnTags?): void

Defined in: src/views/view.ts:297

Loads previously saved view layout. Only applicable to certain views, such as TableView. See also saveLayout

Parameters

Parameter	Type
layout	ViewLayout
pickupColumnTags?	boolean

Returns

void

---

loadStateMap()

loadStateMap(_stateMap): void

Defined in: src/views/view.ts:167

Loads view state map. Override in subclasses.

Parameters

Parameter	Type
_stateMap	object

Returns

void

Inherited from

ViewBase.loadStateMap

---

onEvent()

onEvent(eventId?): Observable<any>

Defined in: src/widgets/base.ts:368

Observes events with the specified eventId. Override in subclasses to provide actual events.

Parameters

Parameter	Type	Default value
eventId	string | null	null

Returns

Observable<any>

Inherited from

ViewBase.onEvent

---

onFrameAttached()

onFrameAttached(dataFrame): void

Defined in: src/widgets/base.ts:311

Parameters

Parameter	Type
dataFrame	DataFrame

Returns

void

Inherited from

ViewBase.onFrameAttached

---

onPropertyChanged()

onPropertyChanged(property): void

Defined in: src/widgets/base.ts:303

Gets called when viewer's property is changed.

Parameters

Parameter	Type	Description
property	Property | null	or null, if multiple properties were changed.

Returns

void

Inherited from

ViewBase.onPropertyChanged

---

pin()

pin(): void

Defined in: src/views/view.ts:290

Pins the view. Pinned views are not closed when a new view is opened.

Returns

void

---

saveLayout()

saveLayout(options?): ViewLayout

Defined in: src/views/view.ts:305

Saves view layout as a string. Only applicable to certain views, such as TableView. See also loadLayout

Parameters

Parameter	Type
options?	{ saveWithData?: boolean; }
options.saveWithData?	boolean

Returns

ViewLayout

---

saveStateMap()

saveStateMap(): object | null

Defined in: src/views/view.ts:164

Returns

object | null

Viewer state map. Override in subclasses.

Inherited from

ViewBase.saveStateMap

---

setIcon()

setIcon(icon): void

Defined in: src/views/view.ts:161

Parameters

Parameter	Type
icon	HTMLElement

Returns

void

Inherited from

ViewBase.setIcon

---

setRibbonPanels()

setRibbonPanels(panels, clear?): void

Defined in: src/views/view.ts:150

Sets custom view panels on the ribbon.

Parameters

Parameter	Type	Default value	Description
panels	HTMLElement[][]	undefined	-
clear	boolean	true	Clear all previous before setup Sample: https://public.datagrok.ai/js/samples/ui/views/ribbon

Returns

void

Inherited from

ViewBase.setRibbonPanels

---

sourceRowsChanged()

sourceRowsChanged(): void

Defined in: src/widgets/base.ts:309

Returns

void

Inherited from

ViewBase.sourceRowsChanged

---

sub()

sub(subscription): void

Defined in: src/widgets/base.ts:277

Registers a subscription to an external event.

Parameters

Parameter	Type	Description
subscription	Subscription	-

Returns

void

Inherited from

ViewBase.sub

---

toDart()

toDart(): any

Defined in: src/widgets/base.ts:269

Returns

any

Inherited from

ViewBase.toDart

---

create()

static create(options?): View

Defined in: src/views/view.ts:246

Creates a new empty view.

Parameters

Parameter	Type	Description
options?	string | { } | null	-

Returns

View

---

createByType()

static createByType(viewType, options?): View

Defined in: src/views/view.ts:254

Creates one of the standard views based on the view type (such as 'functions')

Parameters

Parameter	Type
viewType	string
options?	any

Returns

View

---

find()

static find(root): Widget<any> | null

Defined in: src/widgets/base.ts:265

Finds existing widget from its visual root.

Parameters

Parameter	Type
root	Element

Returns

Widget<any> | null

Inherited from

ViewBase.find

---

forObject()

static forObject(x): View | null

Defined in: src/views/view.ts:232

Creates a view for the specified object, if it is registered, or null otherwise.

Parameters

Parameter	Type
x	any

Returns

View | null

---

fromDart()

static fromDart(dart): TableView | View

Defined in: src/views/view.ts:223

Parameters

Parameter	Type
dart	any

Returns

TableView | View

---

fromRoot()

static fromRoot(root): View

Defined in: src/views/view.ts:237

Creates and returns a view with the specified element inside.

Parameters

Parameter	Type
root	HTMLElement

Returns

View

Overrides

ViewBase.fromRoot

---

fromViewAsync()

static fromViewAsync(getViewAsync, ribbon?): any

Defined in: src/views/view.ts:258

Parameters

Parameter	Type	Default value
getViewAsync	() => Promise<View>	undefined
ribbon	boolean	true

Returns

any

---

getAll()

static getAll(): Widget<any>[]

Defined in: src/widgets/base.ts:260

Returns all currently active widgets.

Returns

Widget<any>[]

Inherited from

ViewBase.getAll