Skip to main content

Class: Widget<TSettings>

dg.Widget

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

Type parameters

NameType
TSettingsany

Hierarchy

Constructors

constructor

new Widget<TSettings>(widgetRoot)

Constructs

Widget and initializes its root.

Type parameters

NameType
TSettingsany

Parameters

NameType
widgetRootHTMLElement

Defined in

src/widgets.ts:185

Properties

_properties

Protected _properties: Property[]

Defined in

src/widgets.ts:178


_root

Protected _root: HTMLElement

Defined in

src/widgets.ts:177


dart

dart: any

Defined in

src/widgets.ts:181


factory

factory: null | Func = null

Constructor function. No parameters, returns [Widget].

Defined in

src/widgets.ts:175


isDetached

isDetached: boolean = false

Defined in

src/widgets.ts:182


props

props: TSettings & ObjectPropertyBag

Defined in

src/widgets.ts:179


subs

subs: Subscription[]

Defined in

src/widgets.ts:180


temp

temp: any

Contains auxiliary information

Defined in

src/widgets.ts:172

Accessors

root

get root(): HTMLElement

Widget's visual root.

Returns

HTMLElement

Defined in

src/widgets.ts:259

set root(r): void

Parameters

NameType
rHTMLElement

Returns

void

Defined in

src/widgets.ts:260


type

get type(): string

Returns

string

Defined in

src/widgets.ts:169

Methods

addProperty

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

Registers an property with the specified type, name, and defaultValue. Registered property gets added to {@see properties}. Returns default value, thus allowing to combine registering a property with the initialization

Parameters

NameTypeDefault value
propertyNamestringundefined
propertyType"string" | "bigint" | "object" | "map" | "file" | "view" | "element" | "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" | "TableView" | "User" | "Menu" | "Project" | "event_data" | "progressindicator" | "Credentials" | "ScriptEnvironment" | "Notebook"undefined
defaultValueanynull
optionsnull | { [key: string]: any; } & PropertyOptionsnull

Returns

any

Defined in

src/widgets.ts:280


apply

apply(properties): Widget<any>

Parameters

NameType
propertiesobject

Returns

Widget<any>

Defined in

src/widgets.ts:230


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

Defined in

src/widgets.ts:264


getDartProperties

getDartProperties(): any[]

Returns

any[]

Defined in

src/widgets.ts:246


getProperties

getProperties(): Property[]

Returns

Property[]

Defined in

src/widgets.ts:240


onFrameAttached

onFrameAttached(dataFrame): void

Parameters

NameType
dataFrameDataFrame

Returns

void

Defined in

src/widgets.ts:252


onPropertyChanged

onPropertyChanged(property): void

Gets called when viewer's property is changed.

Parameters

NameTypeDescription
propertynull | Propertyor null, if multiple properties were changed.

Returns

void

Defined in

src/widgets.ts:244


sourceRowsChanged

sourceRowsChanged(): void

Returns

void

Defined in

src/widgets.ts:250


sub

sub(subscription): void

Registers a subscription to an external event.

Parameters

NameType
subscriptionSubscription

Returns

void

Defined in

src/widgets.ts:223


toDart

toDart(): any

Returns

any

Defined in

src/widgets.ts:215


find

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

Finds existing widget from its visual root.

Parameters

NameType
rootElement

Returns

null | Widget<any>

Defined in

src/widgets.ts:211


fromRoot

Static fromRoot(root): Widget<any>

Creates a new widget from the root element.

Parameters

NameType
rootHTMLElement

Returns

Widget<any>

Defined in

src/widgets.ts:303


getAll

Static getAll(): Widget<any>[]

Returns all currently active widgets.

Returns

Widget<any>[]

Defined in

src/widgets.ts:206