This page covers a next version of Handsontable, and is not published yet.

This page covers a non-latest version of Handsontable.

# DragToScroll

# Description

Plugin used to scroll Handsontable by selecting a cell and dragging outside of the visible viewport.

# Options

# dragToScroll

Source code (opens new window)

dragToScroll.dragToScroll : boolean

The dragToScroll option configures the DragToScroll plugin.

You can set the dragToScroll option to one of the following:

Setting Description
true (default) When selection reaches the edge of the grid's viewport, scroll the viewport
false Don't scroll the viewport

Read more:

Default: true Example

// when selection reaches the edge of the grid's viewport, scroll the viewport
dragToScroll: true,

# Members

# boundaries

Source code (opens new window)

dragToScroll.boundaries : DOMRect

Size of an element and its position relative to the viewport, e.g. {bottom: 449, height: 441, left: 8, right: 814, top: 8, width: 806, x: 8, y:8}.

# Methods

# check

Source code (opens new window)

dragToScroll.check(x, y)

Checks if the mouse position (X, Y) is outside of the viewport and fires a callback with calculated X an Y diffs between passed boundaries.

Param Type Description
x number Mouse X coordinate to check.
y number Mouse Y coordinate to check.

# destroy

Source code (opens new window)

dragToScroll.destroy()

Destroys the plugin instance.

# disablePlugin

Source code (opens new window)

dragToScroll.disablePlugin()

Disables the plugin functionality for this Handsontable instance.

# enablePlugin

Source code (opens new window)

dragToScroll.enablePlugin()

Enables the plugin functionality for this Handsontable instance.

# isEnabled

Source code (opens new window)

dragToScroll.isEnabled() ⇒ boolean

Checks if the plugin is enabled in the handsontable settings. This method is executed in Hooks#beforeInit hook and if it returns true than the DragToScroll#enablePlugin method is called.

# setBoundaries

Source code (opens new window)

dragToScroll.setBoundaries(boundaries)

Sets the value of the visible element.

Param Type Description
boundaries DOMRect An object with coordinates compatible with DOMRect.

# setCallback

Source code (opens new window)

dragToScroll.setCallback(callback)

Changes callback function.

Param Type Description
callback function The callback function.

# updatePlugin

Source code (opens new window)

dragToScroll.updatePlugin()

Updates the plugin state. This method is executed when Core#updateSettings is invoked.

Last Updated: Apr 12, 2024