Class: FieldWidget

(abstract) parasql.widget.FieldWidget

This is the abstract superclass for all field types.
License:
Fires:
  • parasql.Event#event:change When a field's value is changed by the user.

Extends

Methods

addEventListener(type, listener)

Adds an event listener to this widget. This can also be done via the Events... option on the tool bar.
Parameters:
Name Type Description
type string A valid event type.
listener string A string containing either the name of a JavaScript function to call, an inline function to be called, or code that resolves to an object which implements a handleEvent(event) method.
Inherited From:
See:
Examples
// add an inline function as an event listener 
parasql.app.getWidgetById('ID1007').addEventListener('render','function (event) { event.target.getContentDiv().innerHTML = "Inline Hello World"; }');
// add a function call as an event listener
parasql.app.getWidgetById('ID1008').addEventListener('render','renderHelloWidget');
// add an object as an event listener; the object must implement handleEvent(event)
document.myClass = new MyClass();
parasql.app.getWidgetById('ID1009').addEventListener('render','document.myClass');

displayDataValue()

Writes our DataValue to our display element, applying any formatting. Overridden by various subclasses.

focus()

Give focus to the input element of this field.

getDataValue() → (nullable) {parasql.schema.DataValue}

Returns:
The current DataValue for this field, or null if there is no current DataValue.
Type
parasql.schema.DataValue

getIsRequired() → {boolean}

Returns:
Type
boolean

getIsVirtual() → {boolean}

Returns:
Type
boolean

getReadOnly() → {boolean}

Returns:
Returns true if this field will render as a read-only field.
Type
boolean

getWidgetId() → (non-null) {string}

Inherited From:
Returns:
Returns an immutable string that uniquely identifies this widget.
Type
string

isDisabled() → {boolean}

Since:
  • v110
Inherited From:
Returns:
Type
boolean

printWidget()

Causes this widget to print itself.
Inherited From:

redisplay()

Redisplays this widget.
Inherited From:

setDataValue(newValue)

Setting a field's value with this method makes it behave as if it were set by the user (with the exception of validation). The value is copied from the specified newValue, the value is rendered in the UI including any formatting, any dependent fields are recalculated, any Data Links are performed, and finally a "change" event is fired to all listeners.
Parameters:
Name Type Description
newValue parasql.schema.DataValue This field's data value is taken from the specified newValue
Fires:
  • parasql.Event#event:change When a field's value is changed by the user.

setDataValueNull()

Convenience method to set a field value to NULL.

setDisabled(flag)

WARNING: Subclasses overriding this method must not trigger a redisplay (causes an infinite loop).
Parameters:
Name Type Description
flag boolean If true, this widget will be rendered as disabled.
Since:
  • v110
Overrides:

setIsRequired(flag)

Sets whether or not this field will be rendered as a required field.
Parameters:
Name Type Description
flag boolean

setReadOnly(flag)

Sets whether or not this field will be rendered as a read-only field.
Parameters:
Name Type Description
flag boolean