Skip to main content

Sketcher

Molecule sketcher that supports multiple dynamically initialized implementations.

Extends

Constructors

new Sketcher()

new Sketcher(mode?, validationFunc?): Sketcher

Parameters

ParameterType
mode?SKETCHER_MODE
validationFunc?(s) => null | string

Returns

Sketcher

Overrides

Widget . constructor

Source

src/chem.ts:333

Properties

PropertyModifierTypeDefault valueDescriptionInherited from
_alignpublicbooleantrue--
_autoResizedpublicbooleantrue--
_highlightpublicbooleantrue--
_isSubstructureFilterpublicbooleanfalse--
_modepublicSKETCHER_MODESKETCHER_MODE.INPLACE--
_molfilepublicnull | stringnull--
_propertiesprotectedProperty[]undefined-Widget._properties
_rootprotectedHTMLElementundefined-Widget._root
_sketcherTypeChangedpublicbooleanfalse--
_smartspublicnull | stringnull--
_smilespublicnull | stringnull--
_validationFuncpublic(molecule: string) => null | string...--
alighInputpublicInputBase<any>undefined--
changedSubpublicnull | Subscriptionnull--
clearSketcherButtonpublicHTMLButtonElementundefined--
dartpublicanyundefined-Widget.dart
emptySketcherLinkpublicHTMLDivElementundefined--
errorpublicnull | stringnull--
errorDivpublicHTMLDivElement...--
extSketcherCanvaspublicHTMLCanvasElement...--
extSketcherDivpublicHTMLDivElement...--
factorypublicnull | FuncnullConstructor function. No parameters, returns [Widget].Widget.factory
filterOptionsDivpublicHTMLDivElement...--
highlightInputpublicInputBase<any>undefined--
hostpublicHTMLDivElement...--
inplaceSketcherDivpublicnull | HTMLDivElementnull--
invalidMoleculeWarningpublicHTMLDivElement...--
isDetachedpublicbooleanfalse-Widget.isDetached
listenerspublicFunction[][]--
loaderpublicHTMLDivElement...--
molFileUnitspublicNotationNotation.MolBlock--
molInputpublicHTMLInputElement...--
onAlignedChangedpublicSubject<boolean>...--
onChangedpublicSubject<any>...--
onHighlightChangedpublicSubject<boolean>...--
propspublicanyundefined-Widget.props
resizedpublicbooleanfalse--
sketcherpublicnull | SketcherBasenull--
sketcherDialogOpenedpublicbooleanfalse--
sketcherFunctionspublicFunc[][]--
subspublicSubscription[]undefined-Widget.subs
syncCurrentObjectpublicbooleantrueWhether the currently drawn molecule becomes the current object as you sketch it-
temppublicanyundefinedContains auxiliary informationWidget.temp
FAVORITES_KEYreadonly"chem-molecule-favorites"'chem-molecule-favorites'--
RECENT_KEYreadonly"chem-molecule-recent"'chem-molecule-recent'--

Accessors

align

get align(): boolean

set align(value): void

Parameters

ParameterType
valueboolean

Returns

boolean

Source

src/chem.ts:215


autoResized

get autoResized(): boolean

Returns

boolean

Source

src/chem.ts:187


calculating

get calculating(): boolean

set calculating(value): void

Parameters

ParameterType
valueboolean

Returns

boolean

Source

src/chem.ts:195


filterOptions

get filterOptions(): HTMLElement

Returns

HTMLElement

Source

src/chem.ts:219


height

get height(): number

Returns

number

Source

src/chem.ts:179


highlight

get highlight(): boolean

set highlight(value): void

Parameters

ParameterType
valueboolean

Returns

boolean

Source

src/chem.ts:217


isResizing

get isResizing(): boolean

Returns

boolean

Source

src/chem.ts:183


isSubstructureFilter

get isSubstructureFilter(): boolean

set isSubstructureFilter(value): void

Parameters

ParameterType
valueboolean

Returns

boolean

Source

src/chem.ts:206


root

get root(): HTMLElement

Widget's visual root.

set root(r): void

Parameters

ParameterType
rHTMLElement

Returns

HTMLElement

Source

src/widgets.ts:291


sketcherType

set sketcherType(type): void

Parameters

ParameterType
typestring

Source

src/chem.ts:171


sketcherTypeChanged

get sketcherTypeChanged(): boolean

Returns

boolean

Source

src/chem.ts:191


supportedExportFormats

get supportedExportFormats(): string[]

Returns

string[]

Source

src/chem.ts:274


type

get type(): string

Returns

string

Source

src/widgets.ts:201


width

get width(): number

Returns

number

Source

src/chem.ts:175

Methods

_setSketcherSize()

private _setSketcherSize(): void

Returns

void

Source

src/chem.ts:611


_setSketcherType()

private _setSketcherType(sketcherType): void

Parameters

ParameterType
sketcherTypestring

Returns

void

Source

src/chem.ts:573


addProperty()

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

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

Parameters

ParameterTypeDefault valueDescription
propertyNamestringundefined
propertyType"string" | "bigint" | "object" | "map" | "file" | "view" | "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
defaultValueanynull
optionsnull | object & PropertyOptionsnull

Returns

any

Inherited from

Widget . addProperty

See

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

Source

src/widgets.ts:312


apply()

apply(properties): Widget<any>

Parameters

ParameterTypeDescription
propertiesobject

Returns

Widget<any>

Inherited from

Widget . apply

Source

src/widgets.ts:262


createAlignHighlightInputs()

createAlignHighlightInputs(key, inputName, callback): InputBase<boolean>

Parameters

ParameterType
keystring
inputNamestring
callback() => void

Returns

