Skip to main content

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

ParameterType
options?MultiViewOptions

Returns

MultiView

Overrides

ViewBase.constructor

Properties

PropertyModifierTypeDefault valueDescriptionInherited fromDefined in
_currentViewpublicViewBaseundefined--js-api/src/views/multi_view.ts:23
_functionsprotectedFunc[][]-ViewBase._functionsjs-api/src/widgets/base.ts:207
_nameprotectedstring'New View'-ViewBase._namejs-api/src/views/view.ts:108
_optionspublicMultiViewOptionsundefined--js-api/src/views/multi_view.ts:22
_propertiesprotectedProperty[][]-ViewBase._propertiesjs-api/src/widgets/base.ts:206
_rootprotectedHTMLElementundefined-ViewBase._rootjs-api/src/u2core/component.ts:445
_u2readonlyComponentStateundefined-ViewBase._u2js-api/src/u2core/component.ts:82
_viewspublicMap<String, ViewBase>undefined--js-api/src/views/multi_view.ts:21
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.ViewBase.componentMetajs-api/src/u2core/component.ts:77
dartpublicanyundefined-ViewBase.dartjs-api/src/views/view.ts:49
factorypublicFunc | nullnullConstructor function. No parameters, returns [Widget].ViewBase.factoryjs-api/src/widgets/base.ts:204
isDetachedpublicbooleanfalseWhether detach has been called.ViewBase.isDetachedjs-api/src/widgets/base.ts:214
propspublicanyundefinedProperty bag over this widget's properties; read and write them by name.ViewBase.propsjs-api/src/widgets/base.ts:209
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.ViewBase.specPropsjs-api/src/u2core/component.ts:81
subspublicSubscription[]undefinedSubscriptions cancelled when the widget is detached.ViewBase.subsjs-api/src/views/view.ts:50
tabspublicTabControlundefined--js-api/src/views/multi_view.ts:24
temppublicanyundefinedContains auxiliary informationViewBase.tempjs-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
ParameterType
xstring | null
Returns

void

Inherited from

ViewBase.aiDescription


ambientAdoption

Get Signature

get protected ambientAdoption(): 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

ViewBase.ambientAdoption


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
ParameterType
sstring
Returns

void

Inherited from

ViewBase.basePath


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
ParameterType
bboolean
Returns

void

Inherited from

ViewBase.box


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

ViewBase.children


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
ParameterType
cboolean
Returns

void

Inherited from

ViewBase.closing


currentView

Get Signature

get currentView(): ViewBase

Defined in: js-api/src/views/multi_view.ts:112

Returns

ViewBase

Set Signature

set currentView(x): void

Defined in: js-api/src/views/multi_view.ts:113

Parameters
ParameterType
xViewBase
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
ParameterType
sstring
Returns

void

Inherited from

ViewBase.description


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
ParameterType
_eobject | null
Returns

void

Inherited from

ViewBase.entity


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
ParameterType
urlstring | null
Returns

void

Inherited from

ViewBase.helpUrl


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
ParameterType
vViewBase | null
Returns

void

Inherited from

ViewBase.innerView


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
ParameterType
valueboolean
Returns

void

Inherited from

ViewBase.isPinned


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
ParameterType
sstring
Returns

void

Overrides

ViewBase.name


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

ViewBase.parent


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
ParameterType
sFuncCall | undefined
Returns

void

Inherited from

ViewBase.parentCall


parentView

Get Signature

get parentView(): ViewBase

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

Returns

ViewBase

Set Signature

set parentView(s): void

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

Parameters
ParameterType
sViewBase
Returns

void

Inherited from

ViewBase.parentView


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
ParameterType
sstring
Returns

void

Inherited from

ViewBase.path


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

ViewBase.propertyTarget


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

ViewBase.propertyTier


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

Menu

Set Signature

set ribbonMenu(menu): void

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

Parameters
ParameterType
menuMenu
Returns

void

Inherited from

ViewBase.ribbonMenu


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
ParameterType
newRootHTMLElement
Returns

void

Inherited from

ViewBase.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

ViewBase.scope


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
ParameterType
panelsHTMLDivElement[]
Returns

