Dialog<Inputs>

A non-modal dialog. Sample: https://public.datagrok.ai/js/samples/ui/dialogs

Example

ui.dialog('Windows')
  .add(ui.)
  .add(ui.span(['People of Earth, your attention, please… ']))
  .onOK(() => { grok.shell.info('OK!'); })
  .show();

Extends

DartWidget

Extended by

Wizard

Type parameters

Type parameter	Value
`Inputs` extends `Record`<`string`, `InputBase`<`any`>>	`object`

Constructors

new Dialog()

new Dialog<Inputs>(dart): Dialog<Inputs>

Parameters

Parameter	Type
`dart`	`any`

Returns

Dialog<Inputs>

Overrides

DartWidget . constructor

Source

src/widgets/forms.ts:31

Properties

Property	Modifier	Type	Default value	Description	Inherited from
`_functions`	`protected`	`Func`[]	`[]`	-	`DartWidget`.`_functions`
`_properties`	`protected`	`Property`[]	`[]`	-	`DartWidget`.`_properties`
`_root`	`protected`	`HTMLElement`	`undefined`	-	`DartWidget`.`_root`
`dart`	`public`	`any`	`undefined`	-	`DartWidget`.`dart`
`factory`	`public`	`null` \| `Func`	`null`	Constructor function. No parameters, returns [Widget].	`DartWidget`.`factory`
`isDetached`	`public`	`boolean`	`false`	-	`DartWidget`.`isDetached`
`props`	`public`	`any`	`undefined`	-	`DartWidget`.`props`
`subs`	`public`	`Subscription`[]	`undefined`	-	`DartWidget`.`subs`
`temp`	`public`	`any`	`undefined`	Contains auxiliary information	`DartWidget`.`temp`

Accessors

children

get children(): Widget<any>[]

Parent widget up the DOM tree, or null.

Returns

Widget<any>[]

Source

src/widgets/base.ts:284

helpUrl

get helpUrl(): string

When provided, adds a "?" icon to the dialog header on the right.

set helpUrl(url): void

Parameters

Parameter	Type
`url`	`string`

Returns

string

Source

src/widgets/forms.ts:44

inputs

get inputs(): InputBase<any>[]

Returns a list of the dialog's inputs.

Returns

InputBase<any>[]

Source

src/widgets/forms.ts:52

namedInputs

get namedInputs(): Inputs

gets typed inputs with captions as keys.

Returns

Inputs

Source

src/widgets/forms.ts:137

onClose

get onClose(): Observable<any>

Returns

Observable<any>

Source

src/widgets/forms.ts:98

parent

get parent(): null | Widget<any>

Parent widget up the DOM tree, or null.

Returns

null | Widget<any>

Source

src/widgets/base.ts:281

root

get root(): HTMLElement

Widget's visual root.

Returns

HTMLElement

Source

src/widgets/base.ts:356

title

get title(): string

Returns the title of a dialog.

set title(t): void

Parameters

Parameter	Type
`t`	`string`

Returns

string

Source

src/widgets/forms.ts:48

type

get type(): string

Returns

string

Source

src/widgets/base.ts:355

Methods

add()

add(content): Dialog<Inputs>

Adds content to the dialog. using addInput() for inputs is preferred, as it provides better type safety.

Parameters

Parameter	Type	Description
`content`	`HTMLElement` \| `Widget`<`any`> \| `InputBase`<`any`>

Returns

Dialog<Inputs>

Source

src/widgets/forms.ts:124

addButton()

addButton(text, action, index, tooltip): Dialog<Inputs>

Adds command button with the specified text.

Parameters

Parameter	Type	Default value
`text`	`string`	`undefined`
`action`	`Function`	`undefined`
`index`	`number`	`0`
`tooltip`	`any`	`null`

Returns

Dialog<Inputs>

Source

src/widgets/forms.ts:166

addContextAction()

addContextAction(text, action): Dialog<Inputs>

Adds context action with the specified text.

Parameters

Parameter	Type	Description
`text`	`string`
`action`	`Function`

Returns

Dialog<Inputs>

Source

src/widgets/forms.ts:176

addInput()

addInput<K, V>(caption, input): Dialog<Record<K, V> & Inputs>

Adds named input, which than can be used in combo with namedInputs, to get inputs in type-safe way

Type parameters

Type parameter
`K` extends `string`
`V` extends `InputBase`<`any`>

Parameters

Parameter	Type
`caption`	`K`
`input`	`V`

Returns

Dialog<Record<K, V> & Inputs>

Source

src/widgets/forms.ts:130

addProperty()

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

Registers an property with the specified type, name, and defaultValue.

Parameters

