Skip to main content

TableView

Defined in: js-api/src/views/view.ts:424

A View that is associated with a DataFrame and exposes exploratory data analysis functionality. This view gets opened whenever a new table is added to the workspace when a user drag-and-drops a CSV file, or opens a table in any other way.

Extends

Constructors

Constructor

new TableView(dart): TableView

Defined in: js-api/src/views/view.ts:426

Parameters

ParameterType
dartany

Returns

TableView

Constructs

TableView

Overrides

View.constructor

Properties

PropertyModifierTypeDefault valueDescriptionInherited fromDefined in
_functionsprotectedFunc[][]-View._functionsjs-api/src/widgets/base.ts:214
_nameprotectedstring'New View'-View._namejs-api/src/views/view.ts:106
_propertiesprotectedProperty[][]-View._propertiesjs-api/src/widgets/base.ts:213
_rootprotectedHTMLElementundefined-View._rootjs-api/src/u2core/component.ts:423
_u2readonlyComponentStateundefined-View._u2js-api/src/u2core/component.ts:76
componentMeta?publicComponentMetaBaseundefinedThe registry metadata of the tag that built this component, stamped by the spec renderer — the single source the introspection surface below is generated from.View.componentMetajs-api/src/u2core/component.ts:71
dartpublicanyundefined-View.dartjs-api/src/views/view.ts:46
factorypublicFunc | nullnullConstructor function. No parameters, returns [Widget].View.factoryjs-api/src/widgets/base.ts:211
isDetachedpublicbooleanfalse-View.isDetachedjs-api/src/widgets/base.ts:218
propspublicanyundefined-View.propsjs-api/src/widgets/base.ts:215
specProps?publicRecord<string, unknown>undefinedThe props the registry's create was handed, stamped alongside componentMeta: the last resort of the property read below, for a component that keeps a prop under another name or not at all (a create wrapping a bare element). Construction-time values — a live one always wins.View.specPropsjs-api/src/u2core/component.ts:75
subspublicSubscription[]undefined-View.subsjs-api/src/views/view.ts:47
temppublicanyundefinedContains auxiliary informationView.tempjs-api/src/views/view.ts:237
ALL_VIEW_TYPESreadonlystring[]undefined-View.ALL_VIEW_TYPESjs-api/src/views/view.ts:409
APPSreadonly"apps"'apps'-View.APPSjs-api/src/views/view.ts:379
BROWSEreadonly"browse"'browse'-View.BROWSEjs-api/src/views/view.ts:406
DATA_CONNECTIONSreadonly"connections"'connections'-View.DATA_CONNECTIONSjs-api/src/views/view.ts:393
DATA_JOB_RUNSreadonly"jobs"'jobs'-View.DATA_JOB_RUNSjs-api/src/views/view.ts:394
DATA_QUERY_RUNSreadonly"queryruns"'queryruns'-View.DATA_QUERY_RUNSjs-api/src/views/view.ts:396
DATABASESreadonly"databases"'databases'-View.DATABASESjs-api/src/views/view.ts:389
DOCKERSreadonly"dockers"'dockers'-View.DOCKERSjs-api/src/views/view.ts:407
EMAILSreadonly"emails"'emails'-View.EMAILSjs-api/src/views/view.ts:397
FILESreadonly"files"'files'-View.FILESjs-api/src/views/view.ts:395
FORUMreadonly"forum"'forum'-View.FORUMjs-api/src/views/view.ts:384
FUNCTIONSreadonly"functions"'functions'-View.FUNCTIONSjs-api/src/views/view.ts:392
GROUPSreadonly"groups"'groups'-View.GROUPSjs-api/src/views/view.ts:398
HELPreadonly"help"'help'-View.HELPjs-api/src/views/view.ts:387
JS_EDITORreadonly"js"'js'-View.JS_EDITORjs-api/src/views/view.ts:405
MODELSreadonly"models"'models'-View.MODELSjs-api/src/views/view.ts:399
NOTEBOOKSreadonly"notebooks"'notebooks'-View.NOTEBOOKSjs-api/src/views/view.ts:386
OPEN_TEXTreadonly"text"'text'-View.OPEN_TEXTjs-api/src/views/view.ts:388
PACKAGE_REPOSITORIESreadonly"repositories"'repositories'-View.PACKAGE_REPOSITORIESjs-api/src/views/view.ts:404
PACKAGESreadonly"packages"'packages'-View.PACKAGESjs-api/src/views/view.ts:403
PROJECTSreadonly"projects"'projects'-View.PROJECTSjs-api/src/views/view.ts:385
QUERIESreadonly"queries"'queries'-View.QUERIESjs-api/src/views/view.ts:400
SCRIPTreadonly"script"'script'-View.SCRIPTjs-api/src/views/view.ts:382
SCRIPTSreadonly"scripts"'scripts'-View.SCRIPTSjs-api/src/views/view.ts:401
SETTINGSreadonly"settings"'settings'-View.SETTINGSjs-api/src/views/view.ts:380
SKETCHreadonly"sketch"'sketch'-View.SKETCHjs-api/src/views/view.ts:383
USERSreadonly"users"'users'-View.USERSjs-api/src/views/view.ts:402
VIEW_LAYOUTSreadonly"layouts"'layouts'-View.VIEW_LAYOUTSjs-api/src/views/view.ts:391
WEB_SERVICESreadonly"webservices"'webservices'-View.WEB_SERVICESjs-api/src/views/view.ts:390
WELCOMEreadonly"welcome"'welcome'-View.WELCOMEjs-api/src/views/view.ts:381