void

Inherited from

ViewBase.statusBarPanels


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
ParameterType
xHTMLElement
Returns

void

Inherited from

ViewBase.toolbox


type

Get Signature

get type(): string

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

View type

Returns

string

Inherited from

ViewBase.type

Methods

_getFactory()

_getFactory(factory): ViewDescription | ViewFactory

Defined in: js-api/src/views/multi_view.ts:66

Parameters

ParameterType
factoryViewDescription | 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

ParameterType
pProperty | 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

ViewBase._ownPropertyChanges


_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

ParameterType
_scopeScope

Returns

void

Inherited from

ViewBase._scopeMinted


_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

ViewBase._wireDartLifecycle


_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

ViewBase._wireJsLifecycle


_wireLifecycle()

protected _wireLifecycle(): void

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

Returns

void

Inherited from

ViewBase._wireLifecycle


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

ParameterType
_urlPathstring

Returns

boolean

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

Inherited from

ViewBase.acceptsPath


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

ParameterTypeDefault valueDescription
propertyNamestringundefined-
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-
defaultValueanynull-
optionsobject & IProperty | nullnull-

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

ViewBase.addProperty


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

ParameterTypeDescription
namestringStable name of the component contributing the status.
providerStatusProviderComputes 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

ViewBase.addStatusProvider


addView()

addView(name, desc, activate): void

Defined in: js-api/src/views/multi_view.ts:61

Parameters

ParameterType
namestring
descViewDescription | ViewFactory
activateboolean

Returns

void


afterPersist()

protected afterPersist(): void

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

Gets called automatically when this view gets pinned

Returns

void

Inherited from

ViewBase.afterPersist


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

ParameterType
itemany

Returns

HTMLElement

Inherited from

ViewBase.append


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

ParameterType
itemsHTMLElement[]

Returns

HTMLElement

Inherited from

ViewBase.appendAll


apply()

apply(properties): Widget

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

Parameters

ParameterType
propertiesobject

Returns

Widget

Inherited from

ViewBase.apply


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

ViewBase.bindProps


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

ParameterType
namestring

Returns

BindSource | Signal<unknown> | null

Inherited from

ViewBase.bindStep


close()

close(): void

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

Closes this view.

Returns

void

Inherited from

ViewBase.close


deriveName()

