Skip to content

An enhanced Yii2 widget encapsulating the HTML 5 color input (sub repo split from yii2-widgets)

License

Notifications You must be signed in to change notification settings

kartik-v/yii2-widget-colorinput

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Krajee Logo
yii2-widget-colorinput
Donate

Stable Version Unstable Version License Total Downloads Monthly Downloads Daily Downloads

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.

About

An enhanced Yii2 widget encapsulating the HTML 5 color input (sub repo split from yii2-widgets)

Resources

License

Stars

Watchers

Forks

Packages

No packages published