/*!
* jQuery Color Utilities
*
* Released under the MIT and GPL licenses.
*
* Mostly based on other plugins and functions (linted and optimized a little).
* Sources cited inline.
*/
( function ( $ ) {
/**
* @class jQuery.colorUtil
* @singleton
*/
$.colorUtil = {
/**
* Parse CSS color strings looking for color tuples
*
* Based on highlightFade by Blair Mitchelmore
*
*
* @param {Array|string} color
* @return {Array}
*/
getRGB: function ( color ) {
/*jshint boss:true */
var result;
// Check if we're already dealing with an array of colors
if ( color && $.isArray( color ) && color.length === 3 ) {
return color;
}
// Look for rgb(num,num,num)
if (result = /rgb\(\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*,\s*([0-9]{1,3})\s*\)/.exec(color)) {
return [
parseInt( result[1], 10 ),
parseInt( result[2], 10 ),
parseInt( result[3], 10 )
];
}
// Look for rgb(num%,num%,num%)
if (result = /rgb\(\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*,\s*([0-9]+(?:\.[0-9]+)?)\%\s*\)/.exec(color)) {
return [
parseFloat( result[1] ) * 2.55,
parseFloat( result[2] ) * 2.55,
parseFloat( result[3] ) * 2.55
];
}
// Look for #a0b1c2
if (result = /#([a-fA-F0-9]{2})([a-fA-F0-9]{2})([a-fA-F0-9]{2})/.exec(color)) {
return [
parseInt( result[1], 16 ),
parseInt( result[2], 16 ),
parseInt( result[3], 16 )
];
}
// Look for #fff
if (result = /#([a-fA-F0-9])([a-fA-F0-9])([a-fA-F0-9])/.exec(color)) {
return [
parseInt( result[1] + result[1], 16 ),
parseInt( result[2] + result[2], 16 ),
parseInt( result[3] + result[3], 16)
];
}
// Look for rgba(0, 0, 0, 0) == transparent in Safari 3
if (result = /rgba\(0, 0, 0, 0\)/.exec(color)) {
return $.colorUtil.colors.transparent;
}
// Otherwise, we're most likely dealing with a named color
return $.colorUtil.colors[$.trim(color).toLowerCase()];
},
/**
* Named color map
*
* Based on Interface by Stefan Petre
*
*
* @property {Object}
*/
colors: {
aqua: [0, 255, 255],
azure: [240, 255, 255],
beige: [245, 245, 220],
black: [0, 0, 0],
blue: [0, 0, 255],
brown: [165, 42, 42],
cyan: [0, 255, 255],
darkblue: [0, 0, 139],
darkcyan: [0, 139, 139],
darkgrey: [169, 169, 169],
darkgreen: [0, 100, 0],
darkkhaki: [189, 183, 107],
darkmagenta: [139, 0, 139],
darkolivegreen: [85, 107, 47],
darkorange: [255, 140, 0],
darkorchid: [153, 50, 204],
darkred: [139, 0, 0],
darksalmon: [233, 150, 122],
darkviolet: [148, 0, 211],
fuchsia: [255, 0, 255],
gold: [255, 215, 0],
green: [0, 128, 0],
indigo: [75, 0, 130],
khaki: [240, 230, 140],
lightblue: [173, 216, 230],
lightcyan: [224, 255, 255],
lightgreen: [144, 238, 144],
lightgrey: [211, 211, 211],
lightpink: [255, 182, 193],
lightyellow: [255, 255, 224],
lime: [0, 255, 0],
magenta: [255, 0, 255],
maroon: [128, 0, 0],
navy: [0, 0, 128],
olive: [128, 128, 0],
orange: [255, 165, 0],
pink: [255, 192, 203],
purple: [128, 0, 128],
violet: [128, 0, 128],
red: [255, 0, 0],
silver: [192, 192, 192],
white: [255, 255, 255],
yellow: [255, 255, 0],
transparent: [255, 255, 255]
},
/**
* Convert an RGB color value to HSL.
*
* Conversion formula based on
*
*
* Adapted from .
*
* Assumes `r`, `g`, and `b` are contained in the set `[0, 255]` and
* returns `h`, `s`, and `l` in the set `[0, 1]`.
*
* @param {number} r The red color value
* @param {number} g The green color value
* @param {number} b The blue color value
* @return {number[]} The HSL representation
*/
rgbToHsl: function ( r, g, b ) {
r = r / 255;
g = g / 255;
b = b / 255;
var d,
max = Math.max( r, g, b ),
min = Math.min( r, g, b ),
h,
s,
l = (max + min) / 2;
if ( max === min ) {
// achromatic
h = s = 0;
} else {
d = max - min;
s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
switch ( max ) {
case r:
h = (g - b) / d + (g < b ? 6 : 0);
break;
case g:
h = (b - r) / d + 2;
break;
case b:
h = (r - g) / d + 4;
break;
}
h /= 6;
}
return [h, s, l];
},
/**
* Convert an HSL color value to RGB.
*
* Conversion formula based on
*
*
* Adapted from .
*
* Assumes `h`, `s`, and `l` are contained in the set `[0, 1]` and
* returns `r`, `g`, and `b` in the set `[0, 255]`.
*
* @param {number} h The hue
* @param {number} s The saturation
* @param {number} l The lightness
* @return {number[]} The RGB representation
*/
hslToRgb: function ( h, s, l ) {
var r, g, b, hue2rgb, q, p;
if ( s === 0 ) {
r = g = b = l; // achromatic
} else {
hue2rgb = function ( p, q, t ) {
if ( t < 0 ) {
t += 1;
}
if ( t > 1 ) {
t -= 1;
}
if ( t < 1 / 6 ) {
return p + (q - p) * 6 * t;
}
if ( t < 1 / 2 ) {
return q;
}
if ( t < 2 / 3 ) {
return p + (q - p) * (2 / 3 - t) * 6;
}
return p;
};
q = l < 0.5 ? l * (1 + s) : l + s - l * s;
p = 2 * l - q;
r = hue2rgb( p, q, h + 1 / 3 );
g = hue2rgb( p, q, h );
b = hue2rgb( p, q, h - 1 / 3 );
}
return [r * 255, g * 255, b * 255];
},
/**
* Get a brighter or darker rgb() value string.
*
* Usage:
*
* $.colorUtil.getColorBrightness( 'red', +0.1 );
* // > "rgb(255,50,50)"
* $.colorUtil.getColorBrightness( 'rgb(200,50,50)', -0.2 );
* // > "rgb(118,29,29)"
*
* @param {Mixed} currentColor Current value in css
* @param {number} mod Wanted brightness modification between -1 and 1
* @return {string} Like `'rgb(r,g,b)'`
*/
getColorBrightness: function ( currentColor, mod ) {
var rgbArr = $.colorUtil.getRGB( currentColor ),
hslArr = $.colorUtil.rgbToHsl(rgbArr[0], rgbArr[1], rgbArr[2] );
rgbArr = $.colorUtil.hslToRgb(hslArr[0], hslArr[1], hslArr[2] + mod);
return 'rgb(' +
[parseInt( rgbArr[0], 10), parseInt( rgbArr[1], 10 ), parseInt( rgbArr[2], 10 )].join( ',' ) +
')';
}
};
}( jQuery ) );