MatrixPlot

Defined in: js-api/src/viewer.ts:1057

Base class for controls that have a visual root and a set of properties.

Extends

• Viewer<IMatrixPlotSettings>

Constructors

Constructor

new MatrixPlot(dart): MatrixPlot

Defined in: js-api/src/viewer.ts:1058

Parameters

Parameter	Type
dart	any

Returns

MatrixPlot

Overrides

Viewer.constructor

Properties

Property	Modifier	Type	Default value	Description	Inherited from	Defined in
_functions	protected	Func[]	[]	-	Viewer._functions	js-api/src/widgets/base.ts:204
_properties	protected	Property[]	[]	-	Viewer._properties	js-api/src/widgets/base.ts:203
_root	protected	HTMLElement	undefined	-	Viewer._root	js-api/src/u2core/component.ts:445
_u2	readonly	ComponentState	undefined	-	Viewer._u2	js-api/src/u2core/component.ts:82
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.	Viewer.componentMeta	js-api/src/u2core/component.ts:77
dart	public	any	undefined	-	Viewer.dart	js-api/src/widgets/base.ts:209
factory	public	Func | null	null	Constructor function. No parameters, returns [Widget].	Viewer.factory	js-api/src/widgets/base.ts:201
isDetached	public	boolean	false	Whether detach has been called.	Viewer.isDetached	js-api/src/widgets/base.ts:211
props	public	IMatrixPlotSettings & ObjectPropertyBag	undefined	Property bag over this widget's properties; read and write them by name.	Viewer.props	js-api/src/widgets/base.ts:206
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.	Viewer.specProps	js-api/src/u2core/component.ts:81
subs	public	Subscription[]	undefined	Subscriptions cancelled when the widget is detached.	Viewer.subs	js-api/src/widgets/base.ts:208
tags	public	any	undefined	Viewer tags: a string map persisted with the layout.	Viewer.tags	js-api/src/viewer.ts:123
temp	public	any	undefined	Contains auxiliary information	Viewer.temp	js-api/src/widgets/base.ts:198
CORE_VIEWER_TYPES	static	string[]	undefined	Viewer types that ship with the platform and are available synchronously.	Viewer.CORE_VIEWER_TYPES	js-api/src/viewer.ts:530

Accessors

aiDescription

Get Signature

get aiDescription(): string | null

Defined in: js-api/src/viewer.ts:150

AI briefing of the underlying Dart viewer.

Returns

string | null

Set Signature

set aiDescription(x): void

Defined in: js-api/src/viewer.ts:155

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

Parameters

Parameter	Type
x	string | null

Returns

void

Inherited from

Viewer.aiDescription

---

ambientAdoption

Get Signature

get protected ambientAdoption(): boolean

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

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

Returns

boolean

Inherited from

Viewer.ambientAdoption

---

children

Get Signature

get children(): Widget<any>[]

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

Parent widget up the DOM tree, or null.

Returns

Widget<any>[]

Inherited from

Viewer.children

---

dataFrame

Get Signature

get dataFrame(): DataFrame

Defined in: js-api/src/viewer.ts:326

Returns

DataFrame

Set Signature

set dataFrame(t): void

Defined in: js-api/src/viewer.ts:327

Parameters

Parameter	Type
t	DataFrame

Returns

void

Inherited from

Viewer.dataFrame

---

descriptor

Get Signature

get descriptor(): WidgetDescriptor

Defined in: js-api/src/viewer.ts:141

Descriptor of this widget.

Returns

WidgetDescriptor

Inherited from

Viewer.descriptor

---

filter

Get Signature

get filter(): BitSet

Defined in: js-api/src/viewer.ts:134

combined filter of the viewer

Returns

BitSet

Set Signature

set filter(f): void

Defined in: js-api/src/viewer.ts:137

Parameters

Parameter	Type
f	BitSet

Returns

void

Inherited from

Viewer.filter

---

helpUrl

Get Signature

get helpUrl(): string

Defined in: js-api/src/viewer.ts:330

Help URL

Returns

string

