Merge "Display "Printable version" links in toolbox on special pages"
[lhc/web/wiklou.git] / resources / jquery / jquery.colorUtil.js
index 39c4fc2..9c6f9ec 100644 (file)
@@ -1,23 +1,23 @@
-/*
+/**
  * jQuery Color Utilities
  * Written by Krinkle in 2011
  * Released under the MIT and GPL licenses.
- * Mostly based on other plugins and functions (taken through JSLint and optimized a little).
- * Sources cited locally.
+ * Mostly based on other plugins and functions (linted and optimized a little).
+ * Sources cited inline.
  */
-( function( $ ) {
-
+( function ( $ ) {
        $.colorUtil = {
 
                // Color Conversion function from highlightFade
                // By Blair Mitchelmore
                // http://jquery.offput.ca/highlightFade/
                // Parse strings looking for color tuples [255,255,255]
-               getRGB : function( color ) {
+               getRGB : function ( color ) {
+                       /*jshint boss:true */
                        var result;
 
                        // Check if we're already dealing with an array of colors
-                       if ( color && color.constructor == Array && color.length == 3 ){
+                       if ( color && $.isArray( color ) && color.length === 3 ) {
                                return color;
                        }
 
                        }
 
                        // Otherwise, we're most likely dealing with a named color
-                       return $.colorUtil.colors[jQuery.trim(color).toLowerCase()];
+                       return $.colorUtil.colors[$.trim(color).toLowerCase()];
                },
 
                // Some named colors to work with
                // From Interface by Stefan Petre
                // http://interface.eyecon.ro/
                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],
+                       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]
                },
+
                /**
                 * http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript
                 * Converts an RGB color value to HSL. Conversion formula
                 * @param       Number  B               The blue color value
                 * @return      Array                   The HSL representation
                 */
-               rgbToHsl: function( R, G, B ) {
-                       var     r = R / 255,
+               rgbToHsl: function ( R, G, B ) {
+                       var d,
+                               r = R / 255,
                                g = G / 255,
-                               b = B / 255;
-                       var max = Math.max(r, g, b), min = Math.min(r, g, b);
-                       var h, s, l = (max + min) / 2;
-
-                       if(max == min){
-                               h = s = 0; // achromatic
-                       }else{
-                               var d = max - min;
+                               b = B / 255,
+                               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;
+                               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];
                },
+
                /**
                 * http://mjijackson.com/2008/02/rgb-to-hsl-and-rgb-to-hsv-color-model-conversion-algorithms-in-javascript
                 * Converts an HSL color value to RGB. Conversion formula
                 * @param       Number  l               The lightness
                 * @return      Array                   The RGB representation
                 */
-               hslToRgb: function( h, s, l ) {
-                       var r, g, b;
+               hslToRgb: function ( h, s, l ) {
+                       var r, g, b, hue2rgb, q, p;
 
-                       if(s === 0){
+                       if ( s === 0 ) {
                                r = g = b = l; // achromatic
-                       }else{
-                               var 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; }
+                       } 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;
                                };
 
-                               var q = l < 0.5 ? l * (1 + s) : l + s - l * s;
-                               var p = 2 * l - q;
-                               r = hue2rgb(p, q, h + 1/3);
-                               g = hue2rgb(p, q, h);
-                               b = hue2rgb(p, q, h - 1/3);
+                               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's a brighter or darker rgb() value string.
                 *
                 * @param       Number  mod wanted brightness modification between -1 and 1
                 * @return      String 'rgb(r,g,b)'
                 */
-               getColorBrightness: function( currentColor, mod ) {
-                       var     rgbArr = $.colorUtil.getRGB( currentColor ),
+               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 );
\ No newline at end of file
+}( jQuery ) );