mokhosh/filament-rating
将评分字段和列添加到 Filament 表单和表格中
v1.4.0
2024-09-16 17:34 UTC
Requires
- php: ^8.1
- filament/filament: ^3.0
- spatie/laravel-package-tools: ^1.15.0
Requires (Dev)
- laravel/pint: ^1.0
- nunomaduro/collision: ^7.9
- orchestra/testbench: ^8.0
- pestphp/pest: ^2.1
- pestphp/pest-plugin-arch: ^2.0
- pestphp/pest-plugin-laravel: ^2.0
README
向 Filament 表单和表格中添加美观且可定制的评分字段和列。
安装
您可以通过 composer 安装此包
composer require mokhosh/filament-rating
发布资产以正确显示样式
php artisan filament-rating:install
使用
您可以在表单中添加评分字段,如下所示
use Mokhosh\FilamentRating\Components\Rating; $form->schema([ Rating::make(), ]);
您可以在表格中添加评分列,如下所示
use Mokhosh\FilamentRating\Columns\RatingColumn; $table->schema([ RatingColumn::make(), ]);
您可以在信息列表中添加评分条目,如下所示
use Mokhosh\FilamentRating\Entries\RatingEntry; $infolist->schema([ RatingEntry::make(), ]);
主题
您可以选择主题。默认值为:RatingTheme::Simple
。接受的值有:RatingTheme::Simple
、RatingTheme::HalfStars
,如下所示
use Mokhosh\FilamentRating\RatingTheme; $form->schema([ Rating::make()->theme(RatingTheme::Simple), ]);
最大星数
您可以更改总星数。默认值为 5
。接受的值是数字,如下所示
$form->schema([ Rating::make()->stars(10), ]);
允许零星
如果您想允许选择零星,可以这样做
$form->schema([ Rating::make()->allowZero(), ]);
自定义大小
您可以自定义星星的大小。默认值为 md
。接受的值有:xs
、sm
、md
、lg
和 xl
,如下所示
$form->schema([ Rating::make()->size('sm'), ]);
自定义颜色
您可以通过选择 Filament 主题颜色之一来自定义星星的颜色。默认值为 primary
。接受的值有:danger
、gray
、info
、primary
、success
和 warning
,如下所示
$form->schema([ Rating::make()->color('success'), ]);
测试
composer test
变更日志
请参阅 CHANGELOG 了解最近更改的详细信息。
贡献
请参阅 CONTRIBUTING 了解详细信息。
安全漏洞
请查阅 我们的安全策略 了解如何报告安全漏洞。
鸣谢
许可证
MIT 许可证(MIT)。请参阅 许可证文件 了解更多详细信息。