Widget that enables setting up dependent dropdowns with nested dependencies (sub repo split from yii2-widgets).
Clone or download
Latest commit dce295c Nov 5, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Updates to release v1.0.5 Aug 17, 2018
src Updates to release v1.0.5 Aug 17, 2018
CHANGE.md Updates to release v1.0.5 Oct 9, 2018
LICENSE.md Updates to release v1.0.5 Aug 17, 2018
README.md Update README Nov 5, 2018
composer.json Update README Nov 5, 2018

README.md

Krajee Logo
yii2-widget-depdrop
Donate

Stable Version Unstable Version License Total Downloads Monthly Downloads Daily Downloads

The DepDrop widget is a Yii 2 wrapper for the dependent-dropdown jQuery plugin by Krajee. This plugin allows multi level dependent dropdown with nested dependencies. The plugin thus enables to convert normal select inputs to a dependent input field, whose options are derived based on value selected in another input/or a group of inputs. It works both with normal select options and select with optgroups as well.

NOTE: This extension is a sub repo split of yii2-widgets. The split has been done since 08-Nov-2014 to allow developers to install this specific widget in isolation if needed. One can also use the extension the previous way with the whole suite of yii2-widgets.

Installation

The preferred way to install this extension is through composer. Check the composer.json for this extension's requirements and dependencies. Read this web tip /wiki on setting the minimum-stability settings for your application's composer.json.

To install, either run

$ php composer.phar require kartik-v/yii2-widget-depdrop "@dev"

or add

"kartik-v/yii2-widget-depdrop": "@dev"

to the require section of your composer.json file.

Release Changes

NOTE: Refer the CHANGE LOG for details on changes to various releases.

Demo

You can refer detailed documentation and demos on usage of the extension.

Usage

use kartik\depdrop\DepDrop;

// Normal parent select
echo $form->field($model, 'cat')->dropDownList($catList, ['id'=>'cat-id']);

// Dependent Dropdown
echo $form->field($model, 'subcat')->widget(DepDrop::classname(), [
     'options' => ['id'=>'subcat-id'],
     'pluginOptions'=>[
         'depends'=>['cat-id'],
         'placeholder' => 'Select...',
         'url' => Url::to(['/site/subcat'])
     ]
 ]);

License

yii2-widget-depdrop is released under the BSD-3-Clause License. See the bundled LICENSE.md for details.