ScatterPlotViewer
Defined in: js-api/src/viewer.ts:718
2D scatter plot
Extends
Constructors
Constructor
new ScatterPlotViewer(
dart):ScatterPlotViewer
Defined in: js-api/src/viewer.ts:719
Parameters
| Parameter | Type |
|---|---|
dart | any |
Returns
ScatterPlotViewer
Overrides
Properties
| Property | Modifier | Type | Default value | Description | Inherited from | Defined in |
|---|---|---|---|---|---|---|
_functions | protected | Func[] | [] | - | Viewer._functions | js-api/src/widgets/base.ts:214 |
_properties | protected | Property[] | [] | - | Viewer._properties | js-api/src/widgets/base.ts:213 |
_root | protected | HTMLElement | undefined | - | Viewer._root | js-api/src/u2core/component.ts:423 |
_u2 | readonly | ComponentState | undefined | - | Viewer._u2 | js-api/src/u2core/component.ts:76 |
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:71 |
dart | public | any | undefined | - | Viewer.dart | js-api/src/widgets/base.ts:217 |
factory | public | Func | null | null | Constructor function. No parameters, returns [Widget]. | Viewer.factory | js-api/src/widgets/base.ts:211 |
isDetached | public | boolean | false | - | Viewer.isDetached | js-api/src/widgets/base.ts:218 |
props | public | IScatterPlotSettings & ObjectPropertyBag | undefined | - | Viewer.props | js-api/src/widgets/base.ts:215 |
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:75 |
subs | public | Subscription[] | undefined | - | Viewer.subs | js-api/src/widgets/base.ts:216 |
tags | public | any | undefined | - | Viewer.tags | js-api/src/viewer.ts:90 |
temp | public | any | undefined | Contains auxiliary information | Viewer.temp | js-api/src/widgets/base.ts:208 |
CORE_VIEWER_TYPES | static | string[] | undefined | - | Viewer.CORE_VIEWER_TYPES | js-api/src/viewer.ts:455 |
Accessors
aiDescription
Get Signature
get aiDescription():
string|null
Defined in: js-api/src/viewer.ts:117
AI briefing of the underlying Dart viewer.
Returns
string | null
Set Signature
set aiDescription(
x):void
Defined in: js-api/src/viewer.ts:122
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:272
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/viewer.ts:723
Returns
HTMLCanvasElement
children
Get Signature
get children():
Widget<any>[]
Defined in: js-api/src/widgets/base.ts:304
Parent widget up the DOM tree, or null.
Returns
Widget<any>[]
Inherited from
dataFrame
Get Signature
get dataFrame():
DataFrame
Defined in: js-api/src/viewer.ts:292
Returns
Set Signature
set dataFrame(
t):void
Defined in: js-api/src/viewer.ts:293
Parameters
| Parameter | Type |
|---|---|
t | DataFrame |
Returns
void
Inherited from
descriptor
Get Signature
get descriptor():
WidgetDescriptor
Defined in: js-api/src/viewer.ts:108
Descriptor of this widget.
Returns
Inherited from
filter
Get Signature
get filter():
BitSet
Defined in: js-api/src/viewer.ts:101
combined filter of the viewer
Returns
Set Signature
set filter(
f):void
Defined in: js-api/src/viewer.ts:104
Parameters
| Parameter | Type |
|---|---|
f | BitSet |
Returns
void
Inherited from
helpUrl
Get Signature
get helpUrl():
string
Defined in: js-api/src/viewer.ts:296
Help URL
Returns
string
Set Signature
set helpUrl(
s):void
Defined in: js-api/src/viewer.ts:297
Parameters
| Parameter | Type |
|---|---|
s | string |
Returns
void
Inherited from
meta
Get Signature
get meta():
ViewerMetaHelper
Defined in: js-api/src/viewer.ts:265
Returns
Inherited from
name
Get Signature
get name():
string|undefined
Defined in: js-api/src/u2core/component.ts:67
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).
Returns
string | undefined
Set Signature
set name(
x):void
Defined in: js-api/src/u2core/component.ts:68
Parameters
| Parameter | Type |
|---|---|
x | string | undefined |
Returns
void
Inherited from
onAfterDrawOverlay
Get Signature
get onAfterDrawOverlay():
Observable<EventData<any>>
Defined in: js-api/src/viewer.ts:150
Fires after rendering of the overlay canvas (interactive layer).
Returns
Observable<EventData<any>>
Inherited from
onAfterDrawScene
Get Signature
get onAfterDrawScene():
Observable<EventData<any>>
Defined in: js-api/src/viewer.ts:146
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:142
Fires after the viewer completes a layout pass.
Returns
Observable<EventData<any>>
Inherited from
onBeforeDrawOverlay
Get Signature
get onBeforeDrawOverlay():
Observable<EventData<any>>
Defined in: js-api/src/viewer.ts:148
Fires before rendering of the overlay canvas (interactive layer).
Returns
Observable<EventData<any>>
Inherited from
onBeforeDrawScene
Get Signature
get onBeforeDrawScene():
Observable<EventData<any>>
Defined in: js-api/src/viewer.ts:144
Fires before rendering of the main canvas.
Returns
Observable<EventData<any>>
Inherited from
onContextMenu
Get Signature
get onContextMenu():
Observable<Menu>
Defined in: js-api/src/viewer.ts:400
Returns
Observable<Menu>
Inherited from
onDartPropertyChanged
Get Signature
get onDartPropertyChanged():
Observable<null>
Defined in: js-api/src/viewer.ts:426
Returns
Observable<null>
Inherited from
onDataEvent
Get Signature
get onDataEvent():
Observable<ViewerEvent>
Defined in: js-api/src/viewer.ts:130
Returns
Observable<ViewerEvent>
Inherited from
onDataFrameChanged
Get Signature
get onDataFrameChanged():
Observable<any>
Defined in: js-api/src/viewer.ts:138
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:134
Returns
Observable<ViewerEvent>
Inherited from
onDataSelected
Get Signature
get onDataSelected():
Observable<ViewerEvent>
Defined in: js-api/src/viewer.ts:132
Returns
Observable<ViewerEvent>
Inherited from
onDetached
Get Signature
get onDetached():
Observable<any>
Defined in: js-api/src/viewer.ts:441
Occurs when viewer is detached.
Returns
Observable<any>
Inherited from
onPointClicked
Get Signature
get onPointClicked():
Observable<EventData<RowDataArgs>>
Defined in: js-api/src/viewer.ts:778
Returns
Observable<EventData<RowDataArgs>>
onPointDoubleClicked
Get Signature
get onPointDoubleClicked():
Observable<EventData<RowDataArgs>>
Defined in: js-api/src/viewer.ts:779
Returns
Observable<EventData<RowDataArgs>>
onPointsSelected
Get Signature
get onPointsSelected():
Observable<EventData<any>>
Defined in: js-api/src/viewer.ts:780
Returns
Observable<EventData<any>>
onPropertyValueChanged
Get Signature
get onPropertyValueChanged():
Observable<EventData<Property>>
Defined in: js-api/src/viewer.ts:135
Returns
Observable<EventData<Property>>
Inherited from
onResetView
Get Signature
get onResetView():
Observable<null>
Defined in: js-api/src/viewer.ts:776
Returns
Observable<null>
onResized
Get Signature
get onResized():
Observable<null>
Defined in: js-api/src/viewer.ts:140
Fires when the viewer is resized.
Returns
Observable<null>
Inherited from
onTooltipCreated
Get Signature
get onTooltipCreated():
Observable<ViewerEvent>
Defined in: js-api/src/viewer.ts:131
Returns
Observable<ViewerEvent>
Inherited from
onViewerRendered
Get Signature
get onViewerRendered():
Observable<EventData<any>>
Defined in: js-api/src/viewer.ts:152
Fires after the viewer is rendered.
Returns
Observable<EventData<any>>
Inherited from
onViewportChanged
Get Signature
get onViewportChanged():
Observable<Rect>
Defined in: js-api/src/viewer.ts:777
Returns
Observable<Rect>
onZoomed
Get Signature
get onZoomed():
Observable<Rect>
Defined in: js-api/src/viewer.ts:775
Returns
Observable<Rect>
overlay
Get Signature
get overlay():
HTMLCanvasElement
Defined in: js-api/src/viewer.ts:724
Returns
HTMLCanvasElement
parent
Get Signature
get parent():
Widget<any> |null
Defined in: js-api/src/widgets/base.ts:301
Parent widget up the DOM tree, or null.
Returns
Widget<any> | null
Inherited from
propertyTarget
Get Signature
get propertyTarget():
unknown
Defined in: js-api/src/viewer.ts:214
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:276
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:261
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
table
Get Signature
get table():
DataFrame
Defined in: js-api/src/viewer.ts:277
Returns
Inherited from
tableView
Get Signature
get tableView():
TableView|null
Defined in: js-api/src/viewer.ts:287
Returns a view this viewer is associated with, or null
Returns
TableView | null
Inherited from
type
Get Signature
get type():
string
Defined in: js-api/src/viewer.ts:273
Returns viewer type (see VIEWER constants)
Returns
string
Inherited from
view
Get Signature
get view():
View|null
Defined in: js-api/src/viewer.ts:282
Returns a view this viewer is associated with, or null
Returns
View | null
Inherited from
viewBox
Get Signature
get viewBox():
Rect
Defined in: js-api/src/viewer.ts:741
Returns
viewport
Get Signature
get viewport():
Rect
Defined in: js-api/src/viewer.ts:745
Returns
Set Signature
set viewport(
viewport):void
Defined in: js-api/src/viewer.ts:746
Parameters
| Parameter | Type |
|---|---|
viewport | Rect |
Returns
void
xAxisBox
Get Signature
get xAxisBox():
Rect
Defined in: js-api/src/viewer.ts:742
Returns
xAxisSlider
Get Signature
get xAxisSlider():
RangeSlider
Defined in: js-api/src/viewer.ts:750
The horizontal (X) axis range slider. Its isCustomRange flips to true
once the X range is narrowed; drives whether the slider auto-hides.
Returns
yAxisBox
Get Signature
get yAxisBox():
Rect
Defined in: js-api/src/viewer.ts:743
Returns
yAxisSlider
Get Signature
get yAxisSlider():
RangeSlider
Defined in: js-api/src/viewer.ts:752
The vertical (Y) axis range slider.
Returns
Methods
_notifyPropertyChange()
protected_notifyPropertyChange(p):void
Defined in: js-api/src/widgets/base.ts:351
Notifies the property tier. Called from both the addProperty setter (overrides that skip
super would otherwise lose props.x = writes) and onPropertyChanged (direct calls);
the double notify collapses into one microtask refresh.
Parameters
| Parameter | Type |
|---|---|
p | Property | null |
Returns
void
Inherited from
_ownPropertyChanges()
protected_ownPropertyChanges():ObservableLike<PropertyChange>
Defined in: js-api/src/widgets/base.ts:356
Returns
ObservableLike<PropertyChange>
Inherited from
_scopeMinted()
protected_scopeMinted(_scope):void
Defined in: js-api/src/widgets/base.ts:320
First-mint hook: a platform descendant wires its lifecycle here. Never fired for a scope provided to init — that path runs inside the constructor chain.
Parameters
| Parameter | Type |
|---|---|
_scope | Scope |
Returns
void
Inherited from
_wireDartLifecycle()
protected_wireDartLifecycle():void
Defined in: js-api/src/widgets/base.ts:336
Dart-owned lifecycle: the platform kill disposes the scope, and disposing the scope kills the widget through the kill-walk.
Returns
void
Inherited from
_wireJsLifecycle()
protected_wireJsLifecycle():void
Defined in: js-api/src/widgets/base.ts:327
JS-owned lifecycle: disposing the scope detaches the widget, and vice versa.
Returns
void
Inherited from
_wireLifecycle()
protected_wireLifecycle():void
Defined in: js-api/src/viewer.ts:226
Returns
void
Inherited from
apply()
apply(
properties):Widget
Defined in: js-api/src/widgets/base.ts:261
Parameters
| Parameter | Type | Description |
|---|---|---|
properties | object | - |
Returns
Inherited from
bindProps()
bindProps():
BindProp[]
Defined in: js-api/src/viewer.ts:246
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:233
One binding step (DD5): a meta-declared prop's same-named Signal member — a named node is a
bind source, generated off componentMeta the way getProperties is — then, under
propertyTier, a cached signal over the declared property. '' answers the default
binding: the component's own value signal, where one exists.
Parameters
| Parameter | Type |
|---|---|
name | string |
Returns
BindSource | Signal<unknown> | null
Inherited from
close()
close():
void
Defined in: js-api/src/viewer.ts:255
Closes and detaches the viewer.
Returns
void
Inherited from
copyViewersLook()
copyViewersLook(
other):void
Defined in: js-api/src/viewer.ts:443
Parameters
| Parameter | Type |
|---|---|
other | Viewer |
Returns
void
Inherited from
detach()
detach():
void
Defined in: js-api/src/widgets/base.ts:308
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
disableAnnotationRegionDrawing()
disableAnnotationRegionDrawing():
void
Defined in: js-api/src/viewer.ts:773
Returns
void
dispose()
dispose():
void
Defined in: js-api/src/u2core/component.ts:141
On a never-engaged wrapper the getter mints here and _scopeMinted wires the
lifecycle (own(kill) + the platform cleanup for Dart-owned), so dispose still kills it;
re-entry from the kill cleanup is a no-op via the scope's disposed flag.
Returns
void
Inherited from
effect()
effect(
fn):this
Defined in: js-api/src/u2core/component.ts:128
Parameters
| Parameter | Type |
|---|---|
fn | () => void |
Returns
this
Inherited from
enableAnnotationRegionDrawing()
enableAnnotationRegionDrawing(
lassoMode?,onAfterDraw?):void
Defined in: js-api/src/viewer.ts:769
Parameters
| Parameter | Type |
|---|---|
lassoMode? | boolean |
onAfterDraw? | (region) => void |
Returns
void
fireEvent()
protectedfireEvent(eventId,args?):void
Defined in: js-api/src/u2core/component.ts:413
Parameters
| Parameter | Type |
|---|---|
eventId | string |
args? | unknown |
Returns
void
Inherited from
getDartProperties()
getDartProperties():
any[]
Defined in: js-api/src/widgets/base.ts:289
Returns
any[]
Inherited from
getFunctions()
getFunctions():
Func[]
Defined in: js-api/src/viewer.ts:114
Functions applicable to the underlying Dart viewer.
Returns
Func[]
Inherited from
getInfo()
getInfo():
object
Defined in: js-api/src/viewer.ts:204
Returns
object
Inherited from
getMarkerColor()
getMarkerColor(
rowIdx):number
Defined in: js-api/src/viewer.ts:767
Parameters
| Parameter | Type |
|---|---|
rowIdx | number |
Returns
number
getMarkerColors()
getMarkerColors():
Uint32Array
Defined in: js-api/src/viewer.ts:768
Returns
Uint32Array
getMarkerSize()
getMarkerSize(
rowIdx):number
Defined in: js-api/src/viewer.ts:763
Parameters
| Parameter | Type |
|---|---|
rowIdx | number |
Returns
number
getMarkerSizes()
getMarkerSizes():
Float32Array
Defined in: js-api/src/viewer.ts:764
Returns
Float32Array
getMarkerType()
getMarkerType(
rowIdx):string
Defined in: js-api/src/viewer.ts:765
Parameters
| Parameter | Type |
|---|---|
rowIdx | number |
Returns
string
getMarkerTypes()
getMarkerTypes():
Uint32Array
Defined in: js-api/src/viewer.ts:766
Returns
Uint32Array
getOptions()
getOptions(
includeDefaults?):object
Defined in: js-api/src/viewer.ts:200
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:200 |
look | object | js-api/src/viewer.ts:200 |
type | string | js-api/src/viewer.ts:200 |
Inherited from
getProperties()
getProperties():
Property[]
Defined in: js-api/src/viewer.ts:208
Returns all properties of this widget: the meta-generated ones plus addProperty's.
Returns
Property[]
Inherited from
getRowTooltip()
getRowTooltip(
rowIdx):HTMLDivElement
Defined in: js-api/src/viewer.ts:762
Parameters
| Parameter | Type |
|---|---|
rowIdx | number |
Returns
HTMLDivElement
getWidgetStatus()
getWidgetStatus():
IWidgetStatus
Defined in: js-api/src/viewer.ts:111
Returns the widget's runtime structure for automated testing and introspection.
Returns
Inherited from
hitTest()
hitTest(
x,y):number
Defined in: js-api/src/viewer.ts:732
Row hit test using canvas coords
Parameters
| Parameter | Type |
|---|---|
x | number |
y | number |
Returns
number
initDartObject()
initDartObject(
dart):void
Defined in: js-api/src/viewer.ts:154
Parameters
| Parameter | Type |
|---|---|
dart | any |
Returns
void
Inherited from
invalidateCanvas()
invalidateCanvas():
void
Defined in: js-api/src/viewer.ts:727
Rerender plot
Returns
void
link()
link(
name,source,twoWay):void
Defined in: js-api/src/u2core/component.ts:246
Keeps this component's name step and source equal, echo-suppressed by value; the reverse
direction only where twoWay. A component that took source as its own signal needs no link
and gets none; a read-only step cannot follow anything and gets none either.
Parameters
| Parameter | Type |
|---|---|
name | string |
source | Signal<unknown> |
twoWay | boolean |
Returns
void
Inherited from
onEvent()
onEvent(
eventId?):Observable<any>
Defined in: js-api/src/viewer.ts:405
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:295
Parameters
| Parameter | Type |
|---|---|
dataFrame | DataFrame |
Returns
void
Inherited from
onPropertyChanged()
onPropertyChanged(
property):void
Defined in: js-api/src/widgets/base.ts:287
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:133
Parameters
| Parameter | Type |
|---|---|
dispose | () => void |
Returns
this
Inherited from
pointToScreen()
pointToScreen(
index):Point
Defined in: js-api/src/viewer.ts:759
Parameters
| Parameter | Type |
|---|---|
index | number |
Returns
propertyChanges()
protectedpropertyChanges():ObservableLike<PropertyChange>
Defined in: js-api/src/viewer.ts:216
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:409
Parameters
| Parameter | Type |
|---|---|
f | FuncLike |
Returns
void
Inherited from
removeFromView()
removeFromView():
any
Defined in: js-api/src/viewer.ts:447
Returns
any
Inherited from
render()
render(
g):void
Defined in: js-api/src/viewer.ts:761
Parameters
| Parameter | Type |
|---|---|
g | CanvasRenderingContext2D |
Returns
void
run()
run<
T>(fn):T
Defined in: js-api/src/u2core/component.ts:124
Type Parameters
| Type Parameter |
|---|
T |
Parameters
| Parameter | Type |
|---|---|
fn | () => T |
Returns
T
Inherited from
screenToWorld()
screenToWorld(
x,y):Point
Defined in: js-api/src/viewer.ts:756
Parameters
| Parameter | Type |
|---|---|
x | number |
y | number |
Returns
setOptions()
setOptions(
map):void
Defined in: js-api/src/viewer.ts:188
Sets viewer options. See also getOptions Sample: https://public.datagrok.ai/js/samples/ui/viewers/types/scatter-plot
Parameters
| Parameter | Type | Description |
|---|---|---|
map | {[key: string]: any; type?: string; } | - |
map.type? | string | - |
Returns
void