protected deriveName(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

ParameterType
xstring | undefined

Returns

void

Inherited from

ViewBase.deriveName


detach()

detach(): void

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

Detaches this view.

Returns

void

Inherited from

ViewBase.detach


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

ViewBase.dispose


effect()

effect(fn): this

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

Parameters

ParameterType
fn() => void

Returns

this

Inherited from

ViewBase.effect


fireEvent()

protected fireEvent(eventId, args?): void

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

Parameters

ParameterType
eventIdstring
args?unknown

Returns

void

Inherited from

ViewBase.fireEvent


getDartProperties()

getDartProperties(): any[]

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

Dart handles of the properties that have one.

Returns

any[]

Inherited from

ViewBase.getDartProperties


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

ViewBase.getFunctions


getIcon()

getIcon(): HTMLElement | null

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

Returns

HTMLElement | null

View icon. Override in subclasses.

Inherited from

ViewBase.getIcon


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

ViewBase.getProperties


getRibbonPanels()

getRibbonPanels(): HTMLElement[][]

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

Returns

HTMLElement[][]

Inherited from

ViewBase.getRibbonPanels


getView()

getView(name): ViewBase

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

Parameters

ParameterType
namestring

Returns

ViewBase


getWidgetStatus()

getWidgetStatus(): IWidgetStatus

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

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

Returns

IWidgetStatus

Inherited from

ViewBase.getWidgetStatus


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

ParameterType
_urlPathstring

Returns

void

Inherited from

ViewBase.handlePath


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

ParameterType
namestring
sourceSignal<unknown>
twoWayboolean

Returns

void

Inherited from

ViewBase.link


loadStateMap()

loadStateMap(_stateMap): void

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

Loads view state map. Override in subclasses.

Parameters

ParameterType
_stateMapobject

Returns

void

Inherited from

ViewBase.loadStateMap


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.

Parameters

ParameterTypeDefault value
eventIdstring | nullnull

Returns

Observable<any>

Inherited from

ViewBase.onEvent


onFrameAttached()

onFrameAttached(dataFrame): void

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

Called when a DataFrame is attached; override to bind data.

Parameters

ParameterType
dataFrameDataFrame

Returns

void

Inherited from

ViewBase.onFrameAttached


onPropertyChanged()

onPropertyChanged(property): void

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

Gets called when viewer's property is changed.

Parameters

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

Returns

void

Inherited from

ViewBase.onPropertyChanged


own()

own(dispose): this

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

Parameters

ParameterType
dispose() => void

Returns

this

Inherited from

ViewBase.own


pin()

pin(): void

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

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

Returns

void

Inherited from

ViewBase.pin


propertyChanges()

protected propertyChanges(): ObservableLike<PropertyChange>

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

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

Returns

ObservableLike<PropertyChange>

Inherited from

ViewBase.propertyChanges


registerFunction()

protected registerFunction(f): void

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

Parameters

ParameterType
fFuncLike

Returns

void

Inherited from

ViewBase.registerFunction


removeStatusProvider()

removeStatusProvider(name): void

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

Removes the status contribution registered under name; an absent name is a no-op.

Parameters

ParameterTypeDescription
namestringThe name passed to addStatusProvider.

Returns

void

Example

widget.removeStatusProvider('selection');
see samples/grid/custom-renderer-status

Inherited from

ViewBase.removeStatusProvider


runInScope()

runInScope<T>(fn): T

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

Type Parameters

Type Parameter
T

Parameters

ParameterType
fn() => T

Returns

T

Inherited from

ViewBase.runInScope


saveStateMap()

saveStateMap(): object | null

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

Returns

object | null

Viewer state map. Override in subclasses.

Inherited from

ViewBase.saveStateMap


setIcon()

setIcon(icon): void

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

Parameters

ParameterType
iconHTMLElement

Returns

void

Inherited from

ViewBase.setIcon


setRibbonPanels()

setRibbonPanels(panels, clear?): void

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

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

ViewBase.setRibbonPanels


sourceRowsChanged()

sourceRowsChanged(): void

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

Called when the rows the widget shows change; override to refresh.

Returns

void

Inherited from

ViewBase.sourceRowsChanged


sub()

sub(subscription): void

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

Registers a subscription to an external event.

Parameters

ParameterType
subscriptionSubscription

Returns

void

Inherited from

ViewBase.sub


toDart()

toDart(): any

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

The Dart handle of this widget, created on first use.

Returns

any

Inherited from

ViewBase.toDart


build()

static build(builder): Control

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

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

ViewBase.build


find()

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

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

Finds existing widget from its visual root.

Parameters

ParameterType
rootElement

Returns

Widget<any> | null

Inherited from

ViewBase.find


forElement()

static forElement(el): Control | undefined

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

The nearest control owning el — the DOM → component door for tooling, automation and inspectors (the u2 counterpart of the platform's Widget.find). Best-effort: the last control constructed on (or assigned) a root wins it.

Parameters

ParameterType
elElement | null

Returns

Control | undefined

Inherited from

ViewBase.forElement


fromRoot()

static fromRoot(root): Widget

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

Creates a new widget from the root element.

Parameters

ParameterType
rootHTMLElement

Returns

Widget

Inherited from

ViewBase.fromRoot


getAll()

static getAll(): Widget<any>[]

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

Returns all currently active widgets.

Returns

Widget<any>[]

Inherited from

ViewBase.getAll


init()

static init(self, scope?): void

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

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

Parameters

ParameterType
selfComponent
scope?Scope

Returns

void

Inherited from

ViewBase.init


is()

static is(x): x is Control

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

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

Parameters

ParameterType
xunknown

Returns

x is Control

Inherited from

ViewBase.is


registerCleanup()

static registerCleanup(element, cleanup): void

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

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
cleanupCallback

Returns

void

Inherited from

ViewBase.registerCleanup


sameValue()

static sameValue(a, b): boolean

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

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

ViewBase.sameValue