astersnake / filament-radio-group
为 Filament 提供支持的图标和自定义颜色的单选组字段。
v0.2.0-alpha
2023-06-26 06:00 UTC
Requires
- php: ^8.0
- filament/filament: ^2.0
- illuminate/contracts: ^9.0|^10.0
- spatie/laravel-package-tools: ^1.13.5
Requires (Dev)
- nunomaduro/collision: ^6.0
- nunomaduro/larastan: ^2.0.1
- orchestra/testbench: ^7.0
- pestphp/pest: ^1.21
- pestphp/pest-plugin-laravel: ^1.1
- pestphp/pest-plugin-livewire: ^1.0
- pestphp/pest-plugin-parallel: ^0.3
- phpstan/extension-installer: ^1.1
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-phpunit: ^1.0
- phpunit/phpunit: ^9.5
- spatie/laravel-ray: ^1.26
This package is auto-updated.
Last update: 2024-09-09 22:53:55 UTC
README
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)许可。有关更多信息,请参阅 许可文件。
