/*! * 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 ) );