InputBase<boolean>

Source

src/chem.ts:357


createClearSketcherButton()

createClearSketcherButton(canvas): HTMLButtonElement

Parameters

ParameterType
canvasHTMLCanvasElement

Returns

HTMLButtonElement

Source

src/chem.ts:426


createExternalModeSketcher()

createExternalModeSketcher(): HTMLElement

Returns

HTMLElement

Source

src/chem.ts:449


createInplaceModeSketcher()

createInplaceModeSketcher(): HTMLElement

Returns

HTMLElement

Source

src/chem.ts:492


createMoleculeTooltip()

createMoleculeTooltip(currentMolfile): HTMLElement

Parameters

ParameterType
currentMolfilestring

Returns

HTMLElement

Source

src/chem.ts:406


createSketcher()

createSketcher(): void

Returns

void

Source

src/chem.ts:375


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

Overrides

Widget . detach

Source

src/chem.ts:646


drawToCanvas()

drawToCanvas(w, h, molecule): HTMLElement

Parameters

ParameterType
wnumber
hnumber
moleculestring

Returns

HTMLElement

Source

src/chem.ts:652


getDartProperties()

getDartProperties(): any[]

Returns

any[]

Inherited from

Widget . getDartProperties

Source

src/widgets.ts:278


getMolFile()

getMolFile(): string

Returns

string

Source

src/chem.ts:236


getProperties()

getProperties(): Property[]

Returns

Property[]

Inherited from

Widget . getProperties

Source

src/widgets.ts:272


getSmarts()

getSmarts(): Promise<null | string>

Returns

Promise<null | string>

Source

src/chem.ts:259


getSmiles()

getSmiles(): string

Returns

string

Source

src/chem.ts:221


isEmpty()

isEmpty(): boolean

Returns

boolean

Source

src/chem.ts:278


onFrameAttached()

onFrameAttached(dataFrame): void

Parameters

ParameterType
dataFrameDataFrame

Returns

void

Inherited from

Widget . onFrameAttached

Source

src/widgets.ts:284


onPropertyChanged()

onPropertyChanged(property): void

Gets called when viewer's property is changed.

Parameters

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

Returns

void

Inherited from

Widget . onPropertyChanged

Source

src/widgets.ts:276


resize()

resize(): void

Returns

void

Source

src/chem.ts:368


setChangeListenerCallback()

setChangeListenerCallback(callback): void

Parameters

ParameterType
callback() => void

Returns

void

Source

src/chem.ts:294


setExternalModeForSubstrFilter()

setExternalModeForSubstrFilter(): void

In case sketcher is opened in filter panel use EXTERNAL mode

Returns

void

Source

src/chem.ts:363


setMolFile()

setMolFile(x): void

Parameters

ParameterType
xstring

Returns

void

Source

src/chem.ts:248


setMolecule()

setMolecule(molString, substructure): void

Sets the molecule, supports either SMILES, SMARTS or MOLBLOCK formats

Parameters

ParameterTypeDefault value
molStringstringundefined
substructurebooleanfalse

Returns

void

Source

src/chem.ts:284


setSmarts()

setSmarts(x): void

Parameters

ParameterType
xstring

Returns

void

Source

src/chem.ts:265


setSmiles()

setSmiles(x): void

Parameters

ParameterType
xstring

Returns

void

Source

src/chem.ts:227


setValue()

setValue(x): void

Sets SMILES, MOLBLOCK, or any other molecule representation

Parameters

ParameterType
xstring

Returns

void

Source

src/chem.ts:302


sourceRowsChanged()

sourceRowsChanged(): void

Returns

void

Inherited from

Widget . sourceRowsChanged

Source

src/widgets.ts:282


sub()

sub(subscription): void

Registers a subscription to an external event.

Parameters

ParameterTypeDescription
subscriptionSubscription

Returns

void

Inherited from

Widget . sub

Source

src/widgets.ts:255


toDart()

toDart(): any

Returns

any

Inherited from

Widget . toDart

Source

src/widgets.ts:247


updateExtSketcherContent()

updateExtSketcherContent(): void

Returns

void

Source

src/chem.ts:384


updateInvalidMoleculeWarning()

updateInvalidMoleculeWarning(): void

Returns

void

Source

src/chem.ts:442


validate()

validate(x): void

Parameters

ParameterType
xstring

Returns

void

Source

src/chem.ts:326


addToCollection()

static addToCollection(key, molecule): void

Parameters

ParameterType
keystring
moleculestring

Returns

void

Source

src/chem.ts:623


checkDuplicatesAndAddToStorage()

static checkDuplicatesAndAddToStorage(storage, molecule, localStorageKey): void

Parameters

ParameterType
storagestring[]
moleculestring
localStorageKeystring

Returns

void

Source

src/chem.ts:628


find()

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

Finds existing widget from its visual root.

Parameters

ParameterType
rootElement

Returns

null | Widget<any>

Inherited from

Widget . find

Source

src/widgets.ts:243


fromRoot()

static fromRoot(root): Widget<any>

Creates a new widget from the root element.

Parameters

ParameterType
rootHTMLElement

Returns

Widget<any>

Inherited from

Widget . fromRoot

Source

src/widgets.ts:335


getAll()

static getAll(): Widget<any>[]

Returns all currently active widgets.

Returns

Widget<any>[]

Inherited from

Widget . getAll

Source

src/widgets.ts:238


getCollection()

static getCollection(key): string[]

Parameters

ParameterType
keystring

Returns

string[]

Source

src/chem.ts:619


isEmptyMolfile()

static isEmptyMolfile(molFile): boolean

Parameters

ParameterType
molFilestring

Returns

boolean

Source

src/chem.ts:638