kartik-v/yii2-widget-switchinput A Yii2 wrapper widget for the Bootstrap Switch plugin to use checkboxes & radios as toggle switchinputes (sub repo split from yii2-widgets)



Latest Stable Version License Total Downloads Monthly Downloads Daily Downloads

The SwitchInput widget turns checkboxes and radio buttons into toggle switchinputes. The plugin is a wrapper for the Bootstrap Switch Plugin and is specially styled for Bootstrap 3.

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-switchinput "*"

or add

"kartik-v/yii2-widget-switchinput": "*"

to the require section of your composer.json file.

Latest Release

NOTE: The latest version of the module is v1.3.0 released on 14-Jan-2015. Refer the CHANGE LOG for details.


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


use kartik\switchinput\SwitchInput;

// Usage with ActiveForm and model
echo $form->field($model, 'status')->widget(SwitchInput::classname(), [
    'type' => SwitchInput::CHECKBOX

// With model & without ActiveForm
echo SwitchInput::widget([
    'name' => 'status_1',
    'type' => SwitchInput::RADIO


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


Change Log: yii2-widget-switchinput

Version 1.3.1

Date: 10-Jan-2016

  • (bug #18): Correct typo in documentation and demos.
  • (bug #20): Correct pluginOptions['animate'] initialization.
  • Update to latest release of switch input plugin.
  • Code formatting enhancements and update year.

Version 1.3.0

Date: 14-Jan-2015

  • (enh #12): Upgrade bootstrap switch plugin to latest release and fixes kartik-v/yii2-widgets#219.

Version 1.2.0

Date: 08-Dec-2014

  • (bug #5): Fix checked state for checkboxes in \kartik\base\InputWidget.
  • (bug #6): Add indeterminate value support and validation for checkboxes
  • (bug #7): Recognize disabled and readonly in pluginOptions automatically
  • (bug #8): Enhanced styling for radio switches and new indeterminate toggle indicator
  • (bug #10, #11 ): Fix missing bracket in code.

Version 1.1.0

Date: 24-Nov-2014

  • (bug #2): Radio does not populate with default value
  • (bug #4): Upgrade to latest release of bootstrap-switch plugin
  • Set release to stable.

Version 1.0.0

Date: 08-Nov-2014


GitHub Stars
GitHub Forks



v1.3.1 is the latest of 5 releases

BSD-3-Clause license
37 github stars & 10 github forks
1124 downloads in the last day
36399 downloads in the last 30 days
2006801 total downloads