Grid
Defined in: js-api/src/grid.ts:941
Base class for controls that have a visual root and a set of properties.
Extends
Constructors
Constructor
new Grid(
dart):Grid
Defined in: js-api/src/grid.ts:953
Parameters
| Parameter | Type |
|---|---|
dart | any |
Returns
Grid
Overrides
Properties
| Property | Modifier | Type | Default value | Description | Inherited from | Defined in |
|---|---|---|---|---|---|---|
_functions | protected | Func[] | [] | - | Viewer._functions | js-api/src/widgets/base.ts:207 |
_properties | protected | Property[] | [] | - | Viewer._properties | js-api/src/widgets/base.ts:206 |
_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:212 |
factory | public | Func | null | null | Constructor function. No parameters, returns [Widget]. | Viewer.factory | js-api/src/widgets/base.ts:204 |
isDetached | public | boolean | false | Whether detach has been called. | Viewer.isDetached | js-api/src/widgets/base.ts:214 |
props | public | IGridSettings & ObjectPropertyBag | undefined | Property bag over this widget's properties; read and write them by name. | Viewer.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. | 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:211 |
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:201 |
CONFLICT_CELL_COLOR | readonly | 4294959282 | 0xFFFFE0B2 | - | - | js-api/src/grid.ts:948 |
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:527 |
DIRTY_CELL_COLOR | readonly | 4294964173 | 0xFFFFF3CD | Background of a cell with an unsaved edit. Canvas ARGB ints, matching the platform's own in-grid editing — cell backgrounds are painted on the canvas, so they are not CSS-token territory. The amber and the orange have no Color equivalent; the red is the platform's own grid warning. | - | js-api/src/grid.ts:946 |
INVALID_CELL_COLOR | readonly | number | Color.gridWarningBackground | - | - | js-api/src/grid.ts:947 |
Accessors
aiDescription
Get Signature
get aiDescription():
string|null
Defined in: js-api/src/viewer.ts:147
AI briefing of the underlying Dart viewer.
Returns
string | null
Set Signature
set aiDescription(
x):void
Defined in: js-api/src/viewer.ts:152
A short AI-facing briefing, seeded from the registry's usage or description.
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
canvas
Get Signature
get canvas():
HTMLCanvasElement
Defined in: js-api/src/grid.ts:1170
Returns
HTMLCanvasElement
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
colHeaderBox
Get Signature
get colHeaderBox():
Rect
Defined in: js-api/src/grid.ts:1291
Column labels box
Returns
colHeaderHeight
Get Signature
get colHeaderHeight():
number
Defined in: js-api/src/grid.ts:1283
Column labels height
Returns
number
columns
Get Signature
get columns():
GridColumnList
Defined in: js-api/src/grid.ts:1136
Grid columns.
Returns
dataFrame
Get Signature
get dataFrame():
DataFrame
Defined in: js-api/src/viewer.ts:323
Returns
Set Signature
set dataFrame(
t):void
Defined in: js-api/src/viewer.ts:324
Parameters
| Parameter | Type |
|---|---|
t | DataFrame |
Returns
void
Inherited from
descriptor
Get Signature
get descriptor():
WidgetDescriptor
Defined in: js-api/src/viewer.ts:141
Descriptor of this widget.
Returns
Inherited from
editor
Get Signature
get editor():
IFrameEditor|null
Defined in: js-api/src/grid.ts:973
The editing engine attached through attachEditor, or null.
Returns
IFrameEditor | null
filter
Get Signature
get filter():
BitSet
Defined in: js-api/src/viewer.ts:134
combined filter of the viewer
Returns
Set Signature
set filter(
f):void
Defined in: js-api/src/viewer.ts:137
Parameters
| Parameter | Type |
|---|---|
f | BitSet |
Returns
void
Inherited from
helpUrl
Get Signature
get helpUrl():
string
Defined in: js-api/src/viewer.ts:327
Help URL
Returns
string
Set Signature
set helpUrl(
s):void
Defined in: js-api/src/viewer.ts:328
Parameters
| Parameter | Type |
|---|---|
s | string |
Returns
void
Inherited from
horzScroll
Get Signature
get horzScroll():
RangeSlider
Defined in: js-api/src/grid.ts:1278
Horizontal scroll bar
Returns
immediateRendering
Get Signature
get immediateRendering():
boolean
Defined in: js-api/src/viewer.ts:333
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:334
Parameters
| Parameter | Type |
|---|---|
x | boolean |
Returns
void
Inherited from
isRenderPending
Get Signature
get isRenderPending():
boolean
Defined in: js-api/src/viewer.ts:338
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
meta
Get Signature
get meta():
ViewerMetaHelper
Defined in: js-api/src/viewer.ts:296
Formula lines and annotation regions of this viewer.
Returns
Inherited from
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
onAfterDrawContent
Get Signature
get onAfterDrawContent():
Observable<EventData<any>>
Defined in: js-api/src/grid.ts:1343
Fires after the cell content is drawn.
Returns
Observable<EventData<any>>
onAfterDrawOverlay
Get Signature
get onAfterDrawOverlay():
Observable<EventData<any>>
Defined in: js-api/src/grid.ts:1339
Fires after the overlay is drawn — draw on top of the grid here.
Returns
Observable<EventData<any>>
Overrides
onAfterDrawScene
Get Signature
get onAfterDrawScene():
Observable<EventData<any>>
Defined in: js-api/src/viewer.ts:180
Fires after rendering of the main canvas.
Returns
Observable<EventData<any>>
Inherited from
onAfterLayout
Get Signature
get onAfterLayout():
Observable<EventData<any>>
Defined in: js-api/src/viewer.ts:176
Fires after the viewer completes a layout pass.
Returns
Observable<EventData<any>>
Inherited from
onBeforeDrawContent
Get Signature
get onBeforeDrawContent():
Observable<EventData<any>>
Defined in: js-api/src/grid.ts:1341
Fires before the cell content is drawn.
Returns
Observable<EventData<any>>
onBeforeDrawOverlay
Get Signature
get onBeforeDrawOverlay():
Observable<EventData<any>>
Defined in: js-api/src/grid.ts:1337
Fires before the overlay (interactive layer) is drawn; preventDefault() to draw it yourself.
Returns
Observable<EventData<any>>
Overrides
onBeforeDrawScene
Get Signature
get onBeforeDrawScene():
Observable<EventData<any>>
Defined in: js-api/src/viewer.ts:178
Fires before rendering of the main canvas.
Returns
Observable<EventData<any>>
Inherited from
onCellClick
Get Signature
get onCellClick():
Observable<GridCell<any>>
Defined in: js-api/src/grid.ts:1326
Fires when a cell is clicked.
Returns
Observable<GridCell<any>>
onCellDoubleClick
Get Signature
get onCellDoubleClick():
Observable<GridCell<any>>
Defined in: js-api/src/grid.ts:1328
Fires when a cell is double-clicked.
Returns
Observable<GridCell<any>>
onCellKeyDown
Get Signature
get onCellKeyDown():
Observable<GridCell<any>>
Defined in: js-api/src/grid.ts:1332
Fires on key-down while a cell has focus.
Returns
Observable<GridCell<any>>
onCellMouseDown
Get Signature
get onCellMouseDown():
Observable<GridCell<any>>
Defined in: js-api/src/grid.ts:1330
Fires on mouse-down over a cell, before the click is processed.
Returns
Observable<GridCell<any>>
onCellMouseEnter
Get Signature
get onCellMouseEnter():
Observable<GridCell<any>>
Defined in: js-api/src/grid.ts:1321
Fires when the mouse enters a cell.
Returns
Observable<GridCell<any>>
onCellMouseLeave
Get Signature
get onCellMouseLeave():
Observable<GridCell<any>>
Defined in: js-api/src/grid.ts:1323
Fires when the mouse leaves a cell.
Returns
Observable<GridCell<any>>
onCellRender
Get Signature
get onCellRender():
Observable<GridCellRenderArgs>
Defined in: js-api/src/grid.ts:1158
Occurs before the grid cell is rendered. Call args.preventDefault() to suppress the standard
rendering and draw your own via args.g within args.bounds.
Sample: https://public.datagrok.ai/js/samples/grid/events/custom-cell-rendering-indexes
See also onCellRendered.
Returns
Observable<GridCellRenderArgs>
onCellRendered
Get Signature
get onCellRendered():
Observable<GridCellRenderArgs>
Defined in: js-api/src/grid.ts:1165
Occurs after the grid cell has been rendered. See also onCellRender.
Returns
Observable<GridCellRenderArgs>
onCellValueEdited
Get Signature
get onCellValueEdited():
Observable<GridCell<any>>
Defined in: js-api/src/grid.ts:1317
Fires after the user edits a cell value; emits the edited GridCell.
Returns
Observable<GridCell<any>>
onColumnResized
Get Signature
get onColumnResized():
Observable<any>
Defined in: js-api/src/grid.ts:1304
Sample: https://public.datagrok.ai/js/samples/grid/resize/resize-events
Returns
Observable<any>
onContextMenu
Get Signature
get onContextMenu():
Observable<Menu>
Defined in: js-api/src/viewer.ts:466
Fires when the viewer builds its context menu; add items to the emitted Menu.
Returns
Observable<Menu>
Inherited from
onCurrentCellChanged
Get Signature
get onCurrentCellChanged():
Observable<GridCell<any>>
Defined in: js-api/src/grid.ts:1319
Fires when the current (focused) grid cell changes.
Returns
Observable<GridCell<any>>
onDartPropertyChanged
Get Signature
get onDartPropertyChanged():
Observable<null>
Defined in: js-api/src/viewer.ts:494
Low-level stream of property changes on the Dart side; prefer onPropertyValueChanged.
Returns
Observable<null>
Inherited from
onDataEvent
Get Signature
get onDataEvent():
Observable<ViewerEvent>
Defined in: js-api/src/viewer.ts:161
All data events of this viewer (selection, row click, tooltip); filter by e.type.
Returns
Observable<ViewerEvent>
Inherited from
onDataFrameChanged
Get Signature
get onDataFrameChanged():
Observable<any>
Defined in: js-api/src/viewer.ts:172
Fires when the viewer's underlying DataFrame is replaced (table attached).
Returns
Observable<any>
Inherited from
onDataRowClicked
Get Signature
get onDataRowClicked():
Observable<ViewerEvent>
Defined in: js-api/src/viewer.ts:167
current row clicked
Returns
Observable<ViewerEvent>
Inherited from
onDataSelected
Get Signature
get onDataSelected():
Observable<ViewerEvent>
Defined in: js-api/src/viewer.ts:165
Fires when the user selects data in the viewer.
Returns
Observable<ViewerEvent>
Inherited from
onDetached
Get Signature
get onDetached():
Observable<any>
Defined in: js-api/src/viewer.ts:509
Occurs when viewer is detached.
Returns
Observable<any>
Inherited from
onGridCellLinkClicked
Get Signature
get onGridCellLinkClicked():
Observable<EventData<GridCellArgs>>
Defined in: js-api/src/grid.ts:1347
Fires when a link inside a cell of this grid is clicked; args.gridCell and args.link.
Returns
Observable<EventData<GridCellArgs>>
onPinnedRowsChanged
Get Signature
get onPinnedRowsChanged():
Observable<any>
Defined in: js-api/src/grid.ts:1314
Fires when rows are pinned or unpinned.
Returns
Observable<any>
onPropertyValueChanged
Get Signature
get onPropertyValueChanged():
Observable<EventData<Property>>
Defined in: js-api/src/viewer.ts:169
Fires after any viewer property changes; args.property is the property.
Returns
Observable<EventData<Property>>
Inherited from
onResized
Get Signature
get onResized():
Observable<null>
Defined in: js-api/src/viewer.ts:174
Fires when the viewer is resized.
Returns
Observable<null>
Inherited from
onRowEnter
Get Signature
get onRowEnter():
Observable<GridCell<any>>
Defined in: js-api/src/grid.ts:1334
Fires when the mouse enters a row.
Returns
Observable<GridCell<any>>
onRowsResized
Get Signature
get onRowsResized():
Observable<any>
Defined in: js-api/src/grid.ts:1309
Sample: https://public.datagrok.ai/js/samples/grid/resize/resize-events
Returns
Observable<any>
onRowsSorted
Get Signature
get onRowsSorted():
Observable<any>
Defined in: js-api/src/grid.ts:1312
Sample: https://public.datagrok.ai/js/samples/grid/order/order-rows
Returns
Observable<any>
onTooltipCreated
Get Signature
get onTooltipCreated():
Observable<ViewerEvent>
Defined in: js-api/src/viewer.ts:163
Fires when the viewer shows a data tooltip.
Returns
Observable<ViewerEvent>
Inherited from
onTooltipCreating
Get Signature
get onTooltipCreating():
Observable<GridTooltipArgs>
Defined in: js-api/src/grid.ts:1345
Fires before a cell tooltip is shown; preventDefault() to suppress it or supply your own.
Returns
Observable<GridTooltipArgs>
onViewerRendered
Get Signature
get onViewerRendered():
Observable<EventData<any>>
Defined in: js-api/src/viewer.ts:186
Fires after the viewer is rendered.
Returns
Observable<EventData<any>>
Inherited from
overlay
Get Signature
get overlay():
HTMLCanvasElement
Defined in: js-api/src/grid.ts:1175
Returns
HTMLCanvasElement
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
pinnedRows
Get Signature
get pinnedRows():
Iterable<number>
Defined in: js-api/src/grid.ts:1241
Pinned rows.
Returns
Iterable<number>
propertyTarget
Get Signature
get propertyTarget():
unknown
Defined in: js-api/src/viewer.ts:245
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
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
root
Get Signature
get root():
HTMLElement
Defined in: js-api/src/viewer.ts:291
Visual root.
Returns
HTMLElement
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
sortByColumns
Get Signature
get sortByColumns():
Column<any,any>[]
Defined in: js-api/src/grid.ts:1180
List of columns the grid is sorted by.
Returns
Column<any, any>[]
sortTypes
Get Signature
get sortTypes():
boolean[]
Defined in: js-api/src/grid.ts:1183
Sort directions for [sortByColumns]: true = ascending order, false = descending order.
Returns
boolean[]
table
Get Signature
get table():
DataFrame
Defined in: js-api/src/viewer.ts:308
The DataFrame this viewer is attached to. Same as dataFrame.
Returns
Inherited from
tableView
Get Signature
get tableView():
TableView|null
Defined in: js-api/src/viewer.ts:318
Returns a view this viewer is associated with, or null
Returns
TableView | null
Inherited from
type
Get Signature
get type():
ViewerType
Defined in: js-api/src/viewer.ts:303
Returns viewer type (see VIEWER constants)
Returns
Inherited from
vertScroll
Get Signature
get vertScroll():
RangeSlider
Defined in: js-api/src/grid.ts:1267
Vertical scroll bar. Sample: https://public.datagrok.ai/js/samples/grid/navigate/scroll-bars
Returns
view
Get Signature
get view():
View|null
Defined in: js-api/src/viewer.ts:313
Returns a view this viewer is associated with, or null
Returns
View | null
Inherited from
Methods
_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
_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/viewer.ts:257
Returns
void
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
apply()
apply(
properties):Widget
Defined in: js-api/src/widgets/base.ts:255
Parameters
| Parameter | Type |
|---|---|
properties | object |
Returns
Inherited from
attachEditor()
attachEditor(
editor):void
Defined in: js-api/src/grid.ts:991
Makes this grid the host of [editor] (replacing any previous one): in-grid
edits are reported to it, its state paints the cells (amber pending, red
invalid, orange conflict, the message as the tooltip), every ~ service
column is hidden and locked, and editability follows
editor.writableColumns / editor.isSaving per column and
editor.canEdit per cell. The grid never writes the editing state itself —
the editor is its single writer.
const editor = await DG.DomainFrameEditor.attach(df, grok.dapi.domains.table('grit.issue'));
const grid = DG.Grid.create(df);
DG.DomainObjectHandler.decorateGrid(grid, 'grit.issue', df);
grid.attachEditor(editor);
Parameters
| Parameter | Type |
|---|---|
editor | IFrameEditor |
Returns
void
autoSize()
autoSize(
maxWidth,maxHeight,minWidth?,minHeight?,autoSizeOnDataChange?):void
Defined in: js-api/src/grid.ts:1355
Resizes the grid to fit the content
Parameters
| Parameter | Type |
|---|---|
maxWidth | number |
maxHeight | number |
minWidth? | number |
minHeight? | number |
autoSizeOnDataChange? | boolean |
Returns
void
bindProps()
bindProps():
BindProp[]
Defined in: js-api/src/viewer.ts:277
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/viewer.ts:264
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
cell()
Call Signature
cell(
gridRow,columnName):GridCell
Defined in: js-api/src/grid.ts:1147
Returns the grid cell at the specified position; both argument orders are accepted, the (row, column) one matches DataFrame.cell.
Parameters
| Parameter | Type |
|---|---|
gridRow | number |
columnName | string |
Returns
Call Signature
cell(
columnName,gridRow):GridCell
Defined in: js-api/src/grid.ts:1148
Returns the grid cell at the specified position; both argument orders are accepted, the (row, column) one matches DataFrame.cell.
Parameters
| Parameter | Type |
|---|---|
columnName | string |
gridRow | number |
Returns
close()
close():
void
Defined in: js-api/src/viewer.ts:286
Closes and detaches the viewer.
Returns
void
Inherited from
col()
col(
name):GridColumn<any> |null
Defined in: js-api/src/grid.ts:1141
Returns a column with the specified name.
Parameters
| Parameter | Type |
|---|---|
name | string |
Returns
GridColumn<any> | null
copyViewersLook()
copyViewersLook(
other):void
Defined in: js-api/src/viewer.ts:512
Copies all settings (the look) from [other] into this viewer.
Parameters
| Parameter | Type |
|---|---|
other | Viewer |
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/grid.ts:1102
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
Overrides
detachEditor()
detachEditor():
void
Defined in: js-api/src/grid.ts:1093
Releases the editor's subscriptions; the grid keeps its frame and columns.
Returns
void
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/viewer.ts:144
Functions applicable to the underlying Dart viewer.
Returns
Func[]
Inherited from
getInfo()
getInfo():
object
Defined in: js-api/src/viewer.ts:234
Viewer internals exposed for diagnostics and tests (canvas, overlay, and more), keyed by name.
Returns
object
Inherited from
getOptions()
getOptions(
includeDefaults?):object
Defined in: js-api/src/viewer.ts:229
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:229 |
look | ViewerOptions<IGridSettings> | js-api/src/viewer.ts:229 |
type | ViewerType | js-api/src/viewer.ts:229 |
Inherited from
getProperties()
getProperties():
Property[]
Defined in: js-api/src/viewer.ts:239
All properties of this viewer, including the data-bound ones.
Returns
Property[]
Inherited from
getRowOrder()
getRowOrder():
Int32Array
Defined in: js-api/src/grid.ts:1228
Returns the order of rows in the table.
Returns
Int32Array
getVisibleCells()
getVisibleCells(
column?):Iterable<GridCell<any>>
Defined in: js-api/src/grid.ts:1350
Returns currently visible cells
Parameters
| Parameter | Type | Default value |
|---|---|---|
column | GridColumn<any> | null | null |
Returns
Iterable<GridCell<any>>
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
gridRowToTable()
gridRowToTable(
gridRow):number
Defined in: js-api/src/grid.ts:1275
Converts grid row index to table index. See also tableRowToGrid
Parameters
| Parameter | Type |
|---|---|
gridRow | number |
Returns
number
hitTest()
hitTest(
x,y):GridCell<any> |null
Defined in: js-api/src/grid.ts:1205
Returns a grid cell at the specified position, or null if there is none. Sample: https://public.datagrok.ai/js/samples/grid/advanced/hit-test
Parameters
| Parameter | Type |
|---|---|
x | number |
y | number |
Returns
GridCell<any> | null
initDartObject()
initDartObject(
dart):void
Defined in: js-api/src/viewer.ts:188
Parameters
| Parameter | Type |
|---|---|
dart | any |
Returns
void
Inherited from
invalidate()
invalidate():
void
Defined in: js-api/src/grid.ts:1262
Causes the grid to repaint. Sample: https://public.datagrok.ai/js/samples/grid/advanced/invalidate
Returns
void
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
onCellPrepare()
onCellPrepare(
callback):StreamSubscription
Defined in: js-api/src/grid.ts:1188
Sample: https://public.datagrok.ai/js/samples/grid/events/custom-cell-prepare
Parameters
| Parameter | Type |
|---|---|
callback | (cell) => any |
Returns
onCellTooltip()
onCellTooltip(
callback):StreamSubscription
Defined in: js-api/src/grid.ts:1197
Sample: https://public.datagrok.ai/js/samples/grid/events/custom-cell-tooltip
Parameters
| Parameter | Type |
|---|---|
callback | (cell, x, y) => any |
Returns
onEvent()
onEvent(
eventId?):Observable<any>
Defined in: js-api/src/viewer.ts:471
Observes platform events with the specified eventId.
Parameters
| Parameter | Type | Default value |
|---|---|---|
eventId | string | null | null |
Returns
Observable<any>
Inherited from
onFrameAttached()
onFrameAttached(
dataFrame):void
Defined in: js-api/src/widgets/base.ts:292
Called when a DataFrame is attached; override to bind data.
Parameters
| Parameter | Type |
|---|---|
dataFrame | DataFrame |
Returns
void
Inherited from
onPropertyChanged()
onPropertyChanged(
property):void
Defined in: js-api/src/widgets/base.ts:281
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
own()
own(
dispose):this
Defined in: js-api/src/u2core/component.ts:139
Parameters
| Parameter | Type |
|---|---|
dispose | () => void |
Returns
this
Inherited from
propertyChanges()
protectedpropertyChanges():ObservableLike<PropertyChange>
Defined in: js-api/src/viewer.ts:247
What refreshes the property tier's cached signals from outside: null where nothing announces a change (one-way).
Returns
ObservableLike<PropertyChange>
Inherited from
registerFunction()
protectedregisterFunction(f):void
Defined in: js-api/src/u2core/component.ts:431
Parameters
| Parameter | Type |
|---|---|
f | FuncLike |
Returns
void
Inherited from
removeFromView()
removeFromView():
any
Defined in: js-api/src/viewer.ts:517
Removes the viewer from its view without disposing it.
Returns
any
Inherited from
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
| Parameter | Type | Description |
|---|---|---|
name | string | The name passed to addStatusProvider. |
Returns
void
Example
widget.removeStatusProvider('selection');
see samples/grid/custom-renderer-status
Inherited from
render()
render(
g,bounds):void
Defined in: js-api/src/grid.ts:1366
Renders the content of this grid to the specified canvas and bounds.
Parameters
| Parameter | Type |
|---|---|
g | CanvasRenderingContext2D |
bounds | Rect |
Returns
void
resetRowHeight()
resetRowHeight():
void
Defined in: js-api/src/grid.ts:1288
Resets rows height
Returns
void
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
runPostponedComputations()
runPostponedComputations():
void
Defined in: js-api/src/grid.ts:1297
Forces the grid to execute calculations that were postponed before the next rendering (such as recalculating layout). Call it in case the client code changes column widths and needs to access the new recalculated layout.
Returns
void
scrollToCell()
scrollToCell(
column,row):void
Defined in: js-api/src/grid.ts:1248
Returns a grid cell at the specified position. Sample: https://public.datagrok.ai/js/samples/grid/navigate/scroll-to-cell
Parameters
| Parameter | Type |
|---|---|
column | string | Column<any, any> |
row | number |
Returns
void
scrollToPixels()
scrollToPixels(
x,y):void
Defined in: js-api/src/grid.ts:1255
Scrolls the grid to the specified position. Sample: https://public.datagrok.ai/js/samples/grid/navigate/scroll-to-pixels
Parameters
| Parameter | Type |
|---|---|
x | number |
y | number |
Returns
void
setColumnsWidthType()
setColumnsWidthType(
type,columns?):void
Defined in: js-api/src/grid.ts:1361
Applies a column-width policy (Minimal / Compact / Optimal / Maximal) to the given columns,
or to all columns when columns is omitted. Same as Grid's right-click menu → "Column Sizing".
Parameters
| Parameter | Type |
|---|---|
type | ColumnWidthType |
columns? | GridColumn<any>[] |
Returns
void
setOptions()
setOptions(
map):void
Defined in: js-api/src/viewer.ts:218
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
setRowOrder()
setRowOrder(
indexes):Grid
Defined in: js-api/src/grid.ts:1235
Sets the order or rows in the table. Sample: https://public.datagrok.ai/js/samples/grid/order/order-rows Also,
Parameters
| Parameter | Type |
|---|---|
indexes | number[] |
Returns
Grid
See
sortIndexes
sort()
sort(
columns,orders?):Grid
Defined in: js-api/src/grid.ts:1212
Sorts rows by the specified [columns] (names or objects). Specify sort directions via the [orders] array (true = ascending, false = descending); when [orders] is omitted, sorts in ascending order.
Parameters
| Parameter | Type | Default value |
|---|---|---|
columns | string[] | Column<any, any>[] | undefined |
orders | boolean[] | null | null |
Returns
Grid
sortIndexes()
sortIndexes(
indexComparer):Grid
Defined in: js-api/src/grid.ts:1220
Sorts the rows, using the specified comparer that accepts indexes. Sample: https://public.datagrok.ai/js/samples/grid/order/order-rows-by-comparer Also,
Parameters
| Parameter | Type |
|---|---|
indexComparer | (a, b) => number |
Returns
Grid
See
setRowOrder
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
sub()
sub(
subscription):void
Defined in: js-api/src/widgets/base.ts:250
Registers a subscription to an external event.
Parameters
| Parameter | Type |
|---|---|
subscription | Subscription |
Returns
void
Inherited from
tableRowToGrid()
tableRowToGrid(
tableRow):number
Defined in: js-api/src/grid.ts:1272
Converts table row index to grid index. See also gridRowToTable
Parameters
| Parameter | Type |
|---|---|
tableRow | number |
Returns
number
toCompactLook()
toCompactLook():
void
Defined in: js-api/src/viewer.ts:489
Switches the viewer to the compact look used inside a trellis plot.
Returns
void
Inherited from
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
barChart()
staticbarChart(t,options?):BarChartViewer
Defined in: js-api/src/viewer.ts:351
Creates a bar chart.
Parameters
| Parameter | Type |
|---|---|
t | DataFrame |
options? | Partial<IBarChartSettings> |
Returns
Inherited from
boxPlot()
staticboxPlot(t,options?):BoxPlot
Defined in: js-api/src/viewer.ts:371
Creates a box plot.
Parameters
| Parameter | Type |
|---|---|
t | DataFrame |
options? | Partial<IBoxPlotSettings> |
Returns
Inherited from
build()
staticbuild(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
Inherited from
calendar()
staticcalendar(t,options?):CalendarViewer
Defined in: js-api/src/viewer.ts:396
Creates a calendar.
Parameters
| Parameter | Type |
|---|---|
t | DataFrame |
options? | Partial<ICalendarSettings> |
Returns
Inherited from
canVisualize()
staticcanVisualize(viewerType,dataFrame):string|null
Defined in: js-api/src/viewer.ts:522
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
confusionMatrix()
staticconfusionMatrix(t,options?):ConfusionMatrix
Defined in: js-api/src/viewer.ts:356
Creates a confusion matrix.
Parameters
| Parameter | Type |
|---|---|
t | DataFrame |
options? | Partial<IConfusionMatrixSettings> |
Returns
Inherited from
correlationPlot()
staticcorrelationPlot(t,options?):CorrelationPlot
Defined in: js-api/src/viewer.ts:401
Creates a correlation plot.
Parameters
| Parameter | Type |
|---|---|
t | DataFrame |
options? | Partial<ICorrelationPlotSettings> |