VisualDbQueryEditor

Defined in: js-api/src/widgets/specialized.ts:352

JS wrapper for the widget implemented in Dart.

Extends

• DartWidget

Constructors

Constructor

new VisualDbQueryEditor(dart): VisualDbQueryEditor

Defined in: js-api/src/widgets/specialized.ts:353

Parameters

Parameter	Type
dart	any

Returns

VisualDbQueryEditor

Overrides

DartWidget.constructor

Properties

Property	Modifier	Type	Default value	Description	Inherited from	Defined in
_functions	protected	Func[]	[]	-	DartWidget._functions	js-api/src/widgets/base.ts:204
_properties	protected	Property[]	[]	-	DartWidget._properties	js-api/src/widgets/base.ts:203
_root	protected	HTMLElement	undefined	-	DartWidget._root	js-api/src/u2core/component.ts:445
_u2	readonly	ComponentState	undefined	-	DartWidget._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.	DartWidget.componentMeta	js-api/src/u2core/component.ts:77
dart	public	any	undefined	-	DartWidget.dart	js-api/src/widgets/base.ts:209
factory	public	Func | null	null	Constructor function. No parameters, returns [Widget].	DartWidget.factory	js-api/src/widgets/base.ts:201
isDetached	public	boolean	false	Whether detach has been called.	DartWidget.isDetached	js-api/src/widgets/base.ts:211
props	public	any	undefined	Property bag over this widget's properties; read and write them by name.	DartWidget.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.	DartWidget.specProps	js-api/src/u2core/component.ts:81
subs	public	Subscription[]	undefined	Subscriptions cancelled when the widget is detached.	DartWidget.subs	js-api/src/widgets/base.ts:208
temp	public	any	undefined	Contains auxiliary information	DartWidget.temp	js-api/src/widgets/base.ts:198

Accessors

aggregateTag

Get Signature

get aggregateTag(): TagEditor

Defined in: js-api/src/widgets/specialized.ts:397

Returns

TagEditor

---

aiDescription

Get Signature

get aiDescription(): string | null

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

AI briefing of the underlying Dart widget.

Returns

string | null

Set Signature

set aiDescription(x): void

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

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

Parameters

Parameter	Type
x	string | null

Returns

void

Inherited from

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

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

DartWidget.children

---

grid

Get Signature

get grid(): Grid

Defined in: js-api/src/widgets/specialized.ts:365

Returns

Grid

---

groupByTag

Get Signature

get groupByTag(): TagEditor

Defined in: js-api/src/widgets/specialized.ts:393

Returns

TagEditor

---

havingTag

Get Signature

get havingTag(): TagEditor

Defined in: js-api/src/widgets/specialized.ts:381

Returns

TagEditor

---

inputSchemas

Get Signature

get inputSchemas(): object

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

Returns

object

---

mainTag

Get Signature

get mainTag(): TagEditor

Defined in: js-api/src/widgets/specialized.ts:401

Returns

TagEditor

---

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

DartWidget.name

---

onChanged

Get Signature

get onChanged(): Observable<any>

Defined in: js-api/src/widgets/specialized.ts:421

Returns

Observable<any>

---

orderTag

Get Signature

get orderTag(): TagEditor

Defined in: js-api/src/widgets/specialized.ts:385

Returns

TagEditor

---

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

DartWidget.parent

---

pivotTag

Get Signature

get pivotTag(): TagEditor

Defined in: js-api/src/widgets/specialized.ts:377

Returns

TagEditor

---

propertyTarget

Get Signature

get propertyTarget(): unknown

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

What this component's properties are read from and written to — prop.get(target) / prop.set(target, v): the component itself, unless an adoption says otherwise.

Returns

unknown

Inherited from

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

DartWidget.propertyTier

---

query

Get Signature

get query(): TableQuery

Defined in: js-api/src/widgets/specialized.ts:369

Returns

TableQuery

---

root

Get Signature

get root(): HTMLElement

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

Returns

HTMLElement

Inherited from

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

DartWidget.scope

---

showAddToWorkspaceBtn

Set Signature

set showAddToWorkspaceBtn(show): void

Defined in: js-api/src/widgets/specialized.ts:423

Parameters

Parameter	Type
show	boolean

Returns

void

---

type

Get Signature

get type(): string

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

Returns

string

Inherited from

DartWidget.type

---

whereTag

Get Signature

get whereTag(): TagEditor

Defined in: js-api/src/widgets/specialized.ts:389

Returns

TagEditor

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

DartWidget._notifyPropertyChange

---

_ownPropertyChanges()

protected _ownPropertyChanges(): ObservableLike<PropertyChange>

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

Returns

ObservableLike<PropertyChange>

Inherited from

DartWidget._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

DartWidget._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

DartWidget._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

DartWidget._wireJsLifecycle

---

_wireLifecycle()

protected _wireLifecycle(): void

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

Returns

void

Inherited from

DartWidget._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

DartWidget.addProperty

---

apply()

apply(properties): Widget

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

Parameters

Parameter	Type
properties	object

Returns

Widget

Inherited from

DartWidget.apply

---

bindProps()

bindProps(): BindProp[]

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

The signal-backed subset of the meta props — what a binding picker offers on a named node — plus, under propertyTier, every declared property. Allocates no signal.

Returns

BindProp[]

Inherited from

DartWidget.bindProps

---

bindStep()

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

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

One binding step (DD5): a meta-declared prop's same-named Signal member — a named node is a bind source, generated off componentMeta the way getProperties is — then, under propertyTier, a cached signal over the declared property. '' answers the default binding: the component's own value signal, where one exists.

Parameters

Parameter	Type
name	string

Returns

BindSource | Signal<unknown> | null

Inherited from

DartWidget.bindStep

---

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

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

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

DartWidget.dispose

---

effect()

effect(fn): this

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

Parameters

Parameter	Type
fn	() => void

Returns

this

Inherited from

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

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

DartWidget.getDartProperties

---

getFunctions()

getFunctions(): Func[]

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

Functions applicable to the Dart widget, as the context menu and the AI assistant see them.

Returns

Func[]

Inherited from

DartWidget.getFunctions

---

getProperties()

getProperties(): Property[]

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

Returns all properties of this widget: the meta-generated ones plus addProperty's.

Returns

Property[]

Inherited from

DartWidget.getProperties

---

getTableInfoByName()

getTableInfoByName(name): TableInfo

Defined in: js-api/src/widgets/specialized.ts:409

Parameters

Parameter	Type
name	string

Returns

TableInfo

---

getTableInfoName()

getTableInfoName(table): string

Defined in: js-api/src/widgets/specialized.ts:405

Parameters

Parameter	Type
table	TableInfo

Returns

string

---

getWidgetStatus()

getWidgetStatus(): IWidgetStatus

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

Runtime snapshot of the Dart widget: named parts, hit areas, shortcuts, events, a state description and the validation error.

Returns

IWidgetStatus

Inherited from

DartWidget.getWidgetStatus

---

isInit()

isInit(): Promise<void>

Defined in: js-api/src/widgets/specialized.ts:417

Returns

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

DartWidget.link

---

onEvent()

onEvent(eventId?): Observable<any>

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

Observes events with the specified eventId. Override in subclasses to provide actual events.

Parameters

Parameter	Type	Default value
eventId	string | null	null

Returns

Observable<any>

Inherited from

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

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

DartWidget.onPropertyChanged

---

own()

own(dispose): this

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

Parameters

Parameter	Type
dispose	() => void

Returns

this

Inherited from

DartWidget.own

---

propertyChanges()

protected propertyChanges(): ObservableLike<PropertyChange>

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

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

Returns

ObservableLike<PropertyChange>

Inherited from

DartWidget.propertyChanges

---

refreshQuery()

refreshQuery(): void

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

Returns

void

---

registerFunction()

protected registerFunction(f): void

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

Parameters

Parameter	Type
f	FuncLike

Returns

void

Inherited from

DartWidget.registerFunction

---

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

DartWidget.runInScope

---

setSingleColumnMode()

setSingleColumnMode(column): Promise<void>

Defined in: js-api/src/widgets/specialized.ts:427

Parameters

Parameter	Type
column	string

Returns

Promise<void>

---

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

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

DartWidget.sub

---

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

DartWidget.toDart

---

build()

static build(builder): Control

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

Builds a control out of plain elements: builder runs with the new control's scope ambient, so signal bindings and nested components inside it are owned by the result. The ambient scope only spans the synchronous part of builder — components constructed after an await inside it are adopted by nobody and must be disposed by hand, or constructed before the first await.

Parameters

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

Returns

Control

Inherited from

DartWidget.build

---

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

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

DartWidget.forElement

---

fromDbTable()

static fromDbTable(table): VisualDbQueryEditor

Defined in: js-api/src/widgets/specialized.ts:357

Parameters

Parameter	Type
table	TableInfo

Returns

VisualDbQueryEditor

---

fromQuery()

static fromQuery(query): VisualDbQueryEditor

Defined in: js-api/src/widgets/specialized.ts:361

Parameters

Parameter	Type
query	TableQuery

Returns

VisualDbQueryEditor

---

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

DartWidget.fromRoot

---

getAll()

static getAll(): Widget<any>[]

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

Returns all currently active widgets.

Returns

Widget<any>[]

Inherited from

DartWidget.getAll

---

init()

static init(self, scope?): void

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

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

Parameters

Parameter	Type
self	Component
scope?	Scope

Returns

void

Inherited from

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

DartWidget.is

---

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

DartWidget.registerCleanup

---

sameValue()

static sameValue(a, b): boolean

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

The equality the property tier and link suppress echoes by: Object.is, arrays element-wise, plain objects key-wise (recursive), everything else by identity.

Parameters

Parameter	Type
a	unknown
b	unknown

Returns

boolean

Inherited from

DartWidget.sameValue