Set Signature

set helpUrl(s): void

Defined in: js-api/src/viewer.ts:331

Parameters

Parameter	Type
s	string

Returns

void

Inherited from

Viewer.helpUrl

---

immediateRendering

Get Signature

get immediateRendering(): boolean

Defined in: js-api/src/viewer.ts:336

Repaints as soon as the current task completes instead of on the next animation frame or after the render delay; property sets within one task still coalesce into one repaint. For automated tests: a property set is painted once the test yields one macrotask.

Returns

boolean

Set Signature

set immediateRendering(x): void

Defined in: js-api/src/viewer.ts:337

Parameters

Parameter	Type
x	boolean

Returns

void

Inherited from

Viewer.immediateRendering

---

isRenderPending

Get Signature

get isRenderPending(): boolean

Defined in: js-api/src/viewer.ts:341

True while a change is on its way to the canvas: a debounced refresh is armed, or a repaint is requested and not yet done. A test waits on this instead of a timeout.

Returns

boolean

Inherited from

Viewer.isRenderPending

---

meta

Get Signature

get meta(): ViewerMetaHelper

Defined in: js-api/src/viewer.ts:299

Formula lines and annotation regions of this viewer.

Returns

ViewerMetaHelper

Inherited from

Viewer.meta

---

name

Get Signature

get name(): string | undefined

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

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 | undefined

Set Signature

set name(x): void

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

Unique within a spec: the anchor for selection, patches and automation. An accessor pair (not a field), so a platform descendant's own name accessors override it legally (TS2611).

Parameters

Parameter	Type
x	string | undefined

Returns

void

Inherited from

Viewer.name

---

onAfterDrawOverlay

Get Signature

get onAfterDrawOverlay(): Observable<EventData<any>>

Defined in: js-api/src/viewer.ts:187

Fires after rendering of the overlay canvas (interactive layer).

Returns

Observable<EventData<any>>

Inherited from

Viewer.onAfterDrawOverlay

---

onAfterDrawScene

Get Signature

get onAfterDrawScene(): Observable<EventData<any>>

Defined in: js-api/src/viewer.ts:183

Fires after rendering of the main canvas.

Returns

Observable<EventData<any>>

Inherited from

Viewer.onAfterDrawScene

---

onAfterLayout

Get Signature

get onAfterLayout(): Observable<EventData<any>>

Defined in: js-api/src/viewer.ts:179

Fires after the viewer completes a layout pass.

Returns

Observable<EventData<any>>

Inherited from

Viewer.onAfterLayout

---

onBeforeDrawOverlay

Get Signature

get onBeforeDrawOverlay(): Observable<EventData<any>>

Defined in: js-api/src/viewer.ts:185

Fires before rendering of the overlay canvas (interactive layer).

Returns

Observable<EventData<any>>

Inherited from

Viewer.onBeforeDrawOverlay

---

onBeforeDrawScene

Get Signature

get onBeforeDrawScene(): Observable<EventData<any>>

Defined in: js-api/src/viewer.ts:181

Fires before rendering of the main canvas.

Returns

Observable<EventData<any>>

Inherited from

Viewer.onBeforeDrawScene

---

onContextMenu

Get Signature

get onContextMenu(): Observable<Menu>

Defined in: js-api/src/viewer.ts:469

Fires when the viewer builds its context menu; add items to the emitted Menu.

Returns

Observable<Menu>

Inherited from

Viewer.onContextMenu

---

onDartPropertyChanged

Get Signature

get onDartPropertyChanged(): Observable<null>

Defined in: js-api/src/viewer.ts:497

Low-level stream of property changes on the Dart side; prefer onPropertyValueChanged.

Returns

Observable<null>

Inherited from

Viewer.onDartPropertyChanged

---

onDataEvent

Get Signature

get onDataEvent(): Observable<ViewerEvent>

Defined in: js-api/src/viewer.ts:164

All data events of this viewer (selection, row click, tooltip); filter by e.type.

Returns

Observable<ViewerEvent>

Inherited from

Viewer.onDataEvent

