Switch Widget

What is the Switch Widget?

The Switch Widget allows to integrate the Bootstrap Toggle Switch plugin in your Yii 2 apps.

Installation

The preferred way to install this extension is through composer.

Either run

composer require 2amigos/yii2-switch-widget:~1.0

or add the following to the require section of your application's composer.json file:

"2amigos/yii2-switch-widget" : "~1.0"

Usage Example

The widget comes in two flavors:

  • SwitchBox
  • SwitchRadio

SwitchBox

This widget renders a Bootstrap Toggle Switch Checkbox input control. Best suitable for attributes with boolean states (on|off, true|false, 1|0) when used with model.

Example of use with a form

<?php
use dosamigos\switchinput\SwitchBox;
?>

<?= $form->field($model, 'validated')->widget(SwitchBox::className(),[
	'clientOptions' => [
		'size' => 'large',
		'onColor' => 'success',
		'offColor' => 'danger'
	]
]);?>

Example of use without a model

<?php
use dosamigos\switchinput\SwitchBox;
?>
<?= SwitchBox::widget([
	'name' => 'Test',
	'checked' => true,
	'clientOptions' => [
		'size' => 'large',
		'onColor' => 'success',
		'offColor' => 'danger'
	]
]);?>

SwitchRadio

This widget renders a Bootstrap Toggle Switch Checkbox radio list control. Best suitable for attributes with multiple states when used with a model.

Example of use with a form

<?php
use dosamigos\switchinput\SwitchRadio;
?>
<?= $form->field($model, 'status')->widget(SwitchRadio::className(), [
	'items' => [
		20 => 'rejected',
		40 => 'approved',
		50 => 'on hold'
	],
]);?>

Example of use without a model

<?php
use dosamigos\switchinput\SwitchRadio;
?>
<?= SwitchRadio::widget([
	'name' => 'shape',
	'inline' => false,
	'items' => [
		[
			'label' => 'best',
			'value' => 100,
			'options' => ['data-size' => 'mini']
		],
		20 => 'good',
		40 => 'superior',
		50 => 'master'
	],
	'labelOptions' => ['style' => 'font-size:16px']
]);?>

Share this

Contributors Thanks All

 

Do you have a good idea? Why Don't We Talk?