Accessors

aiDescription

Get Signature

get aiDescription(): string | null

Defined in: js-api/src/views/view.ts:248

AI briefing of the underlying view (widget-level on the Dart side). For a JS-defined view the Dart host forwards to the original ViewBase instance.

Returns

string | null

Set Signature

set aiDescription(x): void

Defined in: js-api/src/views/view.ts:253

A short AI-facing briefing, seeded from the registry's usage or description.

Parameters
ParameterType
xstring | null
Returns

void

Inherited from

View.aiDescription


ambientAdoption

Get Signature

get protected ambientAdoption(): boolean

Defined in: js-api/src/widgets/base.ts:272

A widget wrapper minted inside somebody's effect scope must not be auto-disposed with it.

Returns

boolean

Inherited from

View.ambientAdoption


basePath

Get Signature

get basePath(): string

Defined in: js-api/src/views/view.ts:131

Deprecated

use path instead

Returns

string

Set Signature

set basePath(s): void

Defined in: js-api/src/views/view.ts:132

Parameters
ParameterType
sstring
Returns

void

Inherited from

View.basePath


box

Get Signature

get box(): boolean

Defined in: js-api/src/views/view.ts:73

Returns

boolean

Set Signature

set box(b): void

Defined in: js-api/src/views/view.ts:74

Parameters
ParameterType
bboolean
Returns

void

Inherited from

View.box


children

Get Signature

get children(): Widget<any>[]

Defined in: js-api/src/widgets/base.ts:304

Parent widget up the DOM tree, or null.

Returns

Widget<any>[]

Inherited from

View.children


closing

Get Signature

get closing(): boolean

Defined in: js-api/src/views/view.ts:149

Whether the view is currently closing.

Returns

boolean

Set Signature

set closing(c): void

Defined in: js-api/src/views/view.ts:150

Parameters
ParameterType
cboolean
Returns

void

Inherited from

View.closing


dataFrame

Get Signature

get dataFrame(): DataFrame

Defined in: js-api/src/views/view.ts:452

Returns

DataFrame

Set Signature

set dataFrame(x): void

Defined in: js-api/src/views/view.ts:453

Parameters
ParameterType
xDataFrame
Returns

void


description

Get Signature

get description(): string

Defined in: js-api/src/views/view.ts:323

View description. Used in UI and AI.

Returns

string

Set Signature

set description(s): void

Defined in: js-api/src/views/view.ts:324

Parameters
ParameterType
sstring
Returns

void

Inherited from

View.description


dockManager

Get Signature

get dockManager(): DockManager

Defined in: js-api/src/views/view.ts:493

View's dock manager. Only defined for DockView descendants such as TableView, UsersView, etc.

Returns

DockManager


dockNode

Get Signature

get dockNode(): DockNode

Defined in: js-api/src/views/view.ts:486

A dock node for this view. Use grok.shell.dockManager to manipulate it; dockManager is for controlling windows that reside inside this view.

Returns

DockNode


entity

Get Signature

get entity(): object | null

Defined in: js-api/src/views/view.ts:127

Returns

object | null

Set Signature

set entity(_e): void

Defined in: js-api/src/views/view.ts:128

Parameters
ParameterType
_eobject | null
Returns

void

Inherited from

View.entity


grid

Get Signature

get grid(): Grid

Defined in: js-api/src/views/view.ts:445

Associated grid (spreadsheet).

Returns

Grid


helpUrl

Get Signature

get helpUrl(): string | null

Defined in: js-api/src/views/view.ts:327

Returns

string | null

View help URL.

Set Signature

set helpUrl(url): void

Defined in: js-api/src/views/view.ts:328

Parameters
ParameterType
urlstring | null
Returns

void

View help URL.

Inherited from

View.helpUrl


id

Get Signature

get id(): string

Defined in: js-api/src/views/view.ts:318

Returns

string

Inherited from

View.id


isPinned

Get Signature

get isPinned(): boolean

Defined in: js-api/src/views/view.ts:331

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

Returns

boolean

Set Signature

set isPinned(value): void

Defined in: js-api/src/views/view.ts:332

