raoul2000 / yii2-html5sortable-widget
Wrapper around the HTML5sortable JQuery plugin
Installs: 35
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 3
Forks: 1
Open Issues: 0
Language:JavaScript
Type:yii2-extension
Requires
- yiisoft/yii2: *
This package is not auto-updated.
Last update: 2024-11-05 07:16:16 UTC
README
Wrapper around "HTML5 Sortable", a jQuery plugin to create sortable lists and grids using native HTML5 drag and drop API.
Check out the HTML5 Sortable for demo of the Plugin.
Please note that this extension does not provide any aditionnal feature than the one available in the wrapped plugin. It has no other dependency than the Yii2 Framework
Installation
The preferred way to install this extension is through composer.
Either run
php composer.phar require --prefer-dist raoul2000/yii2-html5sortable-widget "*"
or add
"raoul2000/yii2-html5sortable-widget": "*"
to the require section of your composer.json
file.
Usage
This is an example no how to use this extension once it is installed. First, create an HTML bootstrap list group :
<ul class="list-group sortable" style="min-height: 42px;"> <li class="list-group-item"><span class="glyphicon glyphicon-align-justify"></span> Cras justo odio</li> <li class="list-group-item disabled "><span class="glyphicon glyphicon-align-justify"></span> can't be dragged because of disabled class</li> <li class="list-group-item"><span class="glyphicon glyphicon-align-justify"></span> Morbi leo risus</li> <li class="list-group-item"><span class="glyphicon"></span>can't be dragged because the handle is missing !</li> <li class="list-group-item"><span class="glyphicon glyphicon-align-justify"></span> Vestibulum at eros</li> </ul>
Then let's add some styling so our list items render nicely when drag and dropped :
li.list-group-item { height:42px; } li.sortable-placeholder { border: 1px dashed #CCC; background: #eeeeee; height:42px; list-style: none; }
Finally, make is HTML 5 Sortable by inserting following code :
<?php echo raoul2000\widget\html5sortable\Html5Sortable::widget([ 'selector' => '.sortable', 'sortupdate' => new yii\web\JsExpression('function(){console.log("update");}'), 'pluginOptions' => [ 'handle' => '.glyphicon-align-justify', 'items' => ':not(.disabled)' ] ]); ?>
For more information on the plugin options and usage, please refer to html5sortable@github.
License
yii2-html5sortable-widget is released under the BSD 3-Clause License. See the bundled LICENSE.md
for details.