awcodes / filament-badgeable-column
Filament Tables column to append and prepend badges.
Fund package maintenance!
awcodes
Installs: 130 040
Dependents: 2
Suggesters: 0
Security: 0
Stars: 123
Watchers: 3
Forks: 18
Open Issues: 0
Requires
- php: ^8.1
- filament/filament: ^3.0
- spatie/laravel-package-tools: ^1.15
Requires (Dev)
- laravel/pint: ^1.0
- spatie/laravel-ray: ^1.26
This package is auto-updated.
Last update: 2024-11-06 16:32:08 UTC
README
With Filament Badgeable Column you prepend and append badges to your columns.
Installation
You can install the package via composer:
composer require awcodes/filament-badgeable-column
In an effort to align with Filament's theming methodology you will need to use a custom theme to use this plugin.
Note If you have not set up a custom theme and are using a Panel follow the instructions in the Filament Docs first. The following applies to both the Panels Package and the standalone Forms package.
Add the plugin's views to your tailwind.config.js
file.
content: [ '<path-to-vendor>/awcodes/filament-badgeable-column/resources/**/*.blade.php', ]
Usage
use Awcodes\FilamentBadgeableColumn\Components\Badge; use Awcodes\FilamentBadgeableColumn\Components\BadgeableColumn; return $table ->columns([ BadgeableColumn::make('name') ->suffixBadges([ Badge::make('hot') ->label('Hot') ->color('danger') ->visible(fn(Model $record) => $record->qty < 5), ]) ->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', }; }) ]) ]);
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\FilamentBadgeableColumn\Components\Badge; use Awcodes\FilamentBadgeableColumn\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(), ]);
Badgeable Tags Column
Warning The Badgeable Tags Column has been deprecated please use the
TextColumn
badge()
method instead.
Badge Shape
If you prefer to have a more "rounded" shape you can use the asPills()
method to set the shape of the badges.
use Awcodes\FilamentBadgeableColumn\Components\Badge; use Awcodes\FilamentBadgeableColumn\Components\BadgeableColumn; return $table ->columns([ BadgeableColumn::make('name') ->asPills() ]);
Separator
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 character to be used as a separator.
use Awcodes\FilamentBadgeableColumn\Components\Badge; use Awcodes\FilamentBadgeableColumn\Components\BadgeableColumn; return $table ->columns([ BadgeableColumn::make('name') ->separator(':') ]);
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.