Configuration

An object defining configuration options for the dxScrollView widget.

direction

A string value specifying the available scrolling directions.

Type: String
Default Value: "vertical"
Accepted Values: 'vertical'|'horizontal'|'both'

Show Example:
jQuery

disabled

A Boolean value specifying whether or not the widget 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 widget at runtime.

Show Example:
jQuery

pullDownAction

An action performed after the widget is scrolled to the top and pulled down.

Type: Action
Default Value: null

Show Example:
jQuery

pulledDownText

Specifies the text shown in the pullDown panel when pulling the content down lowers the refresh threshold.

Type: String
Default Value: "Release to refresh..."

pullingDownText

Specifies the text shown in the pullDown panel while pulling the content down to the refresh threshold.

Type: String
Default Value: "Pull down to refresh..."

reachBottomAction

An action performed after the widget is scrolled to the bottom and pulled up.

Type: Action
Default Value: null

Show Example:
jQuery

reachBottomText

Specifies the text shown in the pullDown panel displayed when content is scrolled to the bottom.

Type: String
Default Value: "Loading..."

refreshingText

Specifies the text shown in the pullDown panel displayed when the content is being refreshed.

Type: String
Default Value: "Refreshing..."

scrollAction

An action performed on each scroll gesture.

Type: Action
Default Value: null

The function passed to this configuration option can take on an object containing the following fields as an argument.

  • scrollOffset - an object containing top and left properties, which specify the current position of the scrolled content against the initial position;
  • reachedLeft - indicates whether the scrolled content is in the leftmost position or not;
  • reachedRight - indicates whether the scrolled content is in the rightmost position or not;
  • reachedTop - indicates whether the scrolled content is in the topmost position or not;
  • reachedBottom - indicates whether the scrolled content is in the bottommost position or not.
Show Example:
jQuery

showScrollBar

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

Type: Boolean
Default Value: true

Show Example:
jQuery

updateAction

An action performed after the widget is updated.

Type: Action
Default Value: null

The function passed to this configuration option can take on an object containing the following fields as an argument.

  • scrollOffset - an object containing top and left properties, which specify the current position of the scrolled content against the initial position
  • reachedLeft - indicates whether the scrolled content is in the leftmost position or not
  • reachedRight - indicates whether the scrolled content is in the rightmost position or not
  • reachedTop - indicates whether the scrolled content is in the topmost position or not
  • reachedBottom - indicates whether the scrolled content is in the bottommost position or not
Show Example:
jQuery

useNative

Indicates whether to use native or simulated scrolling.

Type: Boolean
Default Value: true
Default for android below version 4: false
Default for tizen: false