Parameters
ParameterType
valueboolean
Returns

void

Inherited from

View.isPinned


jsView

Get Signature

get jsView(): ViewBase | null

Defined in: js-api/src/views/view.ts:262

The original JS ViewBase instance when this view hosts a JS-defined view (e.g. a plugin app view), null for native Dart views. Lets callers reach the actual view class (its methods, tools, state) from grok.shell.v.

Returns

ViewBase | null

Inherited from

View.jsView


name

Get Signature

get name(): string

Defined in: js-api/src/views/view.ts:361

View name. It gets shown in the tab handle.

Returns

string

Set Signature

set name(s): void

Defined in: js-api/src/views/view.ts:366

Parameters
ParameterType
sstring
Returns

void

Inherited from

SpaceView.name


parent

Get Signature

get parent(): Widget<any> | null

Defined in: js-api/src/widgets/base.ts:301

Parent widget up the DOM tree, or null.

Returns

Widget<any> | null

Inherited from

View.parent


parentCall

Get Signature

get parentCall(): FuncCall | undefined

Defined in: js-api/src/views/view.ts:118

Returns

FuncCall | undefined

Set Signature

set parentCall(s): void

Defined in: js-api/src/views/view.ts:119

Parameters
ParameterType
sFuncCall | undefined
Returns

void

Inherited from

MultiView.parentCall


parentView

Get Signature

get parentView(): ViewBase

Defined in: js-api/src/views/view.ts:121

Returns

ViewBase

Set Signature

set parentView(s): void

Defined in: js-api/src/views/view.ts:122

Parameters
ParameterType
sViewBase
Returns

void

Inherited from

View.parentView


path

Get Signature

get path(): string

Defined in: js-api/src/views/view.ts:176

View URI, relative to the view root

Returns

string

Set Signature

set path(s): void

Defined in: js-api/src/views/view.ts:177

Parameters
ParameterType
sstring
Returns

void

Inherited from

View.path


propertyTarget

Get Signature

get propertyTarget(): unknown

Defined in: js-api/src/u2core/component.ts:228

What this component's properties are read from and written to — prop.get(target) / prop.set(target, v): the component itself, unless an adoption says otherwise.

Returns

unknown

Inherited from

View.propertyTarget


propertyTier

Get Signature

get propertyTier(): boolean

Defined in: js-api/src/widgets/base.ts:276

Every property getProperties declares is a bind step, read and written on propertyTarget.

Returns

boolean

Inherited from

View.propertyTier


ribbonMenu

Get Signature

get ribbonMenu(): Menu

Defined in: js-api/src/views/view.ts:141

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

Returns

Menu

Set Signature

set ribbonMenu(menu): void

Defined in: js-api/src/views/view.ts:142

Parameters
ParameterType
menuMenu
Returns

void

Inherited from

View.ribbonMenu


root

Get Signature

get root(): HTMLElement

Defined in: js-api/src/views/view.ts:310

Returns the content (visual root) of this view.

Returns

HTMLElement

Inherited from

View.root


scope

Get Signature

get scope(): Scope

Defined in: js-api/src/u2core/component.ts:53

Minted on first use; assigned before _scopeMinted fires, so the hook's own this.scope.own(...) reads the stored scope instead of re-entering the mint.

Returns

Scope

Inherited from

View.scope


statusBarPanels

Get Signature

get statusBarPanels(): HTMLDivElement[]

Defined in: js-api/src/views/view.ts:145

Status bar panels to be shown on the bottom

Returns

HTMLDivElement[]

Set Signature

set statusBarPanels(panels): void

Defined in: js-api/src/views/view.ts:146

Parameters
ParameterType
panelsHTMLDivElement[]
Returns

void

Inherited from

View.statusBarPanels


syncCurrentObject

Get Signature

get syncCurrentObject(): boolean

Defined in: js-api/src/views/view.ts:683

Returns

boolean

Set Signature

set syncCurrentObject(x): void

Defined in: js-api/src/views/view.ts:684

Parameters
ParameterType
xboolean
Returns

void


table

Get Signature

get table(): DataFrame | null

Defined in: js-api/src/views/view.ts:436

Associated table, if it exists (for TableView), or null.

Returns

DataFrame | null

Set Signature

set table(df): void

Defined in: js-api/src/views/view.ts:440

Parameters
ParameterType
dfDataFrame | null
Returns

void


toolbox

Get Signature

get toolbox(): HTMLElement

Defined in: js-api/src/views/view.ts:136

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

Returns

HTMLElement

Set Signature

set toolbox(x): void

Defined in: js-api/src/views/view.ts:137

Parameters
ParameterType
xHTMLElement
Returns

void

Inherited from

View.toolbox


toolboxPage

Get Signature

get toolboxPage(): ToolboxPage

Defined in: js-api/src/views/view.ts:456