---

onDataFrameChanged

Get Signature

get onDataFrameChanged(): Observable<any>

Defined in: js-api/src/viewer.ts:175

Fires when the viewer's underlying DataFrame is replaced (table attached).

Returns

Observable<any>

Inherited from

Viewer.onDataFrameChanged

---

onDataRowClicked

Get Signature

get onDataRowClicked(): Observable<ViewerEvent>

Defined in: js-api/src/viewer.ts:170

current row clicked

Returns

Observable<ViewerEvent>

Inherited from

Viewer.onDataRowClicked

---

onDataSelected

Get Signature

get onDataSelected(): Observable<ViewerEvent>

Defined in: js-api/src/viewer.ts:168

Fires when the user selects data in the viewer.

Returns

Observable<ViewerEvent>

Inherited from

Viewer.onDataSelected

---

onDetached

Get Signature

get onDetached(): Observable<any>

Defined in: js-api/src/viewer.ts:512

Occurs when viewer is detached.

Returns

Observable<any>

Inherited from

Viewer.onDetached

---

onPropertyValueChanged

Get Signature

get onPropertyValueChanged(): Observable<EventData<Property>>

Defined in: js-api/src/viewer.ts:172

Fires after any viewer property changes; args.property is the property.

Returns

Observable<EventData<Property>>

Inherited from

Viewer.onPropertyValueChanged

---

onResized

Get Signature

get onResized(): Observable<null>

Defined in: js-api/src/viewer.ts:177

Fires when the viewer is resized.

Returns

Observable<null>

Inherited from

Viewer.onResized

---

onTooltipCreated

Get Signature

get onTooltipCreated(): Observable<ViewerEvent>

Defined in: js-api/src/viewer.ts:166

Fires when the viewer shows a data tooltip.

Returns

Observable<ViewerEvent>

Inherited from

Viewer.onTooltipCreated

---

onViewerRendered

Get Signature

get onViewerRendered(): Observable<EventData<any>>

Defined in: js-api/src/viewer.ts:189

Fires after the viewer is rendered.

Returns

Observable<EventData<any>>

Inherited from

Viewer.onViewerRendered

---

parent

Get Signature

get parent(): Widget<any> | null

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

Parent widget up the DOM tree, or null.

Returns

Widget<any> | null

Inherited from

Viewer.parent

---

propertyTarget

Get Signature

get propertyTarget(): unknown

Defined in: js-api/src/viewer.ts:248

A viewer's property lives on its look, which the props bag is over. Read per call: a viewer's look is settable.

Returns

unknown

Inherited from

Viewer.propertyTarget

---

propertyTier

Get Signature

get propertyTier(): boolean

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

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

Returns

boolean

Inherited from

Viewer.propertyTier

---

root

Get Signature

get root(): HTMLElement

Defined in: js-api/src/viewer.ts:294

Visual root.

Returns

HTMLElement

Inherited from

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

Viewer.scope

---

table

Get Signature

get table(): DataFrame

Defined in: js-api/src/viewer.ts:311

The DataFrame this viewer is attached to. Same as dataFrame.

Returns

DataFrame

Inherited from

Viewer.table

---

tableView

Get Signature

get tableView(): TableView | null

Defined in: js-api/src/viewer.ts:321

Returns a view this viewer is associated with, or null

Returns

TableView | null

Inherited from

Viewer.tableView

---

type

Get Signature

get type(): ViewerType

Defined in: js-api/src/viewer.ts:306

Returns viewer type (see VIEWER constants)

Returns

ViewerType

Inherited from

Viewer.type

---

view

Get Signature

get view(): View | null

Defined in: js-api/src/viewer.ts:316

Returns a view this viewer is associated with, or null

Returns

View | null

Inherited from

Viewer.view

Methods

_notifyPropertyChange()

protected _notifyPropertyChange(p): void

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

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

Viewer._notifyPropertyChange

---

_ownPropertyChanges()

protected _ownPropertyChanges(): ObservableLike<PropertyChange>

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

Returns

ObservableLike<PropertyChange>

