README.md

Nova Field Dependency Container

Description

A container for grouping fields that depend on other field values. Dependencies can be set on any field type or value.

Demo

Versions

• install v1.2.x for Laravel v5.8 or v6.x and Nova 2.x
• install v1.1.2 for Laravel v5.7 and Nova v1.x

Installation

The package can be installed through Composer.

composer require epartment/nova-dependency-container

Usage

1. Add the Epartment\NovaDependencyContainer\HasDependencies trait to your Nova Resource.
2. Add the Epartment\NovaDependencyContainer\NovaDependencyContainer to your Nova Resource fields method.

class Page extends Resource
{
    use HasDependencies;

    public function fields(Request $request)
    {
        return [
            
            Select::make('Name format', 'name_format')->options([
                0 => 'First Name',
                1 => 'First Name / Last Name',
                2 => 'Full Name'
            ])->displayUsingLabels(),

            NovaDependencyContainer::make([
                Text::make('First Name', 'first_name')
            ])->dependsOn('name_format', 0),

        ];
    }
}

Dependencies

The package supports four kinds of dependencies:

1. ->dependsOn('field', 'value')
2. ->dependsOnEmpty('field')
3. ->dependsOnNotEmpty('field')
4. ->dependsOnNullOrZero('field')

These dependencies can be combined by chaining the methods on the NovaDependencyContainer:

NovaDependencyContainer::make([
  // dependency fields
])
->dependsOn('field1', 'value1')
->dependsOnNotEmpty('field2')
->dependsOn('field3', 'value3')

The fields used as dependencies can be of any Laravel Nova field type. Currently only two relation field types are supported, BelongsTo and MorphTo.

Here is an example using a checkbox:

BelongsTo dependency

If we follow the example of a Post model belongsTo a User model, taken from Novas documentation BelongsTo, the dependency setup has the following construction.

We use the singular form of the belongsTo resource in lower case, in this example Post becomes post. Then we define in dot notation, the property of the resource we want to depend on. In this example we just use the id property, as in post.id.

BelongsTo::make('Post'),

NovaDependencyContainer::make([
    Boolean::make('Visible')
])
->dependsOn('post.id', 2)

When the Post resource with id 2 is being selected, a Boolean field will appear.

MorphTo dependency

A similar example taken from Novas documentation for MorphTo is called commentable. It uses 3 Models; Comment, Video and Post. Here Comment has the morphable fields commentable_id and commentable_type

For a MorphTo dependency, the following construction is needed.

Commentable becomes lower case commentable and the value to depend on is the resource singular form. In this example the dependency container will add two additional fields, Additional Text and Visible, only when the Post resource is selected.

MorphTo::make('Commentable')->types([
    Post::class,
    Video::class,
]),

NovaDependencyContainer::make([
    Text::make('Additional Text', 'additional'),
    Boolean::make('Visible', 'visible')
])
->dependsOn('commentable', 'Post') 

License

The MIT License (MIT). Please see License File for more information.