View toolbox that gets shown on the left, in the sidebar

Returns

ToolboxPage


type

Get Signature

get type(): string

Defined in: js-api/src/views/view.ts:314

View type

Returns

string

Inherited from

View.type


viewers

Get Signature

get viewers(): Viewer<any>[]

Defined in: js-api/src/views/view.ts:679

Returns all viewers. Resulting array is cloned, so cache the result and do not call repeatedly in inner loops.

Returns

Viewer<any>[]

Methods

_notifyPropertyChange()

protected _notifyPropertyChange(p): void

Defined in: js-api/src/widgets/base.ts:351

Notifies the property tier. Called from both the addProperty setter (overrides that skip super would otherwise lose props.x = writes) and onPropertyChanged (direct calls); the double notify collapses into one microtask refresh.

Parameters

ParameterType
pProperty | null

Returns

void

Inherited from

View._notifyPropertyChange


_onAdded()

_onAdded(): void

Defined in: js-api/src/views/view.ts:374

Returns

void

Inherited from

View._onAdded


_ownPropertyChanges()

protected _ownPropertyChanges(): ObservableLike<PropertyChange>

Defined in: js-api/src/widgets/base.ts:356

Returns

ObservableLike<PropertyChange>

Inherited from

View._ownPropertyChanges


_scopeMinted()

protected _scopeMinted(_scope): void

Defined in: js-api/src/widgets/base.ts:320

First-mint hook: a platform descendant wires its lifecycle here. Never fired for a scope provided to init — that path runs inside the constructor chain.

Parameters

ParameterType
_scopeScope

Returns

void

Inherited from

View._scopeMinted


_wireDartLifecycle()

protected _wireDartLifecycle(): void

Defined in: js-api/src/widgets/base.ts:336

Dart-owned lifecycle: the platform kill disposes the scope, and disposing the scope kills the widget through the kill-walk.

Returns

void

Inherited from

View._wireDartLifecycle


_wireJsLifecycle()

protected _wireJsLifecycle(): void

Defined in: js-api/src/widgets/base.ts:327

JS-owned lifecycle: disposing the scope detaches the widget, and vice versa.

Returns

void

Inherited from

View._wireJsLifecycle


_wireLifecycle()

protected _wireLifecycle(): void

Defined in: js-api/src/widgets/base.ts:322

Returns

void

Inherited from

View._wireLifecycle


acceptsPath()

acceptsPath(_urlPath): boolean

Defined in: js-api/src/views/view.ts:201

Checks if URL path is acceptable. Override in subclasses.

[_urlPath] is the path WITHOUT the query string: a view claims a URL by its path, and decides what the parameters mean in handlePath.

Parameters

ParameterType
_urlPathstring

Returns

boolean

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

Inherited from

View.acceptsPath


addViewer()

addViewer(v, options?): Viewer

Defined in: js-api/src/views/view.ts:461

Adds a viewer of the specified type.

Parameters

ParameterType
vstring | Viewer<any>
options?any

Returns

Viewer


afterPersist()

protected afterPersist(): void

Defined in: js-api/src/views/view.ts:99

Gets called automatically when this view gets pinned

Returns

void

Inherited from

View.afterPersist


append()

append(item): HTMLElement

Defined in: js-api/src/views/view.ts:206

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

Parameters

ParameterTypeDescription
itemany-

Returns

HTMLElement

Inherited from

View.append


appendAll()

appendAll(items): HTMLElement

Defined in: js-api/src/views/view.ts:213

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

Parameters

ParameterTypeDescription
itemsHTMLElement[]-

Returns

HTMLElement

Inherited from

View.appendAll


apply()

apply(properties): Widget

Defined in: js-api/src/widgets/base.ts:261

Parameters

ParameterTypeDescription
propertiesobject-

Returns

Widget

Inherited from

View.apply


barChart()

barChart(options?): Viewer

Defined in: js-api/src/views/view.ts:508

deprecated: use addViewer(Viewer.barChart(options)) Adds a bar chart. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/bar-chart

Parameters

ParameterType
options?Partial<IBarChartSettings>

Returns

Viewer


bindProps()

bindProps(): BindProp[]

Defined in: js-api/src/u2core/component.ts:285

The signal-backed subset of the meta props — what a binding picker offers on a named node — plus, under propertyTier, every declared property. Allocates no signal.

Returns

BindProp[]

Inherited from

View.bindProps


bindStep()

bindStep(name): BindSource | Signal<unknown> | null

Defined in: js-api/src/u2core/component.ts:274

One binding step (DD5): a meta-declared prop's same-named Signal member — a named node is a bind source, generated off componentMeta the way getProperties is — then, under propertyTier, a cached signal over the declared property. '' answers the default binding: the component's own value signal, where one exists.

Parameters

ParameterType
namestring

Returns

