README

Nova Nested Form

此包允许您将嵌套关系的表单包含到父表单中。

安装

使用git引用将包添加到您的composer中

"repositories": [
        {
            "url": "https://github.com/handleglobal/laravel-nova-nested-form.git",
            "type": "git"
        }
]

composer require handleglobal/nova-nested-form:dev-master

贡献

由于我没有预料到会有这么多人使用这个包（这真是太棒了），而且我根本没有足够的时间定期更新/增强这个包，因此我正在寻找其他贡献者来帮助我维护和特性请求。如果您对此感兴趣，请毫不犹豫地与我联系！

将新的关系表单附加到资源

只需在字段中添加一个NestedForm。第一个参数必须是一个现有的NovaResource类，第二个参数（可选）必须是在您的模型中现有的HasOneOrMany关系。

namespace App\Nova;

use Laravel\Nova\Fields\ID;
use Illuminate\Http\Request;
use Laravel\Nova\Fields\Text;
use Laravel\Nova\Fields\Gravatar;
use Laravel\Nova\Fields\Password;
// Add use statement here.
use Handleglobal\NestedForm\NestedForm;

class User extends Resource
{
    ...
    public function fields(Request $request)
    {
        return [
            ID::make()->sortable(),

            Gravatar::make(),

            Text::make('Name')
                ->sortable()
                ->rules('required', 'max:255'),

            Text::make('Email')
                ->sortable()
                ->rules('required', 'email', 'max:254')
                ->creationRules('unique:users,email')
                ->updateRules('unique:users,email,{{resourceId}}'),

            Password::make('Password')
                ->onlyOnForms()
                ->creationRules('required', 'string', 'min:6')
                ->updateRules('nullable', 'string', 'min:6'),

            // Add NestedForm here.
            NestedForm::make('Posts'),
        ];
    }

选择何时显示表单

例如，如果嵌套表单仅在"has_comments"属性的值为true时可用，您可以使用

class Post extends Resource
{
    ...
    public function fields(Request $request)
    {
        return [
            Boolean::make('Has Comments'),
            NestedForm::make('Comments')->displayIf(function ($nestedForm, $request) {
               return [
                    [ 'attribute' => 'has_comments', 'is' => true ]
               ];
        ];
    }
})

displayIf方法预期返回一个数组，因为您可能想添加多个条件。

class Post extends Resource
{
    ...
    public function fields(Request $request)
    {
        return [
            Boolean::make('Has Comments'),
            Text::make('Title'),
            Text::make('Subtitle')->nullable(),
            Number::make('Number of comments allowed'),
            NestedForm::make('Comments')->displayIf(function ($nestedForm, $request) {
                return [
                    [ 'attribute' => 'has_comments', 'is' => true ],
                    [ 'attribute' => 'title', 'isNotNull' => true ],
                    [ 'attribute' => 'subtitle', 'isNull' => true ],
                    [ 'attribute' => 'title', 'includes' => 'My' ],
                    [ 'attribute' => 'number_of_comments_allowed', 'moreThanOrEqual' => 1 ],

                    // Integration for nova booleanGroup field
                    [ 'attribute' => 'my_multiple_checkbox', 'booleanGroup' => 'the_checkbox_key_to_target' ],
                ];
            })
        ];
    }
}

然后包将添加这些条件，并在您填写字段时动态更新您的表单。可用的规则有

is（是）
isNot（不是）
isNull（为空）
isNotNull（不为空）
isMoreThan（大于）
isMoreThanOrEqual（大于等于）
isLessThan（小于）
isLessThanOrEqual（小于等于）
includes（包含）
booleanGroup（布尔组）

添加最少或最多的子元素数量

例如，如果您希望每个用户至少有3篇文章，最多有5篇文章，请简单使用

NestedForm::make('Posts')->min(3)->max(5),

请注意，包会自动检测关系是否接受多个子元素或单个子元素，并相应地设置最大值。

在创建新用户时，将显示3个空白文章。如果达到文章的最大数量，"添加新文章"按钮将消失。

设置默认展开/折叠行为

如果您想默认打开嵌套表单，请简单使用

NestedForm::make('Posts')->open(true),

修改默认标题

您可以使用heading()方法修改默认标题。您可以使用辅助方法wrapIndex()将当前子索引添加到您的标题中。

NestedForm::make('Posts')->heading(NestedForm::wrapIndex() . ' // Post'),

您还可以使用辅助方法wrapAttribute()将当前子元素的任何属性添加到您的标题中。

NestedForm::make('Posts')->heading(NestedForm::wrapIndex() . ' // ' . NestedForm::wrapAttribute('title', 'My default title')),

修改索引分隔符

当您有嵌套表单时（例如，1. 文章，1.1. 评论，1.1.1. 赞同），您可以在 separator() 方法中修改默认索引分隔符。

NestedForm::make('Posts')->separator('\'),

sas-adilis / nova-nested-form

维护者

详细信息