Select Extension

Enable row, column, or cell selection workflows

When To Use

Use Select for row detail workflows or keyboard-assisted data review. For acting on the selection in PHP, declare bulk actions: they configure Select for you and run a handler over the selected rows.

Minimal Example

use Pentiminax\UX\DataTables\Enum\SelectStyle;

$dataTable->select(SelectStyle::SINGLE);

Advanced Example

use Pentiminax\UX\DataTables\Enum\SelectItemType;
use Pentiminax\UX\DataTables\Enum\SelectStyle;

$dataTable->select(
    style: SelectStyle::MULTI,
    blurable: true,
    className: 'selected',
    info: true,
    items: SelectItemType::ROW,
    keys: true,
    selector: 'td, th',
    toggleable: true,
    withCheckbox: true,
    headerCheckbox: true,
);

SelectStyle offers SINGLE, MULTI, OS (desktop-style: click selects, Ctrl/Cmd toggles, Shift selects a range) and MULTI_SHIFT (multi+shift: click toggles, Shift selects a range).

select() covers every option; build the extension yourself with addExtension(new SelectExtension(...)) when you need to hold on to the instance.

Frequent Pitfalls

Enabling checkbox mode without confirming responsive column behavior.
Not handling select/deselect events in custom controllers when needed.

Checkbox mode prepends a client-only column. Server-side order, column search, and Column Control criteria are matched by column name, so they stay aligned with that extra column, and numeric indexes in order() keep referring to the columns you declared.

Cross Links