kartik-v / yii2-widget-colorinput
An enhanced Yii 2 widget encapsulating the HTML 5 color input (sub repo split from yii2-widgets)
Installs: 3 952 279
Dependents: 18
Suggesters: 0
Security: 0
Stars: 32
Watchers: 5
Forks: 22
Open Issues: 2
Language:JavaScript
Type:yii2-extension
Requires
- kartik-v/yii2-krajee-base: >=1.9
README
yii2-widget-colorinput
The ColorInput widget is an advanced ColorPicker input styled for Bootstrap. It uses a combination of the HTML5 color input and/or the JQuery Spectrum Plugin for rendering the color picker. You can use the Native HTML5 color input by setting the useNative
option to true
. Else, the Spectrum plugin polyfills for unsupported browser versions.
- Specially styled for Bootstrap 3.x and 4.x with customizable caption showing the output of the control.
- Ability to prepend and append addons.
- Allow the input to be changed both via the control or the text box.
- The Spectrum plugin automatically polyfills the
HTML5 color input
for unsupported browser versions.
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.
Installation
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-colorinput "*"
or add
"kartik-v/yii2-widget-colorinput": "*"
to the require
section of your composer.json
file.
Release Updates
NOTE: Refer the CHANGE LOG for details on release wise changes.
Demo
You can refer detailed documentation and demos on usage of the extension.
Usage
use kartik\color\ColorInput; // Usage with ActiveForm and model echo $form->field($model, 'color')->widget(ColorInput::classname(), [ 'options' => ['placeholder' => 'Select color ...'], ]); // With model & without ActiveForm echo '<label>Select Color</label>'; echo ColorInput::widget([ 'model' => $model, 'attribute' => 'saturation', ]);
License
yii2-widget-colorinput is released under the BSD-3-Clause License. See the bundled LICENSE.md
for details.