Skip to main content

Grid Column Usage

Column Width​

$grid->column('title')->width(200);

Column Color​

$grid->column('title')->color('#ffff00');

HTML Attributes​

$grid->column('title')->setAttributes(['style' => 'color:red;']);
$grid->column('desc')->style('max-width:200px;word-break:break-all;');

Help Text​

$grid->column('title')->help('This column shows the post title');

Sorting​

// Enable sortable column
$grid->column('created_at')->sortable();

// Sortable with type casting
$grid->column('price')->sortable(false, 'DECIMAL');

// Default ordering
$grid->model()->orderBy('id', 'desc');

Hide Column by Default​

$grid->column('created_at')->hide();

Users can still show it using the column selector.

Fixed Columns​

Keep first and last columns visible during horizontal scrolling:

$grid->fixColumns(3, -2); // Fix first 3, last 2

String Operations​

Chain Illuminate\Support\Str methods on column values:

$grid->title()->limit(30);
$grid->title()->ucfirst();
$grid->title()->substr(1, 10);
$grid->email()->limit(20, '...');

Array / Collection Operations​

For array or collection values, chain Illuminate\Support\Collection methods:

$grid->tags()->pluck('name');
$grid->tags()->pluck('name')->map('ucwords')->implode(', ');

Complex Transformations​

$grid->images()->display(function ($images) {
return json_decode($images, true);
})->map(function ($path) {
return 'http://localhost/images/' . $path;
})->image();

Extending Columns​

Anonymous Function​

use SuperAdmin\Admin\Grid\Column;

Column::extend('color', function ($value, $color) {
return "<span style='color: $color'>$value</span>";
});

// Usage
$grid->title()->color('#ccc');

Class-Based Extension​

Column::extend('popover', Popover::class);

// Usage
$grid->description()->popover('right');