BindSource | Signal<unknown> | null

Inherited from

View.bindStep


boxPlot()

boxPlot(options?): Viewer

Defined in: js-api/src/views/view.ts:515

deprecated: use addViewer(Viewer.boxPlot(options)) Adds a box plot. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/box-plot

Parameters

ParameterType
options?Partial<IBoxPlotSettings>

Returns

Viewer


calendar()

calendar(options?): Viewer

Defined in: js-api/src/views/view.ts:524

deprecated: use addViewer(Viewer.calendar(options)) Adds a calendar. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/calendar

Parameters

ParameterTypeDescription
options?Partial<ICalendarSettings>-

Returns

Viewer


close()

close(): void

Defined in: js-api/src/views/view.ts:223

Closes this view.

Returns

void

Inherited from

View.close


closeAllViewers()

closeAllViewers(): void

Defined in: js-api/src/views/view.ts:477

Closes all viewers in this view, including minimized ones.

Returns

void


corrPlot()

corrPlot(options?): Viewer

Defined in: js-api/src/views/view.ts:531

deprecated: use addViewer(Viewer.corrPlot(options)) Adds a correlation plot. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/corr-plot

Parameters

ParameterType
options?Partial<ICorrelationPlotSettings>

Returns

Viewer


densityPlot()

densityPlot(options?): Viewer

Defined in: js-api/src/views/view.ts:538

deprecated: use addViewer(Viewer.densityPlot(options)) Adds a density plot. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/density-plot

Parameters

ParameterType
options?Partial<IDensityPlotSettings>

Returns

Viewer


detach()

detach(): void

Defined in: js-api/src/views/view.ts:668

Detaches and closes the view.

Returns

void

Overrides

View.detach


detachViewers()

detachViewers(): void

Defined in: js-api/src/views/view.ts:673

Detaches all viewers.

Returns

void


dispose()

dispose(): void

Defined in: js-api/src/u2core/component.ts:141

On a never-engaged wrapper the getter mints here and _scopeMinted wires the lifecycle (own(kill) + the platform cleanup for Dart-owned), so dispose still kills it; re-entry from the kill cleanup is a no-op via the scope's disposed flag.

Returns

void

Inherited from

View.dispose


effect()

effect(fn): this

Defined in: js-api/src/u2core/component.ts:128

Parameters

ParameterType
fn() => void

Returns

this

Inherited from

View.effect


filters()

filters(options?): Viewer

Defined in: js-api/src/views/view.ts:545

deprecated: use addViewer(Viewer.filters(options)) Adds filters. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/filters

Parameters

ParameterType
options?Partial<IFiltersSettings>

Returns

Viewer


fireEvent()

protected fireEvent(eventId, args?): void

Defined in: js-api/src/u2core/component.ts:413

Parameters

ParameterType
eventIdstring
args?unknown

Returns

void

Inherited from

View.fireEvent


focus()

focus(): void

Defined in: js-api/src/views/view.ts:480

Moves keyboard focus to the grid of this view.

Returns

void


form()

form(options?): Viewer

Defined in: js-api/src/views/view.ts:552

deprecated: use addViewer(Viewer.form(options)) Adds default form. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/form

Parameters

ParameterType
options?Partial<IFormSettings>

Returns

Viewer


getDartProperties()

getDartProperties(): any[]

Defined in: js-api/src/widgets/base.ts:289

Returns

any[]

Inherited from

View.getDartProperties


getFiltersGroup()

getFiltersGroup(options?): FilterGroup

Defined in: js-api/src/views/view.ts:448

Returns existing, or creates a new filter group.

Parameters

ParameterType
options?{ createDefaultFilters?: boolean; }
options.createDefaultFilters?boolean

Returns

FilterGroup


getFunctions()

getFunctions(): Func[]

Defined in: js-api/src/views/view.ts:307

Functions applicable to this view. Override in subclasses to return the view's registered package functions — each typically takes the generic view argument and reaches this instance through view.jsView. The Dart JsViewHost forwards its own getFunctions() here, so callers holding grok.shell.v see these functions.

Returns

Func[]

Inherited from

View.getFunctions


getIcon()

getIcon(): HTMLElement | null

Defined in: js-api/src/views/view.ts:165

Returns

HTMLElement | null

View icon. Override in subclasses.

Inherited from

View.getIcon


getInfo()

getInfo(): ViewLayout

Defined in: js-api/src/views/view.ts:355

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

Returns

ViewLayout

Inherited from

View.getInfo


getProperties()

getProperties(): Property[]

Defined in: js-api/src/views/view.ts:306

Returns all properties of this widget: the meta-generated ones plus addProperty's.

Returns

Property[]

Inherited from

View.getProperties


getRibbonPanels()

getRibbonPanels(): HTMLElement[][]

Defined in: js-api/src/views/view.ts:160

Returns

