This Laravel Nova package adds Panels that allow grouped dependsOn functionality
Dusk Test Repo: https://github.com/Formfeed-UK/nova-dependable-panel-tests
php: ^7.3|^8.0laravel/nova: ^4.0Note that this package is an extension of a Field, rather than a Panel, however it can act as a panel when the separatePanel method is used. This is to allow more flexibility to use fields as part of an existing Panel.
Install the package in to a Laravel app that uses Nova via composer:
composer require formfeed-uk/nova-dependable-panel use FormFeed\DependablePanel\DependablePanel;
public function fields(NovaRequest $request)
{
return [
Select::make('Select', 'select')->options([
'option1' => 'Option 1',
'option2' => 'Option 2',
]),
DependablePanel::make('Panel Title', [
Text::make('Field 1'),
Text::make('Field 2'),
])
->dependsOn(["select"], function (DependablePanel $panel, NovaRequest $request, FormData $formData) {
if ($formData['select'] == "option1") {
$panel->hide();
}
}),
];
}All of the Text Fields dependsOn requests will be sent as one request using the singleRequest method. This is useful for both reducing the number of requests on large forms and for more consistent UX as the fields are changed at the same time.
use FormFeed\DependablePanel\DependablePanel;
public function fields(NovaRequest $request)
{
return [
DependablePanel::make('Panel Title', [
Select::make('Select', 'select')->options([
'option1' => 'Option 1',
'option2' => 'Option 2',
]),
Text::make('Hide Field 1')
->dependsOn(["select"], function (Text $field, NovaRequest $request, FormData $formData) {
if ($formData['select'] == "option1") {
$field->hide();
}
}),
Text::make('Hide Field 2')
->dependsOn(["select"], function (Text $field, NovaRequest $request, FormData $formData) {
if ($formData['select'] == "option1") {
$field->hide();
}
}),
Text::make('Show Field 3')
->hide()
->dependsOn(["select"], function (Text $field, NovaRequest $request, FormData $formData) {
if ($formData['select'] == "option1") {
$field->show();
}
}),
Text::make('Show Field 4')
->hide()
->dependsOn(["select"], function (Text $field, NovaRequest $request, FormData $formData) {
if ($formData['select'] == "option1") {
$field->show();
}
}),
])
->singleRequest(true);
];
}You can also batch dependsOn functionality for all fields within your Panel using the applyToFields method. For example if you need all fields to become readOnly. This can be overidden at the Field Level.
Note that the first parameter should be of type Field to ensure that the function can apply to all fields within your panel, regardless of type.
use FormFeed\DependablePanel\DependablePanel;
public function fields(NovaRequest $request)
{
return [
DependablePanel::make('Panel Title', [
Select::make('Select', 'select')->options([
'option1' => 'Option 1',
'option2' => 'Option 2',
]),
Text::make('Field 1'),
Text::make('Field 2'),
Text::make('Field 3')
->dependsOn(['select'], function (Text $field, NovaRequest $request, FormData $formData) {
if ($formData['select'] == "option1") {
$field->readOnly(false);
}
})
])
->dependsOn(["select"], function (DependablePanel $panel, NovaRequest $request, FormData $formData) {
$panel->applyToFields(function (Field $field, NovaRequest $request, FormData $formData) {
if ($formData['select'] == "option1") {
$field->readOnly();
}
});
}),
];
}The fields in Nova Dependable Panel can be part of any other panel (default), or can be separated into another panel using the separatePanel method.
This panel will use the first argument to DependablePanel as its panel name.
use FormFeed\DependablePanel\DependablePanel;
public function fields(NovaRequest $request)
{
return [
DependablePanel::make('Panel Title', [
Select::make('Select', 'select')->options([
'option1' => 'Option 1',
'option2' => 'Option 2',
]),
Text::make('Field 1'),
Text::make('Field 2'),
Text::make('Field 3')
])
->separatePanel(true)
];
}Rather than hiding/showing fields as a result of dependsOn, you can change the fields themselves using the fields method. Note that this functionality requires singleRequest to operate properly.
use FormFeed\DependablePanel\DependablePanel;
public function fields(NovaRequest $request)
{
return [
Select::make('Select', 'select')->options([
'option1' => 'Option 1',
'option2' => 'Option 2',
]),
DependablePanel::make('Panel Title', [
Text::make('Field 1'),
Text::make('Field 2'),
])
->singleRequest(true)
->dependsOn(["select"], function (DependablePanel $panel, NovaRequest $request, FormData $formData) {
if ($formData['select'] == "option1") {
$panel->fields([
Text::make('Field 3'),
Text::make('Field 4'),
]);
}
}),
];
}Note: If the fields added via the fields method also have dependsOn defined, and you wish those dependsOn mixins to be applied correctly when those fields are first mounted, you should include the fields that they depend upon in the panels dependsOn function.
In the example below if the "Readonly" checkbox is checked, and then the select option is changed to Option 1, in order for these fields to be readonly when mounted, you can see "readonly" needs to be included in the panels dependsOn function.
use FormFeed\DependablePanel\DependablePanel;
public function fields(NovaRequest $request)
{
return [
Select::make('Select', 'select')->options([
'option1' => 'Option 1',
'option2' => 'Option 2',
]),
Boolean::make('Readonly'),
DependablePanel::make('Panel Title', [
Text::make('Field 1'),
Text::make('Field 2'),
])
->singleRequest(true)
->dependsOn(["select", "readonly"], function (DependablePanel $panel, NovaRequest $request, FormData $formData) {
if ($formData['select'] == "option1") {
$panel->fields([
Text::make('Field 3')
->dependsOn(["readonly"], function (Text $field, NovaRequest $request, FormData $formData) {
if ($formData['readonly']) {
$field->readonly();
}
}),
Text::make('Field 4')
->dependsOn(["readonly"], function (Text $field, NovaRequest $request, FormData $formData) {
if ($formData['readonly']) {
$field->readonly();
}
}),
]);
}
}),
];
}Fields method in the Panels dependsOn changed values will not persist on the update form for fields where values are already stored in the database for that resource. protected function resolveDefaultValue(NovaRequest $request)
{
return Field::resolveDefaultValue($request);
}Nova Dependable Panel is open-sourced software licensed under the MIT license.