class Atk4\Ui\Grid

If you didn’t read documentation on Table you should start with that. While table implements the actual data rendering, Grid component supplies various enhancements around it, such as paginator, quick-search, toolbar and others by relying on other components.

Using Grid

Here is a simple usage:

Grid::addTo($app)->setModel(new Country($db));

To make your grid look nicer, you might want to add some buttons and enable quicksearch:

$grid = Grid::addTo($app);
$grid->setModel(new Country($db));

$grid->menu->addItem('Reload Grid', new \Atk4\Ui\Js\JsReload($grid));

Adding Menu Items

property Atk4\Ui\Grid::$menu

Grid top-bar which contains QuickSearch is implemented using Fomantic-UI “ui menu”. With that you can add additional items and use all features of a regular Menu:

$sub = $grid->menu->addMenu('Drop-down');

For compatibility grid supports addition of the buttons to the menu, but there are several Fomantic-UI limitations that wouldn’t allow to format buttons nicely:


If you don’t need menu, you can disable menu bar entirely:

$grid = Grid::addTo($app, ['menu' => false]);


property Atk4\Ui\Grid::$paginator
property Atk4\Ui\Grid::$ipp

Grid comes with a paginator already. You can disable it by setting $paginator property to false. Alternatively you can provide seed for the paginator or even entire object:

$grid = Grid::addTo($app, ['paginator' => ['range' => 2]]);

You can use $ipp property to specify different number of items per page:

$grid->ipp = 10;


Atk4\Ui\Grid::addJsPaginator($ipp, $options = [], $container = null, $scrollRegion = 'Body')

JsPaginator will load table content dynamically when user scroll down the table window on screen.


See Table::addJsPaginator

Atk4\Ui\Grid::addJsPaginatorInContainer($ipp, $containerHeight, $options = [], $container = null, $scrollRegion = 'Body')

Use this method if you want fixed table header when scrolling down table. In this case you have to set fixed height of your table container.


property Atk4\Ui\Grid::$actions
Atk4\Ui\Grid::addActionButton($button, $action, $confirm = false)

Table supports use of Table\Column\Actions, which allows to display button for each row. Calling addActionButton() provides a useful short-cut for creating column-based actions.

$button can be either a string (for a button label) or something like ['icon' => 'book'].

If $confirm is set to true, then user will see a confirmation when he clicks on the action (yes/no).

Calling this method multiple times will add button into same action column.

See Table\Column\Actions::addAction

Atk4\Ui\Grid::addModalAction($button, $title, $callback)

Similar to addAction, but when clicking a button, will open a modal dialog and execute $callback to populate a content:

$grid->addModalAction('Details', 'Additional Details', function (View $p, $id) use ($grid) {
    // $id of the record which was clicked
    // $model = $grid->model->load($id);


Calling this method multiple times will add button into same action column.

See Table\Column\Actions::addModal

Column Menus

Atk4\Ui\Grid::addDropdown($columnName, $items, $fx, $icon = 'caret square down', $menuId = null)
Atk4\Ui\Grid::addPopup($columnName, $popup = null, $icon = 'caret square down')

Methods addDropdown and addPopup provide a wrapper for Table\Column::addDropdown and Table\Column::addPopup methods.


Grid can have a checkbox column for you to select elements. It relies on Table\Column\Checkbox, but will additionally place this column before any other column inside a grid. You can use Table\Column\Checkbox::jsChecked() method to reference value of selected checkboxes inside any Actions:

$sel = $grid->addSelection();
$grid->menu->addItem('show selection')
    ->on('click', new \Atk4\Ui\Js\JsExpression(
        'alert(\'Selected: \' + [])', [$sel->jsChecked()]


property Atk4\Ui\Grid::$sortable

When grid is associated with a model that supports order, it will automatically make itself sortable. You can override this behaviour by setting $sortable property to true or false.

You can also set $sortable property for each table column decorator. That way you can enable/disable sorting of particular columns.

See also Table::$sortable.

Advanced Usage

property Atk4\Ui\Grid::$table

You can use a different component instead of default Table by injecting $table property.