JavaScript Data Grid 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 then 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's state.
This method is executed when updateSettings() is invoked with any of the following configuration options: