select.style()
Get / set the style by which the end user can select items in the table.
Please note - this property requires the Select extension for DataTables.
Description
Select has four different modes of operation for end user selection of items in the table:
api
- Selection can only be performed via the API - this means that selection is disabled unless you use the APIsingle
- Only a single item can be selected, any other selected items will be automatically deselected when a new item is selectedmulti
- Multiple items can be selected. Selection is performed by simply clicking on the items to be selectedos
- Operating System (OS) style selection. This is the most comprehensive option and provides complex behaviours such as ctrl/cmd clicking to select / deselect individual items, shift clicking to select ranges and an unmodified click to select a single item.
Each of these options can be used with the three table items that can be selected (select.items()
).
Types
select.style()
Get the current selection style applied to the table.
Returns:
string
The current selection style, this will be one of api
, single
, multi
or os
.
Note that if multiple tables are defined in the API's context, only the selection style of the first table will be returned.
select.style( set )
Set the table's selection style.
Parameters:
Name | Type | Optional | |
---|---|---|---|
1 | set | No | |
Selection style to set - this must be one of |
Returns:
DataTables.Api
DataTables API instance for chaining.
Example
Let the user select items using the os selection style:
var table = new DataTable('#myTable');
table.select.style('os');
Related
The following options are directly related and may also be useful in your application development.