Column menu

Display a configurable dropdown menu, triggered by clicking on a button in a column header.

Overview

The DropdownMenu plugin enables you to add a configurable dropdown menu to the table’s column headers. The dropdown menu acts like the context menu but is triggered by clicking the button in the header.

Quick setup

To enable the plugin, set the dropdownMenu configuration option to true when initializing Handsontable.

1
import Handsontable from 'handsontable/base';
2
import { registerAllModules } from 'handsontable/registry';
3

4
// Register all Handsontable's modules.
5
registerAllModules();
6

7
const container = document.querySelector('#example1');
8

9
new Handsontable(container, {
10
  data: [
11
    ['A1', 'B1', 'C1', 'D1', 'E1', 'F1', 'G1'],
12
    ['A2', 'B2', 'C2', 'D2', 'E2', 'F2', 'G2'],
13
    ['A3', 'B3', 'C3', 'D3', 'E3', 'F3', 'G3'],
14
  ],
15
  colHeaders: true,
16
  dropdownMenu: true,
17
  height: 'auto',
18
  autoWrapRow: true,
19
  autoWrapCol: true,
20
  licenseKey: 'non-commercial-and-evaluation',
21
});

1
import Handsontable from 'handsontable/base';
2
import { registerAllModules } from 'handsontable/registry';
3

4
// Register all Handsontable's modules.
5
registerAllModules();
6

7
const container = document.querySelector('#example1')!;
8

9
new Handsontable(container, {
10
  data: [
11
    ['A1', 'B1', 'C1', 'D1', 'E1', 'F1', 'G1'],
12
    ['A2', 'B2', 'C2', 'D2', 'E2', 'F2', 'G2'],
13
    ['A3', 'B3', 'C3', 'D3', 'E3', 'F3', 'G3'],
14
  ],
15
  colHeaders: true,
16
  dropdownMenu: true,
17
  height: 'auto',
18
  autoWrapRow: true,
19
  autoWrapCol: true,
20
  licenseKey: 'non-commercial-and-evaluation',
21
});

Plugin configuration

To use the default dropdown contents, set it to true, or to customize it by setting it to use a custom list of actions. For the available entry options reference, see the Context Menu demo.

1
import Handsontable from 'handsontable/base';
2
import { registerAllModules } from 'handsontable/registry';
3

4
// Register all Handsontable's modules.
5
registerAllModules();
6

7
const container = document.querySelector('#example2');
8

9
new Handsontable(container, {
10
  data: [
11
    ['A1', 'B1', 'C1', 'D1', 'E1', 'F1', 'G1'],
12
    ['A2', 'B2', 'C2', 'D2', 'E2', 'F2', 'G2'],
13
    ['A3', 'B3', 'C3', 'D3', 'E3', 'F3', 'G3'],
14
  ],
15
  colHeaders: true,
16
  licenseKey: 'non-commercial-and-evaluation',
17
  height: 'auto',
18
  dropdownMenu: ['remove_col', '---------', 'make_read_only', '---------', 'alignment'],
19
  autoWrapRow: true,
20
  autoWrapCol: true,
21
});

1
import Handsontable from 'handsontable/base';
2
import { registerAllModules } from 'handsontable/registry';
3

4
// Register all Handsontable's modules.
5
registerAllModules();
6

7
const container = document.querySelector('#example2')!;
8

9
new Handsontable(container, {
10
  data: [
11
    ['A1', 'B1', 'C1', 'D1', 'E1', 'F1', 'G1'],
12
    ['A2', 'B2', 'C2', 'D2', 'E2', 'F2', 'G2'],
13
    ['A3', 'B3', 'C3', 'D3', 'E3', 'F3', 'G3'],
14
  ],
15
  colHeaders: true,
16
  licenseKey: 'non-commercial-and-evaluation',
17
  height: 'auto',
18
  dropdownMenu: ['remove_col', '---------', 'make_read_only', '---------', 'alignment'],
19
  autoWrapRow: true,
20
  autoWrapCol: true,
21
});

Windows	macOS	Action	Excel	Sheets
`Shift`+`Alt`+`↓`	`Shift`+`Option`+`↓`	Open the column menu. Works in any cell, if the respective column header displays the menu button.	✗	✗
`Shift`+`Enter`	`Shift`+`Enter`	Open the column menu. Works only when you’re selecting a column header that displays the column menu button.	✗	✗