MultiView
Defined in: js-api/src/views/multi_view.ts:20
Subclass ViewBase to implement a Datagrok view in JavaScript.
Extends
Constructors
Constructor
new MultiView(
options?):MultiView
Defined in: js-api/src/views/multi_view.ts:29
Parameters
| Parameter | Type |
|---|---|
options? | MultiViewOptions |
Returns
MultiView
Overrides
Properties
| Property | Modifier | Type | Default value | Description | Inherited from | Defined in |
|---|---|---|---|---|---|---|
_currentView | public | ViewBase | undefined | - | - | js-api/src/views/multi_view.ts:23 |
_functions | protected | Func[] | [] | - | ViewBase._functions | js-api/src/widgets/base.ts:207 |
_name | protected | string | 'New View' | - | ViewBase._name | js-api/src/views/view.ts:108 |
_options | public | MultiViewOptions | undefined | - | - | js-api/src/views/multi_view.ts:22 |
_properties | protected | Property[] | [] | - | ViewBase._properties | js-api/src/widgets/base.ts:206 |
_root | protected | HTMLElement | undefined | - | ViewBase._root | js-api/src/u2core/component.ts:445 |
_u2 | readonly | ComponentState | undefined | - | ViewBase._u2 | js-api/src/u2core/component.ts:82 |
_views | public | Map<String, ViewBase> | undefined | - | - | js-api/src/views/multi_view.ts:21 |
componentMeta? | public | ComponentMetaBase | undefined | The registry metadata of the tag that built this component, stamped by the spec renderer — the single source the introspection surface below is generated from. | ViewBase.componentMeta | js-api/src/u2core/component.ts:77 |
dart | public | any | undefined | - | ViewBase.dart | js-api/src/views/view.ts:49 |
factory | public | Func | null | null | Constructor function. No parameters, returns [Widget]. | ViewBase.factory | js-api/src/widgets/base.ts:204 |
isDetached | public | boolean | false | Whether detach has been called. | ViewBase.isDetached | js-api/src/widgets/base.ts:214 |
props | public | any | undefined | Property bag over this widget's properties; read and write them by name. | ViewBase.props | js-api/src/widgets/base.ts:209 |
specProps? | public | Record<string, unknown> | undefined | The 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. | ViewBase.specProps | js-api/src/u2core/component.ts:81 |
subs | public | Subscription[] | undefined | Subscriptions cancelled when the widget is detached. | ViewBase.subs | js-api/src/views/view.ts:50 |
tabs | public | TabControl | undefined | - | - | js-api/src/views/multi_view.ts:24 |
temp | public | any | undefined | Contains auxiliary information | ViewBase.temp | js-api/src/widgets/base.ts:201 |
Accessors
aiDescription
Get Signature
get aiDescription():
string|null
Defined in: js-api/src/u2core/component.ts:152
A short AI-facing briefing, seeded from the registry's usage or description.
Returns
string | null
Set Signature
set aiDescription(
x):void
Defined in: js-api/src/u2core/component.ts:156
Parameters
| Parameter | Type |
|---|---|
x | string | null |
Returns
void
Inherited from
ambientAdoption
Get Signature
get
protectedambientAdoption():boolean
Defined in: js-api/src/widgets/base.ts:266
A widget wrapper minted inside somebody's effect scope must not be auto-disposed with it.
Returns
boolean
Inherited from
basePath
Get Signature
get basePath():
string
Defined in: js-api/src/views/view.ts:138
URL prefix of the view (an app's root, such as /apps/Chem); path is this prefix plus the
view's own relative path.
Returns
string
Set Signature
set basePath(
s):void
Defined in: js-api/src/views/view.ts:139
Parameters
| Parameter | Type |
|---|---|
s | string |
Returns
void
Inherited from
box
Get Signature
get box():
boolean
Defined in: js-api/src/views/view.ts:75
Returns
boolean
Set Signature
set box(
b):void
Defined in: js-api/src/views/view.ts:76
Parameters
| Parameter | Type |
|---|---|
b | boolean |
Returns
void
Inherited from
children
Get Signature
get children():
Widget<any>[]
Defined in: js-api/src/widgets/base.ts:301
Parent widget up the DOM tree, or null.
Returns
Widget<any>[]
Inherited from
closing
Get Signature
get closing():
boolean
Defined in: js-api/src/views/view.ts:156
Whether the view is currently closing.
Returns
boolean
Set Signature
set closing(
c):void
Defined in: js-api/src/views/view.ts:157
Parameters
| Parameter | Type |
|---|---|
c | boolean |
Returns
void
Inherited from
currentView
Get Signature
get currentView():
ViewBase
Defined in: js-api/src/views/multi_view.ts:112
Returns
Set Signature
set currentView(
x):void
Defined in: js-api/src/views/multi_view.ts:113
Parameters
| Parameter | Type |
|---|---|
x | ViewBase |
Returns
void
description
Get Signature
get description():
string
Defined in: js-api/src/views/view.ts:130
Returns
string
Set Signature
set description(
s):void
Defined in: js-api/src/views/view.ts:131
Parameters
| Parameter | Type |
|---|---|
s | string |
Returns
void
Inherited from
entity
Get Signature
get entity():
object|null
Defined in: js-api/src/views/view.ts:133
Returns
object | null
Set Signature
set entity(
_e):void
Defined in: js-api/src/views/view.ts:134
Parameters
| Parameter | Type |
|---|---|
_e | object | null |
Returns
void
Inherited from
helpUrl
Get Signature
get helpUrl():
string|null
Defined in: js-api/src/views/view.ts:90
Returns
string | null
View help URL.
Set Signature
set helpUrl(
url):void
Defined in: js-api/src/views/view.ts:94
Parameters
| Parameter | Type |
|---|---|
url | string | null |
Returns
void
Inherited from
innerView
Set Signature
set innerView(
v):void
Defined in: js-api/src/views/view.ts:128
The view this one is currently surfacing, if it hosts another (such as a MultiView
tab). grok.shell.t resolves through it.
Parameters
| Parameter | Type |
|---|---|
v | ViewBase | null |
Returns
void
Inherited from
isPinned
Get Signature
get isPinned():
boolean
Defined in: js-api/src/views/view.ts:186
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:187
Parameters
| Parameter | Type |
|---|---|
value | boolean |
Returns
void
Inherited from
name
Get Signature
get name():
string
Defined in: js-api/src/views/multi_view.ts:81
A named control carries its name in the DOM: data-u2-name is the stable automation id
selectors, tutorials and agents address the control by — the same attribute the spec renderer
stamps on named nodes, so hand-built and spec-built UI share one selector vocabulary.
Derived names (an input's label fallback) never stamp — see Component.deriveName.
Returns
string
Set Signature
set name(
s):void
Defined in: js-api/src/views/multi_view.ts:85
A named control carries its name in the DOM: data-u2-name is the stable automation id
selectors, tutorials and agents address the control by — the same attribute the spec renderer
stamps on named nodes, so hand-built and spec-built UI share one selector vocabulary.
Derived names (an input's label fallback) never stamp — see Component.deriveName.
Parameters
| Parameter | Type |
|---|---|
s | string |
Returns
void
Overrides
parent
Get Signature
get parent():
Widget<any> |null
Defined in: js-api/src/widgets/base.ts:298
Parent widget up the DOM tree, or null.
Returns
Widget<any> | null
Inherited from
parentCall
Get Signature
get parentCall():
FuncCall|undefined
Defined in: js-api/src/views/view.ts:120
Returns
FuncCall | undefined
Set Signature
set parentCall(
s):void
Defined in: js-api/src/views/view.ts:121
Parameters
| Parameter | Type |
|---|---|
s | FuncCall | undefined |
Returns
void
Inherited from
parentView
Get Signature
get parentView():
ViewBase
Defined in: js-api/src/views/view.ts:123
Returns
Set Signature
set parentView(
s):void
Defined in: js-api/src/views/view.ts:124
Parameters
| Parameter | Type |
|---|---|
s | ViewBase |
Returns
void
Inherited from
path
Get Signature
get path():
string
Defined in: js-api/src/views/view.ts:182
View URI, relative to the view root
Returns
string
Set Signature
set path(
s):void
Defined in: js-api/src/views/view.ts:183
Parameters
| Parameter | Type |
|---|---|
s | string |
Returns
void
Inherited from
propertyTarget
Get Signature
get propertyTarget():
unknown
Defined in: js-api/src/u2core/component.ts:250
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
propertyTier
Get Signature
get propertyTier():
boolean
Defined in: js-api/src/widgets/base.ts:270
Every property getProperties declares is a bind step, read and written on propertyTarget.
Returns
boolean
Inherited from
ribbonMenu
Get Signature
get ribbonMenu():
Menu
Defined in: js-api/src/views/view.ts:148
View menu. Sample: https://public.datagrok.ai/js/samples/ui/views/ribbon
Returns
Set Signature
set ribbonMenu(
menu):void
Defined in: js-api/src/views/view.ts:149
Parameters
| Parameter | Type |
|---|---|
menu | Menu |
Returns
void
Inherited from
root
Get Signature
get root():
HTMLElement
Defined in: js-api/src/views/view.ts:72
Returns
HTMLElement
Set Signature
set root(
newRoot):void
Defined in: js-api/src/views/view.ts:73
Parameters
| Parameter | Type |
|---|---|
newRoot | HTMLElement |
Returns
void
Inherited from
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
Inherited from
statusBarPanels
Get Signature
get statusBarPanels():
HTMLDivElement[]
Defined in: js-api/src/views/view.ts:152
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:153
Parameters
| Parameter | Type |
|---|---|
panels | HTMLDivElement[] |
Returns
void
Inherited from
toolbox
Get Signature
get toolbox():
HTMLElement
Defined in: js-api/src/views/view.ts:143
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:144
Parameters
| Parameter | Type |
|---|---|
x | HTMLElement |
Returns
void
Inherited from
type
Get Signature
get type():
string
Defined in: js-api/src/views/view.ts:85
View type
Returns
string
Inherited from
Methods
_getFactory()
_getFactory(
factory):ViewDescription|ViewFactory
Defined in: js-api/src/views/multi_view.ts:66
Parameters
| Parameter | Type |
|---|---|
factory | ViewDescription | ViewFactory |
Returns
ViewDescription | ViewFactory
_notifyPropertyChange()
protected_notifyPropertyChange(p):void
Defined in: js-api/src/widgets/base.ts:348
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
| Parameter | Type |
|---|---|
p | Property | null |
Returns
void
Inherited from
ViewBase._notifyPropertyChange
_ownPropertyChanges()
protected_ownPropertyChanges():ObservableLike<PropertyChange>
Defined in: js-api/src/widgets/base.ts:353
Returns
ObservableLike<PropertyChange>
Inherited from
_scopeMinted()
protected_scopeMinted(_scope):void
Defined in: js-api/src/widgets/base.ts:317
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
| Parameter | Type |
|---|---|
_scope | Scope |
Returns
void
Inherited from
_wireDartLifecycle()
protected_wireDartLifecycle():void
Defined in: js-api/src/widgets/base.ts:333
Dart-owned lifecycle: the platform kill disposes the scope, and disposing the scope kills the widget through the kill-walk.
Returns
void
Inherited from
_wireJsLifecycle()
protected_wireJsLifecycle():void
Defined in: js-api/src/widgets/base.ts:324
JS-owned lifecycle: disposing the scope detaches the widget, and vice versa.
Returns
void
Inherited from
_wireLifecycle()
protected_wireLifecycle():void
Defined in: js-api/src/widgets/base.ts:319
Returns
void
Inherited from
acceptsPath()
acceptsPath(
_urlPath):boolean
Defined in: js-api/src/views/view.ts:207
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
| Parameter | Type |
|---|---|
_urlPath | string |
Returns
boolean
"true" if path is acceptable, "false" otherwise.
Inherited from
addProperty()
addProperty(
propertyName,propertyType,defaultValue?,options?):any
Defined in: js-api/src/widgets/base.ts:376
Registers an property with the specified type, name, and defaultValue.
Parameters
| Parameter | Type | Default value | Description |
|---|---|---|---|
propertyName | string | undefined | - |
propertyType | "string" | "bigint" | "object" | "map" | "file" | "bool" | "int" | "double" | "byte_array" | "datetime" | "qnum" | "dataframe" | "numerical" | "categorical" | "num" | "string_list" | "dataframe_list" | "cell" | "column" | "column_list" | "graphics" | "blob" | "tablerowfiltercall" | "colfiltercall" | "bitset" | "dynamic" | "viewer" | "list" | "semantic_value" | "func" | "funccall" | "property" | "GridCellRenderArgs" | "element" | "view" | "TableView" | "User" | "Menu" | "Project" | "event_data" | "progressindicator" | "Credentials" | "ScriptEnvironment" | "Notebook" | undefined | - |
defaultValue | any | null | - |
options | object & IProperty | null | null | - |
Returns
any
See
Registered property gets added to properties. Returns default value, thus allowing to combine registering a property with the initialization
options.get/options.set override how the property reads/writes (instead of the default
fieldName field access); the change notification (onPropertyChanged) always fires
on write, and a {get}-only options yields a custom read with the default fieldName write.
Inherited from
addStatusProvider()
addStatusProvider(
name,provider):void
Defined in: js-api/src/widgets/base.ts:437
Adds live parts, hit areas and readings to this widget's status. Providers run in registration
order on every read; an existing name is replaced in place, and later providers override earlier
entries. Coordinates use the widget's own hit-area system. Detaching the widget removes all
providers. A subclass that overrides getWidgetStatus composes with super.getWidgetStatus().
Parameters
| Parameter | Type | Description |
|---|---|---|
name | string | Stable name of the component contributing the status. |
provider | StatusProvider | Computes the contribution each time the status is requested. |
Returns
void
Example
widget.addStatusProvider('selection', () => ({values: {'selected rows': table.selection.trueCount}}));
console.log(widget.getWidgetStatus().values?.['selected rows']);
widget.removeStatusProvider('selection');
see samples/grid/custom-renderer-status
Inherited from
addView()
addView(
name,desc,activate):void
Defined in: js-api/src/views/multi_view.ts:61
Parameters
| Parameter | Type |
|---|---|
name | string |
desc | ViewDescription | ViewFactory |
activate | boolean |
Returns
void
afterPersist()
protectedafterPersist():void
Defined in: js-api/src/views/view.ts:101
Gets called automatically when this view gets pinned
Returns
void
Inherited from
append()
append(
item):HTMLElement
Defined in: js-api/src/views/view.ts:211
Appends an item to this view. Use appendAll for appending multiple elements.
Parameters
| Parameter | Type |
|---|---|
item | any |
Returns
HTMLElement
Inherited from
appendAll()
appendAll(
items):HTMLElement
Defined in: js-api/src/views/view.ts:217
Appends multiple elements this view. Use append for appending a single element.
Parameters
| Parameter | Type |
|---|---|
items | HTMLElement[] |
Returns
HTMLElement
Inherited from
apply()
apply(
properties):Widget
Defined in: js-api/src/widgets/base.ts:255
Parameters
| Parameter | Type |
|---|---|
properties | object |
Returns
Inherited from
bindProps()
bindProps():
BindProp[]
Defined in: js-api/src/u2core/component.ts:307
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
bindStep()
bindStep(
name):BindSource|Signal<unknown> |null
Defined in: js-api/src/u2core/component.ts:296
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
| Parameter | Type |
|---|---|
name | string |
Returns
BindSource | Signal<unknown> | null
Inherited from
close()
close():
void
Defined in: js-api/src/views/view.ts:227
Closes this view.
Returns
void
Inherited from
deriveName()
protectedderiveName(x):void
Defined in: js-api/src/u2core/component.ts:72
Sets the introspection/form key without claiming an automation id — the label-fallback path:
a caption is not a stable identity, so it never reaches data-u2-name.
Parameters
| Parameter | Type |
|---|---|
x | string | undefined |
Returns
void
Inherited from
detach()
detach():
void
Defined in: js-api/src/views/view.ts:222
Detaches this view.
Returns
void
Inherited from
dispose()
dispose():
void
Defined in: js-api/src/u2core/component.ts:147
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
effect()
effect(
fn):this
Defined in: js-api/src/u2core/component.ts:134
Parameters
| Parameter | Type |
|---|---|
fn | () => void |
Returns
this
Inherited from
fireEvent()
protectedfireEvent(eventId,args?):void
Defined in: js-api/src/u2core/component.ts:435
Parameters
| Parameter | Type |
|---|---|
eventId | string |
args? | unknown |
Returns
void
Inherited from
getDartProperties()
getDartProperties():
any[]
Defined in: js-api/src/widgets/base.ts:284
Dart handles of the properties that have one.
Returns
any[]
Inherited from
getFunctions()
getFunctions():
Func[]
Defined in: js-api/src/widgets/base.ts:277
Functions that are applicable to this particular widget. Used in the UI to display context actions, and for the AI integrations.
Returns
Func[]
Inherited from
getIcon()
getIcon():
HTMLElement|null
Defined in: js-api/src/views/view.ts:171
Returns
HTMLElement | null
View icon. Override in subclasses.
Inherited from
getProperties()
getProperties():
Property[]
Defined in: js-api/src/widgets/base.ts:273
Returns all properties of this widget: the meta-generated ones plus addProperty's.
Returns
Property[]
Inherited from
getRibbonPanels()
getRibbonPanels():
HTMLElement[][]
Defined in: js-api/src/views/view.ts:166
Returns
HTMLElement[][]
Inherited from
getView()
getView(
name):ViewBase
Defined in: js-api/src/views/multi_view.ts:73
Parameters
| Parameter | Type |
|---|---|
name | string |
Returns
getWidgetStatus()
getWidgetStatus():
IWidgetStatus
Defined in: js-api/src/widgets/base.ts:413
Returns the widget's runtime structure for automated testing and introspection.
Returns
Inherited from
handlePath()
handlePath(
_urlPath):void
Defined in: js-api/src/views/view.ts:201
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
| Parameter | Type |
|---|---|
_urlPath | string |
Returns
void
Inherited from
link()
link(
name,source,twoWay):void
Defined in: js-api/src/u2core/component.ts:268
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
| Parameter | Type |
|---|---|
name | string |
source | Signal<unknown> |
twoWay | boolean |
Returns
void
Inherited from
loadStateMap()
loadStateMap(
_stateMap):void
Defined in: js-api/src/views/view.ts:179
Loads view state map. Override in subclasses.
Parameters
| Parameter | Type |
|---|---|
_stateMap | object |
Returns
void
Inherited from
onEvent()
onEvent(
eventId?):Observable<any>
Defined in: js-api/src/widgets/base.ts:410
Observes events with the specified eventId. Override in subclasses to provide actual events.