kartik-v/yii2-widget-depdrop Widget that enables setting up dependent dropdowns with nested dependencies (sub repo split from yii2-widgets)


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.


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.


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


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'],
         'placeholder' => 'Select...',
         'url' => Url::to(['/site/subcat'])


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


Change Log: yii2-widget-depdrop

Version 1.0.6

Date: 19-Apr-2019

  • (enh #73): Bump composer dependencies.
  • (enh #71, #72): Add enableCsrfValidation property to DepDropAction.

Version 1.0.5

Date: 09-Oct-2018

  • Bump composer dependencies.
  • Add Bootstrap 4.x support.
  • Reorganize all source code in src directory.
  • Add github contribution and issue/PR log templates.
  • Update copyright year to current.

Version 1.0.4

Date: 10-Jan-2016

  • Enhancements for PJAX based reinitialization. Complements enhancements in kartik-v/yii2-krajee-base#52 and kartik-v/yii2-krajee-base#53.

version 1.0.3

Date: 16-Dec-2015

  • (enh #25): Implement new standalone DepDropAction for usage in Controller.
  • (enh #26): Enhance update of Select2 plugin values after dependency change.

version 1.0.2

Date: 26-Jun-2015

  • (enh #17): Tighter integration for Select2 widget on clear.
  • Set composer dependencies.

version 1.0.1

Date: 22-May-2015

  • (enh #15): Fixes for release v2.0.0 of kartik-v/yii2-widget-select2.

version 1.0.0

Date: 08-Nov-2014


GitHub Stars
GitHub Forks



v1.0.6 is the latest of 7 releases

BSD-3-Clause license
83 github stars & 39 github forks
609 downloads in the last day
52325 downloads in the last 30 days
3686936 total downloads