JavaScript Data GridManualColumnResize

On this page

• Description
• Options
  • manualColumnResize
• Methods
  • clearManualSize
  • destroy
  • disablePlugin
  • enablePlugin
  • isEnabled
  • loadManualColumnWidths
  • saveManualColumnWidths
  • setManualSize
  • updatePlugin

Description

This plugin allows to change columns width. To make columns width persistent the Options#persistentState plugin should be enabled.

The plugin creates additional components to make resizing possibly using user interface:

• handle - the draggable element that sets the desired width of the column.
• guide - the helper guide that shows the desired width as a vertical guide.

Options

manualColumnResize

Source code

manualColumnResize.manualColumnResize : boolean | Array<number>

The manualColumnResize option configures the ManualColumnResize plugin.

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

Setting	Description
true	Enable the ManualColumnResize plugin
false	Disable the ManualColumnResize plugin
An array	- Enable the ManualColumnResize plugin - Set initial widths of individual columns

Read more:

• Column width: Column stretching

Default: undefined
Example

// enable the `manualColumnResize` plugin
manualColumnResize: true,

// enable the `manualColumnResize` plugin
// set the initial width of column 0 to 40 pixels
// set the initial width of column 1 to 50 pixels
// set the initial width of column 2 to 60 pixels
manualColumnResize: [40, 50, 60],

Methods

clearManualSize

Source code

manualColumnResize.clearManualSize(column)

Clears the cache for the specified column index.

Param	Type	Description
column	number	Visual column index.

destroy

Source code

manualColumnResize.destroy()

Destroys the plugin instance.

disablePlugin

Source code

manualColumnResize.disablePlugin()

Disables the plugin functionality for this Handsontable instance.

enablePlugin

Source code

manualColumnResize.enablePlugin()

Enables the plugin functionality for this Handsontable instance.

isEnabled

Source code

manualColumnResize.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 ManualColumnResize#enablePlugin method is called.

loadManualColumnWidths

Source code

manualColumnResize.loadManualColumnWidths() ⇒ Array

Loads the previously saved sizes using the persistentState plugin (the Options#persistentState option has to be enabled).

Emits: Hooks#event:persistentStateLoad

saveManualColumnWidths

Source code

manualColumnResize.saveManualColumnWidths()

Saves the current sizes using the persistentState plugin (the Options#persistentState option has to be enabled).

Emits: Hooks#event:persistentStateSave

setManualSize

Source code

manualColumnResize.setManualSize(column, width) ⇒ number

Sets the new width for specified column index.

Param	Type	Description
column	number	Visual column index.
width	number	Column width (no less than 20px).

Returns: number - Returns new width.

updatePlugin

Source code

manualColumnResize.updatePlugin()

Updates the plugin's state.

This method is executed when updateSettings() is invoked with any of the following configuration options:

• manualColumnResize