Configuration

An object defining configuration options for the dxLookup widget.

activeStateEnabled

A Boolean value specifying whether or not the widget changes its state when interacting with a user.

Type: Boolean
Default Value: true

This option is used when the widget is displayed on a platform whose guidelines include the active state change for widgets.

Show Example:
jQuery

clickAction

An action performed when the widget is clicked.

Type: Action
Default Value: null

Show Example:
jQuery

dataSource

A data source used to fetch the lookup data.

Type: Object
Default Value: null

The default template of a data source item object may contain the following fields.

  • html - specifies html code inserted into the item element
  • text - specifies text inserted into the item element

Refer to the Data-Bound Application tutorial for more information.

Show Example:
jQuery

disabled

A Boolean value specifying whether or not a component can respond to user interaction.

Type: Boolean
Default Value: false

Create an observable variable and assign it to this option to specify the availability of the component at runtime.

Show Example:
jQuery

displayExpr

Specifies the name of the data source item field whose value is displayed by the widget.

Type: String
Default Value: "this"

If the Lookup item is a simple object holding a value (string, numeric, Boolean, etc.), assign 'this' to the displayExpr option. If the item is a plain object item, assign the required field name or path to the option.

Show Example:
jQuery

displayValue

Returns the value currently displayed by the widget.

Type: String
Default Value: undefined

The value you pass to this option does not affect widget behavior. Pass an observable variable to this option to get the value currently displayed by the widget.

Show Example:
jQuery

fullScreen

A Boolean value specifying whether or not to display the lookup in full-screen mode.

Type: Boolean
Default Value: false

height

Specifies the height of the widget.

Type: Number|String|function
Default Value: undefined

The option can hold a value of the following types:

  • numeric - the height of the widget in pixels;
  • string - a CSS measurement of the widget height (e.g., "55px", "80%", "auto" and "inherit");
  • function - a function returning the widget height (e.g., height:function(){ return baseHeight - 10 + "%"; }).

minFilterLength

The minimum number of characters that must be entered into the search box to start a search.

Type: Number
Default Value: 0

placeholder

The text displayed by the widget when nothing is selected.

Type: String
Default Value: "Select..."

searchEnabled

A Boolean value specifying whether or not the search bar is visible.

Type: Boolean
Default Value: true

searchTimeout

Specifies the time delay, in milliseconds, after the last character has been typed in, before a search is executed.

Type: Number
Default Value: 1000

title

The title of the lookup window.

Type: String
Default Value: ""

Show Example:
jQuery

value

The currently selected value in the widget.

Type: Object
Default Value: undefined

This option returns a value of the specified field of the currently selected item object. The field whose value is returned by the value option is specified via the valueExpr option.

Show Example:
jQuery

valueChangeAction

An action performed after the value of the widget has been changed.

Type: Action
Default Value: null

Show Example:
jQuery

valueExpr

Specifies the name of a data source item field whose value is held in the value configuration option.

Type: String
Default Value: null

Show Example:
jQuery

visible

A Boolean value specifying whether or not the widget is visible.

Type: Boolean
Default Value: true

width

Specifies the width of the widget.

Type: Number|String|function
Default Value: undefined

The option can hold a value of the following types:

  • numeric - the widget width in pixels;
  • string - a CSS measurement of the widget width (e.g., "55px", "80%", "auto" and "inherit");
  • function - the function returning the widget width (e.g., width:function(){ return baseWidth - 10 + "%"; }).