Download the PHP package hoangdv/nova-dynamic-views without Composer
On this page you can find all versions of the php package hoangdv/nova-dynamic-views. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package nova-dynamic-views
Nova dynamic views
This package will help to add some custom placeholder components like custom-index-header
, custom-index-toolbar
, custom-detail-header
, custom-detail-toolbar
, etc in various section in views. It provides a much easier API for it and it allows you to use these "placeholder" components multiple times without overwriting each other.
Support For This Project
Requirements
- PHP (^8.1 or higher)
- Laravel Nova (^4.0 or higher)
Installation
Require the package with composer
Register the tool in the tools
method in \App\Providers\NovaServiceProvider
:
Usage
Let's say you want to add a custom button to the toolbar
of all index
views. Just create a vue component for it, as you would do if you use the custom-index-header
(see section "Create custom component" if you don't know how to). Let's call it my-index-toolbar-btn
. Now the only thing you have to do is register it to your \App\Ņova\Resource
class, within a new method called customIndexToolbarComponents
, which returns a \ShuvroRoy\NovaDynamicViews\CustomComponents
object:
Thats it. Now you should see the content of your component in the toolbar.
Provide extra data
If you want to add extra data (for example a label) to your component (without extra request), just add it to the addItem
method as second parameter (as array):
Access resource data
You have access to the ressource class in all methods by using $this
. On detail
and edit
components, you have access to the ID of the current model with request('id')
. So if you need the model itself in your customDetailHeaderComponents
, customDetailToolbarComponents
or your customUpdateHeaderComponents
, you can query for it like so:
Add (tailwind) class to the container
If you want to add additional CSS classes to the container div of a section (for example add flex w-full justify-end items-center mx-3
to the customIndexToolbarComponents
section), add the class
in the make
function (or use the setClass
method):
Full usage example
Use only on specific resources
If you want to show this button only on a specific resource, for example only for Users, just add this method to the \App\Nova\User
class.
Available methods and areas
All custom-*-*
nova placeholders are available as camel case methods postfixed with Components
:
- ✅
customIndexHeaderComponents
- ✅
customIndexToolbarComponents
- ✅
customDetailHeaderComponents
- ✅
customDetailToolbarComponents
- ✅
customCreateHeaderComponents
- ✅
customAttachHeaderComponents
- ✅
customUpdateAttachHeaderComponents
- ✅
customUpdateHeaderComponents
- ✅
customLensHeaderComponents
Create custom component
This is just a kick start documentation for this. For more info, see https://nova.laravel.com/docs/4.0/customization/resource-tools.html
Create a new resource tool with artisan:
and say yes to all questions of the prompt. Now you can use this component (located ad nova-components/my-index-toolbar-btn
) inside your customXXXComponents
(f.e. customIndexToolbarComponents
)
Credits
- Shuvro Roy
- Bernhard Hörmann
- All Contributors
License
The MIT License (MIT). Please see License File for more information.