Inherited from

Viewer._ownPropertyChanges

---

_scopeMinted()

protected _scopeMinted(_scope): void

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

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

Viewer._scopeMinted

---

_wireDartLifecycle()

protected _wireDartLifecycle(): void

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

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

Returns

void

Inherited from

Viewer._wireDartLifecycle

---

_wireJsLifecycle()

protected _wireJsLifecycle(): void

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

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

Returns

void

Inherited from

Viewer._wireJsLifecycle

---

_wireLifecycle()

protected _wireLifecycle(): void

Defined in: js-api/src/viewer.ts:260

Returns

void

Inherited from

Viewer._wireLifecycle

---

addProperty()

addProperty(propertyName, propertyType, defaultValue?, options?): any

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

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" | "view" | "blob" | "bool" | "int" | "double" | "byte_array" | "datetime" | "qnum" | "dataframe" | "numerical" | "categorical" | "num" | "string_list" | "dataframe_list" | "cell" | "column" | "column_list" | "graphics" | "tablerowfiltercall" | "colfiltercall" | "bitset" | "dynamic" | "viewer" | "list" | "semantic_value" | "func" | "funccall" | "property" | "GridCellRenderArgs" | "element" | "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

Viewer.addProperty

---

apply()

apply(properties): Widget

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

Parameters

Parameter	Type
properties	object

Returns

Widget

Inherited from

Viewer.apply

---

bindProps()

bindProps(): BindProp[]

Defined in: js-api/src/viewer.ts:280

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

Viewer.bindProps

---

bindStep()

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

Defined in: js-api/src/viewer.ts:267

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

Viewer.bindStep

---

close()

close(): void

Defined in: js-api/src/viewer.ts:289

Closes and detaches the viewer.

Returns

void

Inherited from

Viewer.close

---

copyViewersLook()

copyViewersLook(other): void

Defined in: js-api/src/viewer.ts:515

Copies all settings (the look) from [other] into this viewer.

Parameters

Parameter	Type
other	Viewer

Returns

void

Inherited from

Viewer.copyViewersLook

---

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

Parameter	Type
x	string | undefined

Returns

void

Inherited from

Viewer.deriveName

---

detach()

detach(): void

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

Gets called when a widget is detached and will no longer be used. Typically used for unsubscribing from events. Be sure to call super.detach() if this method is overridden.

Returns

void

Inherited from

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

Viewer.dispose

---

effect()

effect(fn): this

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

Parameters

Parameter	Type
fn	() => void

Returns

this

Inherited from

Viewer.effect

---

fireEvent()

protected fireEvent(eventId, args?): void

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

Parameters

Parameter	Type
eventId	string
args?	unknown

Returns

void

Inherited from

Viewer.fireEvent

---

getDartProperties()

getDartProperties(): any[]

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

Dart handles of the properties that have one.

Returns

any[]

Inherited from

Viewer.getDartProperties

---

getFunctions()

getFunctions(): Func[]

Defined in: js-api/src/viewer.ts:147

Functions applicable to the underlying Dart viewer.

Returns

Func[]

Inherited from

Viewer.getFunctions

---

getInfo()

getInfo(): object

Defined in: js-api/src/viewer.ts:237

Viewer internals exposed for diagnostics and tests (canvas, overlay, and more), keyed by name.

Returns

object

Inherited from

Viewer.getInfo

---

getOptions()

getOptions(includeDefaults?): object

Defined in: js-api/src/viewer.ts:232

Gets the serialized viewer options. [includeDefaults] flag specifies whether the properties with the default values should be returned. Not including default properties makes it more clean and efficient for serialization purposes.

See also setOptions Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/scatter-plot

Parameters

Parameter	Type	Default value
includeDefaults	boolean	false

Returns

object

Name	Type	Defined in
id	string	js-api/src/viewer.ts:232
look	ViewerOptions<IMatrixPlotSettings>	js-api/src/viewer.ts:232
type	ViewerType	js-api/src/viewer.ts:232

Inherited from

Viewer.getOptions

---