Parameter	Type	Default value
`propertyName`	`string`	`undefined`
`propertyType`	`"string"` \| `"bigint"` \| `"object"` \| `"map"` \| `"file"` \| `"view"` \| `"blob"` \| `"int"` \| `"double"` \| `"bool"` \| `"byte_array"` \| `"datetime"` \| `"qnum"` \| `"dataframe"` \| `"num"` \| `"string_list"` \| `"dataframe_list"` \| `"cell"` \| `"column"` \| `"column_list"` \| `"graphics"` \| `"tablerowfiltercall"` \| `"colfiltercall"` \| `"bitset"` \| `"dynamic"` \| `"viewer"` \| `"list"` \| `"semantic_value"` \| `"func"` \| `"funccall"` \| `"property"` \| `"categorical"` \| `"numerical"` \| `"GridCellRenderArgs"` \| `"element"` \| `"TableView"` \| `"User"` \| `"Menu"` \| `"Project"` \| `"event_data"` \| `"progressindicator"` \| `"Credentials"` \| `"ScriptEnvironment"` \| `"Notebook"`	`undefined`
`defaultValue`	`any`	`null`
`options`	`null` \| `object` & `IProperty`	`null`

Returns

any

Inherited from

DartWidget . addProperty

See

Registered property gets added to properties. Returns default value, thus allowing to combine registering a property with the initialization

Source

src/widgets/base.ts:309

apply()

apply(properties): Widget<any>

Parameters

Parameter	Type	Description
`properties`	`object`

awaitOnOK()

awaitOnOK<T>(handler): Promise<T>

Sets the OK button handler and returns a promise of the handler callback.

Type parameters

Type parameter	Value
`T`	`any`

Parameters

Parameter	Type	Description
`handler`	() => `Promise`<`T`>

Returns

Promise<T>

Source

src/widgets/forms.ts:76

clear()

clear(): void

Clears the content.

Returns

void

Source

src/widgets/forms.ts:196

close()

close(): void

Closes the dialog.

Returns

void

Source

src/widgets/forms.ts:147

detach()

detach(): void

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

Source

src/widgets/base.ts:293

getButton()

getButton(text): HTMLButtonElement

Returns command button with the specified text.

Parameters

Parameter	Type	Description
`text`	`string`

Returns

HTMLButtonElement

Source

src/widgets/forms.ts:155

getDartProperties()

getDartProperties(): any[]

Returns

any[]

Inherited from

DartWidget . getDartProperties

Source

src/widgets/base.ts:269

getFunctions()

getFunctions(): Func[]

Functions that are applicable to this particular widget. Used in the UI to display context actions, and for the AI integrations.

Returns

Func[]

Inherited from

DartWidget . getFunctions

Source

src/widgets/base.ts:358

getProperties()

getProperties(): Property[]

Returns all properties of this widget.

Returns

Property[]

Inherited from

DartWidget . getProperties

Source

src/widgets/base.ts:357

history()

history(getInput, applyInput): void

Initializes the 'history' feature.

Parameters

Parameter	Type	Description
`getInput`	() => `any`	collects the input from UI into JSON-serializable object
`applyInput`	(`x`) => `void`	refreshes the UI according to input

Returns

void

Source

src/widgets/forms.ts:185

initDefaultHistory()

initDefaultHistory(): Dialog<Inputs>

Initializes default history.

Returns

Dialog<Inputs>

Source

src/widgets/forms.ts:190

initFromLocalStorage()

initFromLocalStorage(): void

Initializes the dialog properties from local storage.

Returns

void

Source

src/widgets/forms.ts:206

input()

input(caption): InputBase<any>

Returns an input with the specified caption, or throws an exception.

Parameters

Parameter	Type
`caption`	`string`

Returns

InputBase<any>

Source

src/widgets/forms.ts:55

onCancel()

onCancel(handler): Dialog<Inputs>

Sets the CANCEL button handler

Parameters

Parameter	Type	Description
`handler`	`Function`

Returns

Dialog<Inputs>

Source

src/widgets/forms.ts:92

onFrameAttached()

onFrameAttached(dataFrame): void

Parameters

Parameter	Type
`dataFrame`	`DataFrame`

Returns

void

Inherited from

DartWidget . onFrameAttached

Source

src/widgets/base.ts:275

onOK()

onOK(handler, options?): Dialog<Inputs>

Sets the OK button handler, and shows the OK button

Parameters

Parameter	Type	Description
`handler`	`Function`
`options`?	`object`
`options.closeOnEnter`?	`boolean`	-

Returns

Dialog<Inputs>

Source

src/widgets/forms.ts:67

onPropertyChanged()

