README

Yii2 颜色选择器小部件

yii2-iro 是一个用于选择颜色的组件。您可以在 Yii 2.0 PHP 框架中像使用任何其他 InputWidget 一样使用它。

yii2-iro 是由 James Daniel 创建的优秀的 iro.js JavaScript 颜色选择器的包装器。

yii2-iro 可以以两种模式出现：内联（直接在页面中）或弹出对话框，当点击彩色按钮时打开。

Yii2-iro 的演示请见此处。

安装

使用 Composer 以常规方式安装 yii2-iro。将以下内容添加到您的 composer.json 文件的 require 部分

"sjaakp/yii2-iro": "*"

或者运行

composer require sjaakp/yii2-iro

您可以通过下载 ZIP 格式的源代码来手动安装 yii2-iro。

使用 yii2-iro

就像使用任何其他 InputWidget 一样使用 yii2-iro。例如，在 ActiveForm 中，您可能会有以下内容

<?php
    use sjaakp\iro\IroWidget;
?>
...
<?php $form = ActiveForm::begin([
    // ...options...
]); ?>

    <?= $form->field($model, 'name') ?>
    
    <?= $form->field($model, 'favourite_color')->widget(IroWidget::class, [ /* ...options... */ ]) ?>
    ?>
    ...

<?php $form = ActiveForm::end(); ?>
...

要在外部渲染 yii2-iro，我们可以使用类似下面的方法

<?php
use sjaakp\iro\IroWidget;
?>
...
<?= IroWidget::widget([
    'name' => 'iro',
    'value' => '#00ff00',
    'popup' => false
    // ...
]) ?>;
...

选项

yii2-iro 小部件具有所有 InputWidget 的选项，以及以下选项

clientOptions

array 底层 iro.js 颜色选择器的选项。默认值：[]。

popup

boolean 确定 yii2-iro 组件的外观。

false 组件以内联形式出现，直接在页面上。
true 组件以彩色按钮的形式出现。点击它会在模态对话框中显示颜色按钮。

默认值：true。

opacity

boolean 确定是否提供不透明度（alpha）滑块。

colorFormat

string iro.js 颜色选择器可用的颜色格式之一。默认值：'hexString'。

sjaakp / yii2-iro

维护者

详细信息