getProperties()

getProperties(): Property[]

Defined in: js-api/src/viewer.ts:242

All properties of this viewer, including the data-bound ones.

Returns

Property[]

Inherited from

Viewer.getProperties

---

getWidgetStatus()

getWidgetStatus(): IWidgetStatus

Defined in: js-api/src/viewer.ts:144

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

Returns

IWidgetStatus

Inherited from

Viewer.getWidgetStatus

---

initDartObject()

initDartObject(dart): void

Defined in: js-api/src/viewer.ts:191

Parameters

Parameter	Type
dart	any

Returns

void

Inherited from

Viewer.initDartObject

---

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

Viewer.link

---

onEvent()

onEvent(eventId?): Observable<any>

Defined in: js-api/src/viewer.ts:474

Observes platform events with the specified eventId.

Parameters

Parameter	Type	Default value
eventId	string | null	null

Returns

Observable<any>

Inherited from

Viewer.onEvent

---

onFrameAttached()

onFrameAttached(dataFrame): void

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

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

Parameters

Parameter	Type
dataFrame	DataFrame

Returns

void

Inherited from

Viewer.onFrameAttached

---

onPropertyChanged()

onPropertyChanged(property): void

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

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

Viewer.onPropertyChanged

---

own()

own(dispose): this

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

Parameters

Parameter	Type
dispose	() => void

Returns

this

Inherited from

Viewer.own

---

propertyChanges()

protected propertyChanges(): ObservableLike<PropertyChange>

Defined in: js-api/src/viewer.ts:250

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

Returns

ObservableLike<PropertyChange>

Inherited from

Viewer.propertyChanges

---

registerFunction()

protected registerFunction(f): void

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

Parameters

Parameter	Type
f	FuncLike

Returns

void

Inherited from

Viewer.registerFunction

---

removeFromView()

removeFromView(): any

Defined in: js-api/src/viewer.ts:520

Removes the viewer from its view without disposing it.

Returns

any

Inherited from

Viewer.removeFromView

---

runInScope()

runInScope<T>(fn): T

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

Type Parameters

Type Parameter
T

Parameters

Parameter	Type
fn	() => T

Returns

T

Inherited from

Viewer.runInScope

---

setOptions()

setOptions(map): void

Defined in: js-api/src/viewer.ts:221

Sets viewer options. See also getOptions Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/scatter-plot

Parameters

Parameter	Type
map	object & object & object

Returns

void

Inherited from

Viewer.setOptions

---

sourceRowsChanged()

sourceRowsChanged(): void

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

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

Returns

void

Inherited from

Viewer.sourceRowsChanged

---

sub()

sub(subscription): void

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

Registers a subscription to an external event.

Parameters

Parameter	Type
subscription	Subscription

Returns

void

Inherited from

Viewer.sub

---

toCompactLook()

toCompactLook(): void

Defined in: js-api/src/viewer.ts:492

Switches the viewer to the compact look used inside a trellis plot.

Returns

void

Inherited from

Viewer.toCompactLook

---

toDart()

toDart(): any

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

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

Returns

any

Inherited from

Viewer.toDart

---

barChart()

static barChart(t, options?): BarChartViewer

Defined in: js-api/src/viewer.ts:354

Creates a bar chart.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IBarChartSettings>

Returns

BarChartViewer

Inherited from

Viewer.barChart

---

boxPlot()

static boxPlot(t, options?): BoxPlot

Defined in: js-api/src/viewer.ts:374

Creates a box plot.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IBoxPlotSettings>

Returns

BoxPlot

Inherited from

Viewer.boxPlot

---

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

Parameter	Type
builder	() => HTMLElement | (string | HTMLElement | Control)[]

Returns

Control

Inherited from

Viewer.build

---

calendar()

static calendar(t, options?): CalendarViewer

Defined in: js-api/src/viewer.ts:399

Creates a calendar.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<ICalendarSettings>

Returns

CalendarViewer

Inherited from

Viewer.calendar

---

canVisualize()

static canVisualize(viewerType, dataFrame): string | null

