Download the PHP package marshmallow/laravel-blade-sortable without Composer
On this page you can find all versions of the php package marshmallow/laravel-blade-sortable. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download marshmallow/laravel-blade-sortable
More information about marshmallow/laravel-blade-sortable
Files in marshmallow/laravel-blade-sortable
Package laravel-blade-sortable
Short Description Custom Blade components to add sortable/drag-and-drop HTML elements in your apps
License MIT
Homepage https://github.com/asantibanez/laravel-blade-sortable
Informations about the package laravel-blade-sortable
Laravel Blade Sortable
Demo
Installation
You can install the package via composer:
After the package is installed, make sure to add laravel-blade-sortable::scripts
components next to your other scripts.
Requirements
Package requires SortableJs
and AlpineJs
to be installed
in your application in order to enable sorting. Reach out
to their respective documentation in order to set them up.
NOTE:
SortableJs
must be available at thewindow
object level in Javascript. To do this, import the library using
window.Sortable = require('sortablejs').default
or use any other similar approach
Usage
The package provides 2 custom Blade components to enable sorting of DOM elements:
laravel-blade-sortable::sortable
laravel-blade-sortable::sortable-item
Sortable
laravel-blade-sortable::sortable
is used as the wrapper element for your sortable/drag-and-drop
items. It must be used to enclose the children it will enable sortable.
By default, the component renders a "div" as the wrapper node. You can
customize this behavior by passing an as
property to render
the type of node you need.
NOTE: Any other attribute you pass along (class, id, alt, etc) will be added to the element
If you would like to use custom Blade component as a wrapper node,
you can also do this by passing a component
property.
Sortable Item
laravel-blade-sortable::sortable-item
is used as the wrapper element for
each item you want to enable sorting.
NOTE: Similar to
laravel-blade-sortable::sortable
, you can pass aas
orcomponent
property to render the type of node or custom component you desire.NOTE: Extra attributes like class, id, alt, etc can be passed along to and will be added to the item node.
As you may have noticed, every laravel-blade-sortable::sortable-item
requires a sort-key
property. This property will be used to keep
track of the ordering of the elements. Should be unique too.
And that's it. You have now a sortable list rendered by Laravel Blade without any custom Javascript. 🔥
That example looks awful though 😅. Because you can pass in any custom component or styling directly, you can customize the wrapper and item nodes according to your needs. Here's another example using TailwindCSS ❤️ and custom components
Looks dope, right? 👌
Advanced Usage
As Form Input
The sort order of elements can be used alongside other input fields on form submissions.
To enable this behavior, just pass a name
prop to a laravel-blade-sortable::sortable
component. The name
should be the name of the input in your form.
By adding a name
props, the component internally adds hidden inputs
for each one of the items' sort-key
.
Pretty neat! 👌
With Livewire
Into Livewire? It's awesome. We know.
You can use this package within your Livewire views and use the sorting information in the component.
To get "sort change" updates in your Livewire component, just add the
attribute wire:onSortOrderChange
to a x-laravel-blade-sortable::sortable
component. Adding this attribute will hook the Livewire component when a
sorting event happens and will call the specified method/callback.
In the example above, every time your items are sorted, the handleSortOrderChange
method will be called passing as argument an array with your items' sort-key
in the
current order.
Extra info is passed along too, so you can check extra data when processing the sort order
Customization
To support some advanced features of SortableJs, it is possible to pass the following
props to a laravel-blade-sortable::sortable
component:
animation
: milliseconds it takes to run the sorting animation.150
is the default value.ghost-class
: class added to the dragged object during sort. Default isnull
. Must be 1 class only.drag-handle
: class name that will be used as the handle for dragging. Only the DOM element that has that class can enable sorting.
Multiple Drop Zones
Wanting to have different drop zones to drag/drop/sort elements? We have you covered. 😎
Just add a group
string prop to a laravel-blade-sortable::sortable
component. Add the same prop to another
laravel-blade-sortable::sortable
component on the same page and BOOM! Done!
Enable/Disable sorting and/or drop
Use :allow-sort=true|false
and :allow-drop=true|false
to x-laravel-blade-sortable::sortable
components
to enable/disable sorting and/or drop of elements.
Both defaults to true
.
Testing
Changelog
Please see CHANGELOG for more information what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Andrés Santibáñez
- All Contributors
License
The MIT License (MIT). Please see License File for more information.