Skip to main content

Column Display

Column display methods control how data is rendered in the grid.

Display Callback​

Process values through a custom function:

$grid->column('title')->display(function ($title) {
return "<span style='color:blue'>$title</span>";
});

Inside the callback, $this refers to the current row, so you can access other fields:

$grid->column('full_name')->display(function () {
return $this->first_name . ' ' . $this->last_name;
});

Value Mapping​

$grid->column('status')->using([
0 => 'Pending',
1 => 'Active',
2 => 'Disabled',
]);

Visual Elements​

Image​

$grid->column('avatar')->image();
$grid->column('avatar')->image('', 100, 100); // With dimensions

Label​

$grid->column('status')->label();

// With color mapping
$grid->column('status')->label([
'draft' => 'default',
'published' => 'success',
'archived' => 'warning',
]);

Badge​

$grid->column('category')->badge();
$grid->column('category')->badge('info');

Boolean​

$grid->column('released')->bool();

// Custom icons
$grid->column('released')->bool([
1 => true,
0 => false,
]);

Progress Bar​

$grid->column('progress')->progressBar();
$grid->column('progress')->progressBar('primary', 'sm', 100);
$grid->column('url')->link();
$grid->column('homepage')->link('Visit');

Icon​

$grid->column('status')->icon([
0 => 'fa-times text-danger',
1 => 'fa-check text-success',
]);

QR Code​

$grid->column('link')->qrcode();

Copyable​

$grid->column('api_key')->copyable();

Downloadable​

$grid->column('document')->downloadable();

Secret​

Mask values with asterisks (click to reveal):

$grid->column('password')->secret();

Date Formatting​

$grid->column('created_at')->dateFormat('Y-m-d');
$grid->column('created_at')->dateFormat('d M Y H:i');

File Size​

$grid->column('size')->filesize(); // 1024 -> "1.00 KB"

Dot Indicator​

$grid->column('status')->dot([
1 => 'success',
2 => 'danger',
3 => 'info',
]);

Limit Text​

$grid->column('description')->limit(50);
$grid->column('description')->limit(50, '...');

Expand​

Show hidden content on click:

$grid->column('description')->expand(function () {
return $this->description;
});

Display content in a popup modal:

$grid->column('details')->modal('Details', function ($model) {
return $model->details;
});

View​

Render a Blade template:

$grid->column('details')->view('admin.grid.details');

Display multiple images as a carousel:

$grid->column('images')->carousel();

Loading State​

Show loading icon for specific values:

$grid->column('status')->loading([1, 2, 3]);

Chaining Displayers​

You can chain multiple display methods:

$grid->column('tags')
->pluck('name')
->map('ucwords')
->label('info');