README

Filament 评分工具是一个旨在为您的应用程序提供一套测量或评分不同资源的工具的 FilamentPHP 插件。

与其他（星形）评分工具有什么不同？

我们想到了给用户选择图标的可能性，这取决于评分的上下文。

例如，如果您想评分一部电影，您可以使用星形图标；如果您想评分一本书，您可以使用书籍图标；如果您想提供可以入住酒店房间的人数，您可以使用用户图标……以此类推，您应该明白了。Filament 提供的任何图标都可以用于评分/测量。

此外，我们还允许用户选择图标的尺寸、要显示的图标数量以及图标的颜色。是的，您可以根据评分值设置不同的颜色。

您可以在下面的示例中查看一些示例，或者在 演示应用 中自己尝试。

安装

您可以通过 composer 安装此包

composer require lartisan/filament-rating-tool

可选地，您可以使用以下命令发布视图

php artisan vendor:publish --tag="filament-rating-tool-views"

表单使用

在准备表单时，您需要定义一个 RatingInput 字段，并可选地进行一些配置

RatingInput::make('rating')
    ->size('xl')
    ->maxValue(5)
    ->icon('heroicon-o-stop')
    ->color(fn (int $state): string => match ($state) {
        1 => 'danger',
        2 => 'warning',
        3 => 'info',
        4 => 'primary',
        5 => 'success',
        default => 'gray',
    }),

这些都是可以用来配置此字段的可能方法。如您所见，您可以为输入提供 maxValue，因此如果您想根据 $state 匹配某些自定义颜色，您将需要相同数量的颜色。当然，一个人只能为字段的所有符号选择一个颜色。

RatingInput::make('rating')
    ->color('warning')
    // ...

表格使用

类似于表单，有一个专门的列用于显示测量值...

RatingColumn::make('rating')
    ->size('xs')
    ->maxValue(5)
    ->icon('heroicon-s-star')
    ->color(fn (int $state): string => match ($state) {
        1 => 'danger',
        2 => 'warning',
        3 => 'info',
        4 => 'primary',
        5 => 'success',
        default => 'gray',
    }),
    // ...

信息列表使用

……以及另一个用于查看记录时显示信息列表的列

RatingEntry::make('rating')
    ->columnSpan(2)
    ->size('lg')
    ->maxValue(5)
    ->icon('heroicon-s-user')
    ->color(fn (int $state): string => match ($state) {
        1 => 'danger',
        2 => 'warning',
        3 => 'info',
        4 => 'primary',
        5 => 'success',
        default => 'gray',
    }),
    // ...

变更日志

请参阅 CHANGELOG 了解最近更改的详细信息。

贡献

请参阅 CONTRIBUTING 了解详细信息。

安全漏洞

请审查 我们的安全策略 了解如何报告安全漏洞。

致谢

• Cristian Iosif

许可证

MIT 许可证（MIT）。请参阅 许可证文件 了解更多信息。