README

Filament Form Faker 是一个用于在 Filament v3 表单中生成虚假输入数据的实用程序包。它非常适合简化大量表单的开发和进行彻底的表单测试。

注意

不建议在生产环境中使用此包，应限制在开发和测试场景中。

此包目前处于Beta阶段。我们非常感谢您通过问题报告参与测试和反馈。

安装

您可以通过 composer 安装此包

composer require innoge/filament-form-faker --dev

Filament 面板使用

要在 Filament 记录页面中自动填充表单的虚假数据，请使用 InnoGE\FilamentFormFaker\Traits\FillsFormWithFakeData 特性。以下是对 UserResource 页面 CreateUser 的示例

<?php

namespace App\Filament\Resources\UserResource\Pages;

use App\Filament\Resources\UserResource;
use Filament\Resources\Pages\CreateRecord;
use InnoGE\FilamentFormFaker\Traits\FillsFormWithFakeData;

class CreateUser extends CreateRecord
{
    use FillsFormWithFakeData;

    protected static string $resource = UserResource::class;
}

默认情况下，仅在本地或测试环境中填充表单的虚假数据。您可以通过在您的页面组件中覆盖 shouldFillFormWithFakeData 方法来自定义此行为。

protected function shouldFillFormWithFakeData(): bool
{
    // insert your custom logic here
}

独立使用

当您在面板构建器外使用 Filament/Forms 时，您可以使用您的表单实例上的 fake() 方法用虚假数据填充您的表单。我们建议在您的 mount 方法中使用此方法。

public function mount()
{
    $this->getForm('form')->fake();
    // or
    $this->form->fake();
}

支持的字段类型

目前，我们支持以下字段类型

构建器
复选框
复选框列表
键值对
选项
重复器
选择
文本区域
文本输入

如果您想添加对其他字段类型的支持，请创建一个问题或拉取请求。

测试

composer test

变更日志

有关最近更改的更多信息，请参阅变更日志

贡献

有关详细信息，请参阅贡献指南

安全漏洞

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

致谢

许可

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

innoge / filament-form-faker

维护者

详情