Bootstrap Colorpicker
Bootstrap Colorpicker is a simple and customizable colorpicker
component for jQuery, which is also compatible with Twitter Bootstrap.
NOTE that this documentation refers to the latest stable version of the project.
Previous documentation can be found here: v2.x.
Install
You can get the latest version in many different ways:
- Downloading a ZIP file from the releases
- Cloning using Git:
git clone https://github.com/farbelous/bootstrap-colorpicker.git
- Installing via NPM:
npm install bootstrap-colorpicker
- Installing via Yarn:
yarn add bootstrap-colorpicker
- Installing via Composer:
composer require itsjavi/bootstrap-colorpicker
To start using the component, most of the time you will only need the files under the dist
folder.
The dist
folder will be available if you installed this package via npm or yarn. In any other cases
you will need to run yarn install && npm run build
in order to generate it.
Example:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<link href="dist/css/bootstrap-colorpicker.css" rel="stylesheet">
</head>
<body>
<div class="container">
<input id="mycp" type="text" class="form-control" />
</div>
<script src="//code.jquery.com/jquery-3.2.1.js"></script>
<script src="dist/js/bootstrap-colorpicker.js"></script>
<script>
$(function () {
$('#mycp').colorpicker({popover:false});
});
</script>
</body>
Requirements
Note that this library depends on jQuery >= 2.1.0
.
The Twitter Bootstrap
dependency is recommended but optional, since this library does not depend directly
on it in order to work, except when Bootstrap-related classes like form-control
and input-group-append
are used
like in the examples. In that case you will need at least the Bootstrap CSS for everything to be displayed correctly.
The Bootstrap JS bundle is required in case you want to use the Bootstrap Popover instead of the built-in one.
By default all instances are created using the Bootstrap Popover. In order to make the plugin work without Bootstrap,
you need to set the popover
option to false
.
Documentation
The documentation of this project has been created with by Handlebars, JSDoc and the Minami template.
Older versions:
Contributions
This project exists thanks to all the people who contribute.
Please read CONTRIBUTING
before sending a pull request or issue.
License
The MIT License (MIT).
Please see the License File for more information.
Credits
Originally written by Stefan Petre in 2013.
Rewritten and maintained by Javi Aguilar and all other contributors.
With the support of JetBrains.