HTMLElement[][]

Inherited from

View.getRibbonPanels


getViewerColumns()

getViewerColumns(): Column<any, any>[]

Defined in: js-api/src/views/view.ts:474

Returns columns that are explicitly used as data columns in non-grid viewers (falls back to grid columns when no custom viewers are present).

Returns

Column<any, any>[]


getWidgetStatus()

getWidgetStatus(): IWidgetStatus

Defined in: js-api/src/widgets/base.ts:422

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

Returns

IWidgetStatus

Inherited from

View.getWidgetStatus


handlePath()

handlePath(_urlPath): void

Defined in: js-api/src/views/view.ts:194

Handles URL path. Override in subclasses.

[_urlPath] is the path WITHOUT the query string (see acceptsPath); the router has already updated the address bar, so read the parameters from window.location.search.

A handler may route elsewhere — set grok.shell.v to another view and the router leaves it alone (it only falls back to this view when the handler changed nothing).

Parameters

ParameterType
_urlPathstring

Returns

void

Inherited from

View.handlePath


heatMap()

heatMap(options?): Viewer

Defined in: js-api/src/views/view.ts:559

deprecated: use addViewer(Viewer.heatMap(options)) Adds a heat map. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/heat-map

Parameters

ParameterType
options?Partial<IGridSettings>

Returns

Viewer


histogram()

histogram(options?): Viewer

Defined in: js-api/src/views/view.ts:501

This and some of the following methods are "softly deprecated" (will likely be deprecated in 1.21): deprecated: use addViewer(Viewer.histogram(options)). Adds a histogram. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/histogram

Parameters

ParameterType
options?Partial<IHistogramSettings>

Returns

Viewer


lineChart()

lineChart(options?): Viewer

Defined in: js-api/src/views/view.ts:566

deprecated: use addViewer(Viewer.histogram(options)) Adds a line chart. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/line-chart

Parameters

ParameterType
options?Partial<ILineChartSettings>

Returns

Viewer


link(name, source, twoWay): void

Defined in: js-api/src/u2core/component.ts:246

Keeps this component's name step and source equal, echo-suppressed by value; the reverse direction only where twoWay. A component that took source as its own signal needs no link and gets none; a read-only step cannot follow anything and gets none either.

Parameters

ParameterType
namestring
sourceSignal<unknown>
twoWayboolean

Returns

void

Inherited from

View.link


loadLayout()

loadLayout(layout, pickupColumnTags?): void

Defined in: js-api/src/views/view.ts:340

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

Parameters

ParameterType
layoutViewLayout
pickupColumnTags?boolean

Returns

void

Inherited from

View.loadLayout


loadState()

loadState(x, options?): void

Defined in: js-api/src/views/view.ts:690

Parameters

ParameterType
xstring
options?IViewStateApplicationOptions

Returns

void


loadStateMap()

loadStateMap(_stateMap): void

Defined in: js-api/src/views/view.ts:173

Loads view state map. Override in subclasses.

Parameters

ParameterType
_stateMapobject

Returns

void

Inherited from

View.loadStateMap


markup()

markup(options?): Viewer

Defined in: js-api/src/views/view.ts:580

deprecated: use addViewer(Viewer.markup(options)) Adds a markup viewer. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/markup

Parameters

ParameterType
options?Partial<IMarkupViewerSettings>

Returns

Viewer


matrixPlot()

matrixPlot(options?): Viewer

Defined in: js-api/src/views/view.ts:587

deprecated: use addViewer(Viewer.matrixPlot(options)) Adds a matrix plot. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/matrix-plot

Parameters

ParameterType
options?Partial<IMatrixPlotSettings>

Returns

Viewer


networkDiagram()

networkDiagram(options?): Viewer

Defined in: js-api/src/views/view.ts:594

deprecated: use addViewer(Viewer.networkDiagram(options)) Adds a network diagram. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/network-diagram

Parameters

ParameterType
options?Partial<INetworkDiagramSettings>

Returns

Viewer


onEvent()

onEvent(eventId?): Observable<any>

Defined in: js-api/src/widgets/base.ts:419

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

Parameters

ParameterTypeDefault value
eventIdstring | nullnull

Returns

Observable<any>

Inherited from

View.onEvent


onFrameAttached()

onFrameAttached(dataFrame): void

Defined in: js-api/src/widgets/base.ts:295

Parameters

ParameterType
dataFrameDataFrame

Returns

void

Inherited from

View.onFrameAttached


onPropertyChanged()

onPropertyChanged(property): void

Defined in: js-api/src/widgets/base.ts:287

Gets called when viewer's property is changed.

Parameters

ParameterTypeDescription
propertyProperty | nullor null, if multiple properties were changed.

Returns

void

Inherited from

View.onPropertyChanged


own()

own(dispose): this

Defined in: js-api/src/u2core/component.ts:133

