Row selection

tip

Install the gridjs-selection plugin if you haven't already. Follow the installation manual.

Example

Add a new column to your table definition and install the plugin. You need to define an id function for your selection plugin. The id function must return a unique string for each row and is called to determine the identifier for each row.

Live Editor

const grid = new Grid({ columns: [ { id: 'myCheckbox', name: 'Select', plugin: { // install the RowSelection plugin component: RowSelection, } }, { name: 'Name', formatter: (cell) => `Name: ${cell}` }, 'Email', ], sort: true, search: true, data: Array(5).fill().map(x => [ faker.name.findName(), faker.internet.email(), ]) });

const grid = new Grid({
  columns: [
      {
        id: 'myCheckbox',
        name: 'Select',
        plugin: {
          // install the RowSelection plugin
          component: RowSelection,
        }
      },
      { 
        name: 'Name',
        formatter: (cell) => `Name: ${cell}`
      },
      'Email',
  ],
  sort: true,
  search: true,
  data: Array(5).fill().map(x => [
    faker.name.findName(),
    faker.internet.email(),
  ])
});

Result

Loading...

note

In the example above, the 3rd cell (which is row.cell(2).data) has been selected as the row identifier which is the "Email" field. Note that the first cell is the checkbox column.

Selected rows

The selection plugin uses a Redux architecture and that means each selection instance has its own unique Store which keeps the list of selected rows.

Live Editor

const grid = new Grid({ columns: [ { id: 'selectRow', name: 'Select', // select all rows by default! data: () => true, plugin: { component: RowSelection } }, { name: 'Name', formatter: (cell) => `Name: ${cell}` }, 'Email', ], sort: true, data: Array(5).fill().map(x => [ faker.name.findName(), faker.internet.email(), ]) }); grid.on('ready', () => { // find the plugin with the give plugin ID const checkboxPlugin = grid.config.plugin.get('selectRow'); // read the selected rows from the plugin's store console.log('selected rows:', checkboxPlugin.props.store.state); })

const grid = new Grid({
  columns: [
      {
        id: 'selectRow',
        name: 'Select',
        // select all rows by default!
        data: () => true, 
        plugin: {
          component: RowSelection
        }
      },
      { 
        name: 'Name',
        formatter: (cell) => `Name: ${cell}`
      },
      'Email',
  ],
  sort: true,
  data: Array(5).fill().map(x => [
    faker.name.findName(),
    faker.internet.email(),
  ])
});
 
grid.on('ready', () => {
  // find the plugin with the give plugin ID
  const checkboxPlugin = grid.config.plugin.get('selectRow');
  // read the selected rows from the plugin's store
  console.log('selected rows:', checkboxPlugin.props.store.state);
})

Result

Loading...

tip

Follow the Advanced Plugin article to learn more about writing Grid.js plugins!