Defined in: js-api/src/viewer.ts:525

Returns null when a viewer of [viewerType] can show [dataFrame], or the reason it cannot.

Parameters

Parameter	Type
viewerType	string
dataFrame	DataFrame

Returns

string | null

Inherited from

Viewer.canVisualize

---

confusionMatrix()

static confusionMatrix(t, options?): ConfusionMatrix

Defined in: js-api/src/viewer.ts:359

Creates a confusion matrix.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IConfusionMatrixSettings>

Returns

ConfusionMatrix

Inherited from

Viewer.confusionMatrix

---

correlationPlot()

static correlationPlot(t, options?): CorrelationPlot

Defined in: js-api/src/viewer.ts:404

Creates a correlation plot.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<ICorrelationPlotSettings>

Returns

CorrelationPlot

Inherited from

Viewer.correlationPlot

---

densityPlot()

static densityPlot(t, options?): DensityPlotViewer

Defined in: js-api/src/viewer.ts:409

Creates a density plot.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IDensityPlotSettings>

Returns

DensityPlotViewer

Inherited from

Viewer.densityPlot

---

filters()

static filters(t, options?): Viewer<IFiltersSettings>

Defined in: js-api/src/viewer.ts:379

Creates a filter panel.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IFiltersSettings>

Returns

Viewer<IFiltersSettings>

Inherited from

Viewer.filters

---

find()

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

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

Finds existing widget from its visual root.

Parameters

Parameter	Type
root	Element

Returns

Widget<any> | null

Inherited from

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

Parameter	Type
el	Element | null

Returns

Control | undefined

Inherited from

Viewer.forElement

---

form()

static form(t, options?): FormViewer

Defined in: js-api/src/viewer.ts:414

Creates a form viewer.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IFormSettings>

Returns

FormViewer

Inherited from

Viewer.form

---

fromRoot()

static fromRoot(root): Widget

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

Creates a new widget from the root element.

Parameters

Parameter	Type
root	HTMLElement

Returns

Widget

Inherited from

Viewer.fromRoot

---

fromType()

static fromType<T>(viewerType, table, options?): ViewerClass<T>

Defined in: js-api/src/viewer.ts:205

Creates a new viewer of the specified type. A known VIEWER type (enum member or its literal) returns that viewer's class; a type only known at runtime returns Viewer. Sample: https://public.datagrok.ai/js/samples/ui/viewers/create-viewers-dynamically

Type Parameters

Type Parameter
T extends ViewerType

Parameters

Parameter	Type	Default value
viewerType	T	undefined
table	DataFrame	undefined
options	object | null	null

Returns

ViewerClass<T>

Inherited from

Viewer.fromType

---

getAll()

static getAll(): Widget<any>[]

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

Returns all currently active widgets.

Returns

Widget<any>[]

Inherited from

Viewer.getAll

---

getViewerTypes()

static getViewerTypes(options?): ViewerType[]

Defined in: js-api/src/viewer.ts:212

Gets all available viewer types Core means the viewer is already loaded and all methods and properties are available synchronously.

Parameters

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

Returns

ViewerType[]

Inherited from

Viewer.getViewerTypes

---

grid()

static grid(t, options?): Grid

Defined in: js-api/src/viewer.ts:344

Creates a Grid for the table.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IGridSettings>

Returns

Grid

Inherited from

Viewer.grid

---

heatMap()

static heatMap(t, options?): Grid

Defined in: js-api/src/viewer.ts:369

Creates a heat map (a Grid in heat-map mode).

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IGridSettings>

Returns

Grid

Inherited from

Viewer.heatMap

---

histogram()

static histogram(t, options?): HistogramViewer

Defined in: js-api/src/viewer.ts:349

Creates a histogram.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IHistogramSettings>

Returns

HistogramViewer

Inherited from

Viewer.histogram

---

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

Parameter	Type
self	Component
scope?	Scope

Returns

void

Inherited from

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

Parameter	Type
x	unknown

Returns

x is Control

Inherited from

Viewer.is

---

lineChart()

