An input widget for Yii 2.0 widget based on the yii2-sortable extension that allows you to create sortable-input lists and grids and manipulate them using simple drag and drop. It extends the yii2-sortable features by allowing you to store the sort order in a form input (which is hidden by default). The widget stores the order as delimited list item keys. The widget includes additional jQuery enhancements to initialize the list, trap sortable order change, and reset order on form reset.
Note: This extension depends on the kartik-v/yii2-sortable extension which in turn depends on the kartik-v/yii2-widgets and yiisoft/yii2-bootstrap extensions. Check the composer.json for this extension's requirements and dependencies. Note: Yii 2 framework is still in active development, and until a fully stable Yii2 release, your core yii2-bootstrap packages (and its dependencies) may be updated when you install or update this extension. You may need to lock your composer package versions for your specific app, and test for extension break if you do not wish to auto update dependencies.
Demo ¶
You can see detailed documentation and demonstration on usage of the extension.
Installation ¶
The preferred way to install this extension is through composer.
Either run:
$ php composer.phar require kartik-v/yii2-sortable-input "*"
or add:
"kartik-v/yii2-sortable-input": "*"
to the require
section of your composer.json
file.
Usage ¶
use kartik\sortinput\SortableInput;
echo SortableInput::widget([
'model' => $model,
'attribute' => 'sort_list',
'hideInput' => false,
'delimiter' => '~',
'items' => [
1 => ['content' => 'Item # 1'],
2 => ['content' => 'Item # 2'],
3 => ['content' => 'Item # 3'],
4 => ['content' => 'Item # 4', 'disabled'=>true],
]
]);
Report ¶
- Report any issues on the project page
- Use the forum page for any discussions on this extension
License ¶
yii2-sortable-input is released under the BSD 3-Clause License. See the bundled LICENSE.md
for details.
If you have any questions, please ask in the forum instead.
Signup or Login in order to comment.