README

线材簇

线材簇允许您将多个字段视觉上聚集成一个。

在功能上，它与 Group 组件类似，不同之处在于字段看起来像一个视觉单元，这对于紧密耦合的表单字段很有用，例如货币和金额，它们只有在一起才有意义。

展示

支持我们

您的支持对我们插件持续进步至关重要。我们感谢每一位为我们的旅程做出贡献的用户。

虽然我们的插件对所有用户都可用，但如果您正在将其用于商业用途，并认为它为您的事业增添了显著价值，我们恳请您考虑通过 GitHub Sponsors 支持我们。这种赞助将帮助我们持续开发和维护，以保持我们的插件健壮和更新。您提供的任何金额都将极大地帮助我们实现目标。加入我们，使此插件更加完善，并推动进一步的创新。

安装

您可以通过 composer 安装此包

composer require guava/filament-clusters

使用

很简单

use Guava\FilamentClusters\Forms\Cluster;

Cluster::make([
    // Your schema
]);

例如，对于货币和金额簇

use Guava\FilamentClusters\Forms\Cluster;

Cluster::make([
    \Filament\Forms\Components\Select::make('currency')
        ->options(['EUR', 'USD']),
    
    \Filament\Forms\Components\TextInput::make('amount')
        ->numeric()
        ->required(),
]),

自定义

您可以为您的簇添加标签、提示、帮助文本或操作

use Guava\FilamentClusters\Forms\Cluster;

Cluster::make([
    // Schema
])
    ->label('My label')
    ->hint('Useful hint')
    ->helperText('Help when you\'re stuck');

网格

默认情况下，簇自动在各个子组件之间分配空间。但是，您可以使用 columns 和 columnSpan 为每个子组件进行自定义，就像您在 Filament 中所习惯的那样

use Guava\FilamentClusters\Forms\Cluster;

Cluster::make([
    // Schema
])->columns(5);

垂直簇

要创建垂直簇，只需将簇的列设置为 1 即可

Cluster::make([
    // Schema
])->columns(1);

不同的断点

断点使用与 Filament 的列相同的系统，因此您可以通过传递数组来自定义每个断点

Cluster::make([
    // Schema
])->columns([
    'default' => 1,
    'lg' => 3,
]);

贡献

有关详细信息，请参阅 CONTRIBUTING

安全漏洞

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

鸣谢

• Lukas Frey
• 所有贡献者

许可证

MIT 许可证 (MIT)。有关更多信息，请参阅 许可证文件