Easily add badges to your Filament tables with the Badgeable Column plugin. This package allows you to display badges as suffixes or prefixes in your table columns, enhancing the visual representation of data.
| Package Version | Filament Version |
|---|---|
| 1.x | 2.x |
| 2.x | 3.x |
| 3.x | 4.x |
If you are upgrading from version 2 to version 3, you will need to update the namespace anywhere you are using the plugin from Awcodes\FilamentBadgeableColumn to Awcodes\BadgeableColumn.
You can install the package via composer:
composer require awcodes/filament-badgeable-columnImportant
If you have not set up a custom theme and are using Filament Panels follow the instructions in the Filament Docs first. The following applies to both the Panels Package and the standalone Tables package.
After setting up a custom theme add the plugin's views to your theme css file or your app's css file if using the standalone tables package.
@source '../../../../vendor/awcodes/filament-badgeable-column/resources/**/*.blade.php';use Awcodes\BadgeableColumn\Components\Badge;
use Awcodes\BadgeableColumn\Components\BadgeableColumn;
return $table
->columns([
BadgeableColumn::make('name')
->prefixBadges([
Badge::make('brand_name')
->label(fn(Model $record) => $record->status)
->color(function(Model $record) {
return match ($record->status) {
'active' => 'success',
'inactive' => 'danger',
default => 'warning',
};
})
])
->suffixBadges([
Badge::make('hot')
->label('Hot')
->color('danger')
->visible(fn(Model $record) => $record->qty < 5),
]),
]);You can also define the array of badges via a closure, if you want the array of badges to be based on dynamic data. The closure should return an array of Badge objects, similar to above.
The example below assumes the records have a BelongsToMany relationship called topics, and shows how to display each topic name as a badge.
use Awcodes\BadgeableColumn\Components\Badge;
use Awcodes\BadgeableColumn\Components\BadgeableColumn;
return $table
->columns([
BadgeableColumn::make('title')
->suffixBadges(function($record) {
return $record->topics->map(function($topic) {
return Badge::make($topic->name)->color($topic->color);
});
})
->searchable()
->sortable(),
]);If you prefer to have a more "rounded" shape you can use the asPills() method to set the shape of the badges.
use Awcodes\BadgeableColumn\Components\Badge;
use Awcodes\BadgeableColumn\Components\BadgeableColumn;
return $table
->columns([
BadgeableColumn::make('name')
->asPills()
]);The default separator between the column text and the badges is '—'. If you would like to use a different separator, use the separator() method to set a character to be used as a separator.
use Awcodes\BadgeableColumn\Components\Badge;
use Awcodes\BadgeableColumn\Components\BadgeableColumn;
return $table
->columns([
BadgeableColumn::make('name')
->separator(':')
]);If you would like to use a different font family for the badges, you can use the fontFamily() method to set the font family.
use Awcodes\BadgeableColumn\Components\Badge;
use Awcodes\BadgeableColumn\Components\BadgeableColumn;
use Filament\Support\Enums\FontFamily;
return $table
->columns([
BadgeableColumn::make('name')
->fontFamily(FontFamily::Mono)
]);If you would like to use a different font weight for the badges, you can use the weight() method to set the font weight.
use Awcodes\BadgeableColumn\Components\Badge;
use Awcodes\BadgeableColumn\Components\BadgeableColumn;
use Filament\Support\Enums\FontWeight;
return $table
->columns([
BadgeableColumn::make('name')
->weight(FontWeight::Bold)
]);If you would like to use a different size for the badges, you can use the size() method to set the size.
use Awcodes\BadgeableColumn\Components\Badge;
use Awcodes\BadgeableColumn\Components\BadgeableColumn;
use Filament\Support\Enums\Size;
return $table
->columns([
BadgeableColumn::make('name')
->size(Size::Small)
]);Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.
