简要教程

evol.colorpicker是一款基于jqueryUI的仿微软Office 2010颜色拾取器jquery插件。该颜色拾取器插件提供多种颜色调色板，支持透明颜色，可通过jqueryui来更换主题，非常实用。

 安装

可以通过bower或npm来安装evol.colorpicker颜色拾取器插件。

bower install evol-colorpicker

npm install evol-colorpicker               

 使用方法

在页面中引入jquery、jquery-ui和evol-colorpicker相关文件。

<link href="css/jquery-ui.css" rel="stylesheet" type="text/css">
<link href="css/evol-colorpicker.css" rel="stylesheet" type="text/css">
<script src="js/jquery.min.js"></script>
<script src="js/jquery-ui.min.js"></script>
<script src="js/evol-colorpicker.js"></script>

 HTML结构

使用一个<input>元素来作为颜色拾取器的容器。

<input style="width:100px;" id="mycolor" />

在插件初始化之后，上面的代码将被包装为下面的样子：

<div style="width:128px;">
   <input style="width:100px;" id="mycolor" class="colorPicker evo-cp0" />
   <div class="evo-colorind" style="background-color:#8db3e2"></div>
</div>

 初始化插件

在页面DOM元素加载完毕之后，可以通过colorpicker()方法来初始化该颜色拾取器插件。

$(document).ready(function() {
    $("#mycolor").colorpicker();
});

 配置参数

evol.colorpicker颜色拾取器插件的可用配置参数有：

1、color(String)：用于设置颜色值。默认值为null。

$("#mycolor").colorpicker({
    color: "#ffffff"
});

2、defaultPalette(String)：用于设置默认的颜色调色板。可选值有："theme" 或 "web"，默认值为"theme"。

$("#mycolor").colorpicker({
    defaultPalette: 'web'
});

3、displayIndicator(Boolean)：是否在调色板中，鼠标hover或点击时显示颜色值。默认值为true。

$("#mycolor").colorpicker({
    displayIndicator: false
});

4、hideButton(Boolean)：当将颜色拾取器绑定到一个文本框时，在文本框的右侧会显示一个按钮，如果不想要这个按钮，可以将该参数设置为false。

$("#mycolor").colorpicker({
    hideButton: true
});

5、history(Boolean)：是否保存颜色选择的历史，最多可以保存28层。默认为true。

$("#mycolor").colorpicker({
    history: false
});

6、initialHistory(Array)：提供颜色选择的历史记录。默认为null。

$("#mycolor").colorpicker({

    initialHistory: ["#ff0000", "#00ff00", "#0000ff"]

});                 

7、showOn(String)：是否只有当点击按钮时才显示颜色拾取器，或其它情况叶先生颜色拾取器。默认值为both。

$("#mycolor").colorpicker({
    showOn: "button"
});

8、strings(String)：用逗号分隔的一个字符串。默认值为Theme Colors,Standard Colors,Web Colors,Theme Colors,Back to Palette,History,No history yet。

$("#mycolor").colorpicker({
    strings: "Couleurs de themes,Couleurs de base,Plus de couleurs,Moins de couleurs,Palette,Historique"
});

9、transparentColor(Boolean)：是否允许选择透明色。十六进制透明色是#0000ffff。默认值为false。

$("#mycolor").colorpicker({
    transparentColor: true
});

 方法

evol.colorpicker颜色拾取器插件的可用的方法有：

1、clear()：清空颜色值。

$("#mycolor").colorpicker("clear");

2、enable()：使颜色拾取器可用。

$("#mycolor").colorpicker("enable");

3、disable()：禁用颜色拾取器。

$("#mycolor").colorpicker("disable");

4、isDisabled()：查看颜色拾取器的状态。

$("#mycolor").colorpicker("isDisabled");

5、val([color])：设置或获取颜色拾取器的值。

var colorValue = $("#mycolor").colorpicker("val");

$("#mycolor").colorpicker("val", "#d0d0d0");

6、showPalette()：显示调色板。

$("#mycolor").colorpicker("showPalette");

7、hidePalette()：隐藏调色板。

$("#mycolor").colorpicker("hidePalette");

 事件

evol.colorpicker颜色拾取器插件的可用的事件有：

1、change.color： 当颜色被选择时触发。

$("#mycolor").on("change.color", function(event, color){
    $('#title').css('background-color', color);
});

2、mouseover.color： 当鼠标hover颜色拾取器调色板时触发。

$("#mycolor").on("mouseover.color", function(event, color){
    $('#title').css('background-color', color);
});

 本文由职坐标整理并发布，了解更多内容，请关注职坐标WEB前端jQuery频道！