onPropertyChanged(property): void

Gets called when viewer's property is changed.

Parameters

Parameter	Type	Description
`property`	`null` \| `Property`	or null, if multiple properties were changed.

Returns

void

Inherited from

DartWidget . onPropertyChanged

Source

src/widgets/base.ts:267

show()

show(options?): Dialog<Inputs>

Parameters

Parameter	Type	Description
`options`?	`object`
`options.backgroundColor`?	`string`	-
`options.center`?	`boolean`	-
`options.centerAt`?	`Element`	-
`options.fullScreen`?	`boolean`	-
`options.height`?	`number`	-
`options.modal`?	`boolean`	-
`options.resizable`?	`boolean`	-
`options.showNextTo`?	`HTMLElement`	-
`options.width`?	`number`	-
`options.x`?	`number`	-
`options.y`?	`number`	-

Returns

Dialog<Inputs>

Source

src/widgets/forms.ts:109

showModal()

showModal(fullScreen): Dialog<Inputs>

Parameters

Parameter	Type	Description
`fullScreen`	`boolean`

Returns

Dialog<Inputs>

Source

src/widgets/forms.ts:116

sourceRowsChanged()

sourceRowsChanged(): void

Returns

void

Inherited from

DartWidget . sourceRowsChanged

Source

src/widgets/base.ts:273

sub()

sub(subscription): void

Registers a subscription to an external event.

Parameters

Parameter	Type	Description
`subscription`	`Subscription`

Returns

void

Inherited from

DartWidget . sub

Source

src/widgets/base.ts:241

toDart()

toDart(): any

Returns

any

Inherited from

DartWidget . toDart

Source

src/widgets/base.ts:233

create()

static create(options?): Dialog<object>

Creates a new dialog with the specified options.

Parameters

Parameter	Type
`options`?	`string` \| `object`

Returns

Dialog<object>

Source

src/widgets/forms.ts:36

find()

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

Finds existing widget from its visual root.

Parameters

Parameter	Type
`root`	`Element`

Returns

null | Widget<any>

Inherited from

DartWidget . find

Source

src/widgets/base.ts:229

fromRoot()

static fromRoot(root): Widget<any>

Creates a new widget from the root element.

Parameters

Parameter	Type
`root`	`HTMLElement`

Returns

Widget<any>

Inherited from

DartWidget . fromRoot

Source

src/widgets/base.ts:332

getAll()

static getAll(): Widget<any>[]

Returns all currently active widgets.

Returns

Widget<any>[]

Inherited from

DartWidget . getAll

Source

src/widgets/base.ts:224

getOpenDialogs()

static getOpenDialogs(): Dialog<object>[]

Returns currently open dialogs.

Returns

Dialog<object>[]

Source

src/widgets/forms.ts:201

Dialog<Inputs>

Example​

Extends​

Extended by​

Type parameters​

Constructors​

new Dialog()​

Parameters​

Returns​

Overrides​

Source​

Properties​

Accessors​

children​

Returns​

Source​

helpUrl​

Parameters​

Returns​

Source​

inputs​

Returns​

Source​

namedInputs​

Returns​

Source​

onClose​

Returns​

Source​

parent​

Returns​

Source​

root​

Returns​

Source​

title​

Parameters​

Returns​

Source​

type​

Returns​

Source​

Methods​

add()​

Parameters​

Returns​

Source​

addButton()​

Parameters​

Returns​

Source​

addContextAction()​

Parameters​

Returns​

Source​

addInput()​

Type parameters​

Parameters​

Returns​

Source​

addProperty()​

Parameters​

Returns​

Inherited from​

See​

Source​

apply()​

Parameters​

Returns​

Inherited from​

Source​

awaitOnOK()​

Type parameters​

Parameters​

Returns​

Source​

clear()​

Returns​

Source​

close()​

Example

Extends

Extended by

Type parameters

Constructors

new Dialog()

Parameters

Returns

Overrides

Source

Properties

Accessors

children

Returns

Source

helpUrl

Parameters

Returns

Source

inputs

Returns

Source

namedInputs

Returns

Source

onClose

Returns

Source

parent

Returns

Source

root

Returns

Source

title

Parameters

Returns

Source

type

Returns

Source

Methods

add()

Parameters

Returns

Source

addButton()

Parameters

Returns

Source

addContextAction()

Parameters

Returns

Source

addInput()

Type parameters

Parameters

Returns

Source

addProperty()

Parameters

Returns

Inherited from

See

Source

apply()

Parameters

Returns

Inherited from

Source

awaitOnOK()

Type parameters

Parameters

Returns

Source

clear()

Returns

Source

close()

Returns