ManualColumnResize

Table of contents

• 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 (opens new window)

manualColumnResize.manualColumnResize : boolean | Array<number>

Turns on Manual column resize, if set to a boolean or define initial column resized widths (an an array of widths).

Default: undefined Example

// as a boolean to enable column resize
manualColumnResize: true,

// as a array with initial widths
// (column at 0 index has 40px and column at 1 index has 50px)
manualColumnResize: [40, 50],

Methods

clearManualSize

Source code (opens new window)

manualColumnResize.clearManualSize(column)

Clears the cache for the specified column index.

Param	Type	Description
column	number	Visual column index.

destroy

Source code (opens new window)

manualColumnResize.destroy()

Destroys the plugin instance.

disablePlugin

Source code (opens new window)

manualColumnResize.disablePlugin()

Disables the plugin functionality for this Handsontable instance.

enablePlugin

Source code (opens new window)

manualColumnResize.enablePlugin()

Enables the plugin functionality for this Handsontable instance.

isEnabled

Source code (opens new window)

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

loadManualColumnWidths

Source code (opens new window)

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 (opens new window)

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 (opens new window)

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 (opens new window)

manualColumnResize.updatePlugin()

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