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); }); |
Github地址为:https://github.com/evoluteur/colorpicker
下载密码: dgt9