Parameters

ParameterType
dispose() => void

Returns

this

Inherited from

View.own


pcPlot()

pcPlot(options?): Viewer

Defined in: js-api/src/views/view.ts:601

deprecated: use addViewer(Viewer.pcPlot(options)) Adds a parallel coordinates plot. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/pc-plot

Parameters

ParameterType
options?Partial<IPcPlotSettings>

Returns

Viewer


pieChart()

pieChart(options?): Viewer

Defined in: js-api/src/views/view.ts:608

deprecated: use addViewer(Viewer.pieChart(options)) Adds a pie chart. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/pie-chart

Parameters

ParameterType
options?Partial<IPieChartSettings>

Returns

Viewer


pin()

pin(): void

Defined in: js-api/src/views/view.ts:335

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

Returns

void

Inherited from

View.pin


propertyChanges()

protected propertyChanges(): ObservableLike<PropertyChange>

Defined in: js-api/src/widgets/base.ts:366

What refreshes the property tier's cached signals from outside: null where nothing announces a change (one-way).

Returns

ObservableLike<PropertyChange>

Inherited from

View.propertyChanges


registerFunction()

protected registerFunction(f): void

Defined in: js-api/src/u2core/component.ts:409

Parameters

ParameterType
fFuncLike

Returns

void

Inherited from

View.registerFunction


reloadData()

reloadData(options?): Promise<void>

Defined in: js-api/src/views/view.ts:695

Re-runs the table creation script (for dynamic data), and executes post-processing if enrich is true.

Parameters

ParameterType
options?{ enrich?: boolean; }
options.enrich?boolean

Returns

Promise<void>


resetLayout()

resetLayout(): void

Defined in: js-api/src/views/view.ts:663

Resets view layout, leaving only grid visible.

Returns

void


run()

run<T>(fn): T

Defined in: js-api/src/u2core/component.ts:124

Type Parameters

Type Parameter
T

Parameters

ParameterType
fn() => T

Returns

T

Inherited from

View.run


saveLayout()

saveLayout(options?): ViewLayout

Defined in: js-api/src/views/view.ts:348

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

Parameters

ParameterType
options?{ saveWithData?: boolean; }
options.saveWithData?boolean

Returns

ViewLayout

Inherited from

View.saveLayout


saveState()

saveState(): string

Defined in: js-api/src/views/view.ts:686

Returns

string


saveStateMap()

saveStateMap(): object | null

Defined in: js-api/src/views/view.ts:170

Returns

object | null

Viewer state map. Override in subclasses.

Inherited from

View.saveStateMap


scatterPlot()

scatterPlot(options?): ScatterPlotViewer

Defined in: js-api/src/views/view.ts:615

deprecated: use addViewer(Viewer.scatterPlot(options)) Adds a scatter plot. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/scatter-plot

Parameters

ParameterType
options?Partial<IScatterPlotSettings>

Returns

ScatterPlotViewer


scatterPlot3d()

scatterPlot3d(options?): Viewer

Defined in: js-api/src/views/view.ts:622

deprecated: use addViewer(Viewer.scatterPlot3d(options)) Adds a 3D scatter plot. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/scatter-plot-3d

Parameters

ParameterType
options?Partial<IScatterPlot3dSettings>

Returns

Viewer


setIcon()

setIcon(icon): void

Defined in: js-api/src/views/view.ts:167

Parameters

ParameterType
iconHTMLElement

Returns

void

Inherited from

View.setIcon


setRibbonPanels()

setRibbonPanels(panels, clear?): void

Defined in: js-api/src/views/view.ts:156

Sets custom view panels on the ribbon.

Parameters

ParameterTypeDefault valueDescription
panelsHTMLElement[][]undefined-
clearbooleantrueClear all previous before setup Sample: https://public.datagrok.ai/js/samples/ui/views/ribbon

Returns

void

Inherited from

View.setRibbonPanels


shapeMap()

shapeMap(options?): Viewer

Defined in: js-api/src/views/view.ts:573

deprecated: use addViewer(Viewer.shapeMap(options)) Adds a shape map. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/shape-map

Parameters

ParameterType
options?Partial<IMapViewerSettings>

Returns

Viewer


sourceRowsChanged()

sourceRowsChanged(): void

Defined in: js-api/src/widgets/base.ts:293

Returns

void

Inherited from

View.sourceRowsChanged


statistics()

statistics(options?): Viewer

Defined in: js-api/src/views/view.ts:629

deprecated: use addViewer(Viewer.statistics(options)) Adds a statistics. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/statistics

Parameters

ParameterType
options?Partial<IStatsViewerSettings>

Returns

Viewer


sub()

sub(subscription): void

Defined in: js-api/src/widgets/base.ts:254

Registers a subscription to an external event.

Parameters

ParameterTypeDescription
subscriptionSubscription-