static lineChart(t, options?): LineChartViewer

Defined in: js-api/src/viewer.ts:389

Creates a line chart.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<ILineChartSettings>

Returns

LineChartViewer

Inherited from

Viewer.lineChart

---

markup()

static markup(t, options?): Viewer<IMarkupViewerSettings>

Defined in: js-api/src/viewer.ts:419

Creates a markup viewer.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IMarkupViewerSettings>

Returns

Viewer<IMarkupViewerSettings>

Inherited from

Viewer.markup

---

matrixPlot()

static matrixPlot(t, options?): MatrixPlot

Defined in: js-api/src/viewer.ts:424

Creates a matrix plot.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IMatrixPlotSettings>

Returns

MatrixPlot

Inherited from

Viewer.matrixPlot

---

network()

static network(t, options?): NetworkDiagramViewer

Defined in: js-api/src/viewer.ts:394

Creates a network diagram.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<INetworkDiagramSettings>

Returns

NetworkDiagramViewer

Inherited from

Viewer.network

---

pcPlot()

static pcPlot(t, options?): PcPlot

Defined in: js-api/src/viewer.ts:429

Creates a parallel-coordinates plot.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IPcPlotSettings>

Returns

PcPlot

Inherited from

Viewer.pcPlot

---

pieChart()

static pieChart(t, options?): PieChartViewer

Defined in: js-api/src/viewer.ts:434

Creates a pie chart.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IPieChartSettings>

Returns

PieChartViewer

Inherited from

Viewer.pieChart

---

pivotTable()

static pivotTable(t, options?): PivotViewer

Defined in: js-api/src/viewer.ts:464

Creates a pivot table.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IPivotViewerSettings>

Returns

PivotViewer

Inherited from

Viewer.pivotTable

---

registerCleanup()

static registerCleanup(element, cleanup): void

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

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

Parameter	Type
element	Element
cleanup	Callback

Returns

void

Inherited from

Viewer.registerCleanup

---

rocCurve()

static rocCurve(t, options?): RocCurve

Defined in: js-api/src/viewer.ts:364

Creates a ROC curve.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IRocCurveSettings>

Returns

RocCurve

Inherited from

Viewer.rocCurve

---

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

Parameter	Type
a	unknown
b	unknown

Returns

boolean

Inherited from

Viewer.sameValue

---

scatterPlot()

static scatterPlot(t, options?): ScatterPlotViewer

Defined in: js-api/src/viewer.ts:384

Creates a scatter plot.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IScatterPlotSettings>

Returns

ScatterPlotViewer

Inherited from

Viewer.scatterPlot

---

scatterPlot3d()

static scatterPlot3d(t, options?): Viewer<IScatterPlot3dSettings>

Defined in: js-api/src/viewer.ts:439

Creates a 3D scatter plot.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IScatterPlot3dSettings>

Returns

Viewer<IScatterPlot3dSettings>

Inherited from

Viewer.scatterPlot3d

---

statistics()

static statistics(t, options?): Viewer<IStatsViewerSettings>

Defined in: js-api/src/viewer.ts:444

Creates a statistics viewer.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<IStatsViewerSettings>

Returns

Viewer<IStatsViewerSettings>

Inherited from

Viewer.statistics

---

tile()

static tile(t, options?): TileViewer

Defined in: js-api/src/viewer.ts:449

Creates a tile viewer.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<ITileViewerSettings>

Returns

TileViewer

Inherited from

Viewer.tile

---

treeMap()

static treeMap(t, options?): TreeMap

Defined in: js-api/src/viewer.ts:454

Creates a tree map.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<ITreeMapSettings>

Returns

TreeMap

Inherited from

Viewer.treeMap

---

trellisPlot()

static trellisPlot(t, options?): TrellisPlotViewer

Defined in: js-api/src/viewer.ts:459

Creates a trellis plot.

Parameters

Parameter	Type
t	DataFrame
options?	Partial<ITrellisPlotSettings>

Returns

TrellisPlotViewer

Inherited from

Viewer.trellisPlot