astersnake/filament-radio-group

为 Filament 提供支持的图标和自定义颜色的单选组字段。

资助包维护!
astersnake

安装: 190

依赖: 0

建议者: 0

安全性: 0

星星: 2

关注者: 1

分支: 0

开放问题: 2

语言:Blade

v0.2.0-alpha 2023-06-26 06:00 UTC

README

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

Xnapper-2023-06-25-17 45 10

filament-radio-group 包为您的 Filament 应用程序提供增强的单选按钮组功能。它提供了一种更简洁的方式来处理和显示多个单选按钮选项,支持自定义图标、描述和显示布局。

安装

通过 composer 安装 filament-radio-group 包

composer require astersnake/filament-radio-group

使用

filament-radio-group 包提供了一个 RadioGroup 类,您可以使用它来在应用程序中构建单选按钮组。

use Astersnake\Filament\RadioGroup\RadioGroup;

$radioGroup = RadioGroup::make('radio_group')
    ->options([
        'option_1' => 'Option 1',
        'option_2' => 'Option 2',
        'option_3' => 'Option 3',
    ])
    ->descriptions([
        'option_1' => 'Description for option 1',
        'option_2' => 'Description for option 2',
        'option_3' => 'Description for option 3',
    ])
    ->icons([
        'option_1' => 'lucide-fish',
        'option_2' => 'lucide-fish',
        'option_3' => 'lucide-fish',
    ])
    ->iconsColor([
        'option_1' => 'text-primary-600',
        'option_2' => 'text-success-600',
        'option_3' => 'text-danger-600',
    ])
    ->columns(3)
    ->required();

在上面的示例中,RadioGroup::make('radio_group') 创建了一个名为 'radio_group' 的新单选按钮组。

  • options() 方法接受一个关联数组,其中键是选项值,值是选项标签。
  • descriptions() 方法接受一个关联数组,其中键是选项值,值是选项的描述。
  • icons() 方法接受一个关联数组,其中键是选项值,值是图标名称。
  • iconsColor() 方法用于为图标分配颜色。

主题化

如果您正在使用 Filament 的自定义主题,则需要将此包的视图添加到您的 Tailwind CSS 配置中。

content: [
    ...
    "./vendor/astersnake/filament-radio-group/resources/views/**/*.blade.php",
],

全面兼容性

filament-radio-group 包是在原始 Filament 单选字段的基础上构建的,这意味着它支持从基础单选字段可用的所有功能。这包括但不限于标签、设置默认值和添加帮助文本。该包扩展了这些功能,提供了更多灵活性和自定义选项。

有关使用基础单选字段功能的更多信息,请参阅 Filament 文档

测试

运行包的测试

composer test

变更日志

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

贡献

我们欢迎您的贡献!请参阅我们的 贡献指南 了解详细信息。

安全漏洞

如果您在此包中发现任何安全漏洞,请按照我们的 安全策略 报告它们。

致谢

许可

此包受 MIT 许可协议(MIT)许可。有关更多信息,请参阅 许可文件