Returns

void

Inherited from

View.sub


tileViewer()

tileViewer(options?): Viewer

Defined in: js-api/src/views/view.ts:636

deprecated: use addViewer(Viewer.histogram(options)) Adds a tile viewer. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/tile-viewer

Parameters

ParameterType
options?Partial<ITileViewerSettings>

Returns

Viewer


toDart()

toDart(): any

Defined in: js-api/src/widgets/base.ts:246

Returns

any

Inherited from

View.toDart


treeMap()

treeMap(options?): Viewer

Defined in: js-api/src/views/view.ts:643

deprecated: use addViewer(Viewer.treeMap(options)) Adds a tree map. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/tree-map

Parameters

ParameterType
options?Partial<ITreeMapSettings>

Returns

Viewer


trellisPlot()

trellisPlot(options?): Viewer

Defined in: js-api/src/views/view.ts:650

deprecated: use addViewer(Viewer.trellisPlot(options)) Adds a trellis plot. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/trellis-plot

Parameters

ParameterType
options?Partial<ITrellisPlotSettings>

Returns

Viewer


wordCloud()

wordCloud(options?): Viewer

Defined in: js-api/src/views/view.ts:658

Adds a word cloud. Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/word-cloud

Parameters

ParameterType
options?any

Returns

Viewer

Deprecated


build()

static build(builder): Control

Defined in: js-api/src/u2core/component.ts:470

Builds a control out of plain elements: builder runs with the new control's scope ambient, so signal bindings and nested components inside it are owned by the result. The ambient scope only spans the synchronous part of builder — components constructed after an await inside it are adopted by nobody and must be disposed by hand, or constructed before the first await.

Parameters

ParameterType
builder() => HTMLElement | (string | HTMLElement | Control)[]

Returns

Control

Inherited from

View.build


create()

static create(table, addToWorkspace?): TableView

Defined in: js-api/src/views/view.ts:431

Creates a new table view, and adds it to the workspace if specified

Parameters

ParameterTypeDefault value
tableDataFrameundefined
addToWorkspacebooleantrue

Returns

TableView

Overrides

View.create


createByType()

static createByType(viewType, options?): View

Defined in: js-api/src/views/view.ts:298

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

Parameters

ParameterType
viewTypestring
options?any

Returns

View

Inherited from

View.createByType


find()

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

Defined in: js-api/src/widgets/base.ts:236

Finds existing widget from its visual root.

Parameters

ParameterType
rootElement

Returns

Widget<any> | null

Inherited from

View.find


forObject()

static forObject(x): View | null

Defined in: js-api/src/views/view.ts:276

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

Parameters

ParameterType
xany

Returns

View | null

Inherited from

View.forObject


fromDart()

static fromDart(dart): TableView | View

Defined in: js-api/src/views/view.ts:267

Parameters

ParameterType
dartany

Returns

TableView | View

Inherited from

View.fromDart


fromRoot()

static fromRoot(root): View

Defined in: js-api/src/views/view.ts:281

Creates and returns a view with the specified element inside.

Parameters

ParameterType
rootHTMLElement

Returns

View

Inherited from

View.fromRoot


fromViewAsync()

static fromViewAsync(getViewAsync, ribbon?): any

Defined in: js-api/src/views/view.ts:302

Parameters

ParameterTypeDefault value
getViewAsync() => Promise<View>undefined
ribbonbooleantrue

Returns

any

Inherited from

View.fromViewAsync


getAll()

static getAll(): Widget<any>[]

Defined in: js-api/src/widgets/base.ts:231

Returns all currently active widgets.

Returns

Widget<any>[]

Inherited from

View.getAll


init()

static init(self, scope?): void

Defined in: js-api/src/u2core/component.ts:83

Per-instance state, for a constructed component and for an adopted platform object alike.

Parameters

ParameterType
selfComponent
scope?Scope

Returns

void

Inherited from

View.init


is()

static is(x): x is Control

Defined in: js-api/src/u2core/component.ts:439

Structural probe by methods only — never .scope: the accessor mints.

Parameters

ParameterType
xunknown

Returns

x is Control

Inherited from

View.is


registerCleanup()

static registerCleanup(element, cleanup): void

Defined in: js-api/src/widgets/base.ts:242

Registers a cleanup function to run when [element] is killed — i.e. when its host view or pane closes. Also marks the element so the kill-walk can find it.

Parameters

ParameterType
elementElement
cleanupFunction

Returns

void

Inherited from

View.registerCleanup


sameValue()

static sameValue(a, b): boolean

Defined in: js-api/src/u2core/component.ts:105

The equality the property tier and link suppress echoes by: Object.is, arrays element-wise, plain objects key-wise (recursive), everything else by identity.

Parameters

ParameterType
aunknown
bunknown

Returns

boolean

Inherited from

View.sameValue