README

渲染Bootstrap Toggle Switch插件小部件。

安装

通过composer安装此扩展是首选方式。

运行以下命令

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

或向您的composer.json文件的require部分添加

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

。

使用方法

小部件有两种类型

• SwitchBox
• SwitchRadio

SwitchBox

此小部件渲染Bootstrap Toggle Switch复选框输入控制。与模型一起使用时，非常适合具有布尔状态（开|关、真|假、1|0）的属性。

与表单一起使用的示例

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

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

不带模型使用的示例

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

SwitchRadio

此小部件渲染Bootstrap Toggle Switch单选框列表控制。与模型一起使用时，非常适合具有多个状态的属性。

与表单一起使用的示例

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

不带模型使用的示例

<?= \dosamigos\switchinput\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']
]);?>

不显示标签

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

使用代码修复器

我们添加了一个PHP代码修复器以标准化我们的代码。它包括Symfony、PSR2和一些贡献者规则。

./vendor/bin/php-cs-fixer fix ./src --config .php_cs

测试

$ ./vendor/bin/phpunit

贡献

请参阅CONTRIBUTING以获取详细信息。

鸣谢

• Antonio Ramirez
• 所有贡献者

许可证

BSD许可证（BSD）。请参阅许可证文件以获取更多信息。

定制软件 | 网页和移动软件开发
www.2amigos.us