timothyasp / nova-badge-field
一个 Laravel Nova 字段。
v2.0.1
2022-06-23 21:35 UTC
Requires
- php: >=7.1.0
Requires (Dev)
- laravel/nova: ~4.0
README
兼容 Nova 4!
这是一个简单的 Laravel Nova 徽章字段。它扩展了 Select
字段,允许将颜色映射到值,以在索引和详情页面上显示“徽章”。可以使用 tailwind 类进行自定义。
详情页面
索引
安装
您可以通过 composer 在使用 Nova 的 Laravel 应用中安装此包。
composer require timothyasp/nova-badge-field
对于 Nova v1 - v3 支持,在您的 composer.json
中使用 "timothyasp/nova-badge-field": "^1.04"
。
用法
除了任何 Select
字段选项和表示方法之外,此包还提供了一些针对 Badge
的特定自定义选项。
要自定义徽章的文本颜色,请设置选项上的 color
属性。如果没有设置选项,它将默认设置为设置背景颜色,并将文本颜色设置为基于背景亮度的对比白色/黑色。
use Timothyasp\Badge\Badge;
$options = [
'option1' => 'Option 1',
'option2' => 'Option 2'
];
Badge::make('Field')
->options($options)
->colors([
'option1' => '#ffffff',
'option2' => '#000000'
]);
如果您希望使用 label
作为索引和详情页面上的显示文本,可以使用 ->displayUsingLabels()
选项。
use Timothyasp\Badge\Badge;
$options = [
'Option 1' => 1,
'Option 2' => 2
];
Badge::make('Field')
->options($options)
->colors([
'Option 1' => '#ffffff',
'Option 2' => '#000000'
])->displayUsingLabels();
最后,如果您需要对徽章显示进行更多自定义,请使用 extraClasses
方法传递任何额外的 Tailwind 类来自定义 Badge
的外观。
这在您希望使用 Stack
字段时将徽章堆叠而不是内联时很有用。
use Timothyasp\Badge\Badge;
$options = [
'option1' => 'Option 1',
'option2' => 'Option 2'
];
Badge::make('Field')
->options($options)
->extraClasses('mr-2 text-4xl flex');
致谢
许可证
MIT 许可证(MIT)。有关更多信息,请参阅 许可证文件。