angular-bootstrap-colorpicker

Native AngularJS colorpicker directive

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
angular-bootstrap-colorpicker
422143.0.325 years ago8 years agoMinified + gzip package size for angular-bootstrap-colorpicker in KB

Readme

devDependency Status Build Status
angular-bootstrap-colorpicker
This version contains a native AngularJS directive based on bootstrap-colorpicker jQuery library.
No dependency on jQuery or jQuery plugin is required.

Demo page (Bootstrap v3.x.x)
Previous releases: - branch 2.0 (Bootstrap v2.x.x) - branch 1.0 if you need a functionality from the original plugin or IE<9 support
Installation

npm

$ npm install angular-bootstrap-colorpicker --save

bower

$ bower install angular-bootstrap-colorpicker --save

Copy css/colorpicker.css and js/bootstrap-colorpicker-module.js. Add a dependency to your app, for instance:
angular.module('myApp', ['colorpicker.module'])
Examples:
Hex format
<input colorpicker type="text" ng-model="your_model" />
or
<input colorpicker="hex" type="text" ng-model="your_model" />

RGB format
<input colorpicker="rgb" type="text" ng-model="your_model" />

RBGA format
<input colorpicker="rgba" type="text" ng-model="your_model" />

As non input element
<div colorpicker ng-model="your_model"></div>

The color picker template with an input element
<input colorpicker colorpicker-with-input="true" type="text" ng-model="your_model" />

Position of the color picker (top, right, bottom, left).
<input colorpicker colorpicker-position="right" type="text" ng-model="your_model" />

The color picker in a fixed element
<input colorpicker colorpicker-fixed-position="true" type="text" ng-model="your_model" />

When using fixed positioning, you can also put the picker into the parent element (this allows more styling control)
<input colorpicker colorpicker-fixed-position="true" colorpicker-parent="true" type="text" ng-model="your_model" />

The color picker in UI Bootstrap modal (the parent element position property must be set to relative)
<input colorpicker colorpicker-parent="true" type="text" ng-model="your_model" />

Binding the visibility of the color picker to a variable in the scope
<input colorpicker colorpicker-is-open="isOpen" type="text" ng-model="your_model" />

Auto hiding the color picker when a color has been selected
<input colorpicker colorpicker-close-on-select type="text" ng-model="your_model" />

Customize a size of the color picker saturation panel
<input colorpicker colorpicker-size="200" type="text" ng-model="your_model" />
Events:
Each color picker will emit the following events passing a data object in the following format:
{
	name: '',
	value: ''
}
Name is the string representation of ng-model and value is the current color.

colorpicker-selected

A global selected event, will be fired when a color is selected from the saturation, hue or alpha slider.

colorpicker-selected-saturation

Will be fired when a color is selected from the saturation slider.

colorpicker-selected-hue

Will be fired when a color is selected from the hue slider.

colorpicker-selected-alpha

Will be fired when a color is selected from the alpha slider.

colorpicker-shown

Will be fired when a color picker is opened.

colorpicker-closed

Will be fired when a color picker is closed.