Files

664 lines
21 KiB
JavaScript

/*!
* jQuery Color Animations v@VERSION
* https://github.com/jquery/jquery-color
*
* Copyright 2013 jQuery Foundation and other contributors
* Released under the MIT license.
* http://jquery.org/license
*
* Date: @DATE
*/
(function (jQuery, undefined) {
var stepHooks = "backgroundColor borderBottomColor borderLeftColor borderRightColor borderTopColor color columnRuleColor outlineColor textDecorationColor textEmphasisColor",
// plusequals test for += 100 -= 100
rplusequals = /^([\-+])=\s*(\d+\.?\d*)/,
// a set of RE's that can match strings and generate color tuples.
stringParsers = [{
re: /rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*(?:,\s*(\d?(?:\.\d+)?)\s*)?\)/,
parse: function (execResult) {
return [
execResult[1],
execResult[2],
execResult[3],
execResult[4]
];
}
}, {
re: /rgba?\(\s*(\d+(?:\.\d+)?)\%\s*,\s*(\d+(?:\.\d+)?)\%\s*,\s*(\d+(?:\.\d+)?)\%\s*(?:,\s*(\d?(?:\.\d+)?)\s*)?\)/,
parse: function (execResult) {
return [
execResult[1] * 2.55,
execResult[2] * 2.55,
execResult[3] * 2.55,
execResult[4]
];
}
}, {
// this regex ignores A-F because it's compared against an already lowercased string
re: /#([a-f0-9]{2})([a-f0-9]{2})([a-f0-9]{2})/,
parse: function (execResult) {
return [
parseInt(execResult[1], 16),
parseInt(execResult[2], 16),
parseInt(execResult[3], 16)
];
}
}, {
// this regex ignores A-F because it's compared against an already lowercased string
re: /#([a-f0-9])([a-f0-9])([a-f0-9])/,
parse: function (execResult) {
return [
parseInt(execResult[1] + execResult[1], 16),
parseInt(execResult[2] + execResult[2], 16),
parseInt(execResult[3] + execResult[3], 16)
];
}
}, {
re: /hsla?\(\s*(\d+(?:\.\d+)?)\s*,\s*(\d+(?:\.\d+)?)\%\s*,\s*(\d+(?:\.\d+)?)\%\s*(?:,\s*(\d?(?:\.\d+)?)\s*)?\)/,
space: "hsla",
parse: function (execResult) {
return [
execResult[1],
execResult[2] / 100,
execResult[3] / 100,
execResult[4]
];
}
}],
// jQuery.Color( )
color = jQuery.Color = function (color, green, blue, alpha) {
return new jQuery.Color.fn.parse(color, green, blue, alpha);
},
spaces = {
rgba: {
props: {
red: {
idx: 0,
type: "byte"
},
green: {
idx: 1,
type: "byte"
},
blue: {
idx: 2,
type: "byte"
}
}
},
hsla: {
props: {
hue: {
idx: 0,
type: "degrees"
},
saturation: {
idx: 1,
type: "percent"
},
lightness: {
idx: 2,
type: "percent"
}
}
}
},
propTypes = {
"byte": {
floor: true,
max: 255
},
"percent": {
max: 1
},
"degrees": {
mod: 360,
floor: true
}
},
support = color.support = {},
// element for support tests
supportElem = jQuery("<p>")[0],
// colors = jQuery.Color.names
colors,
// local aliases of functions called often
each = jQuery.each;
// determine rgba support immediately
supportElem.style.cssText = "background-color:rgba(1,1,1,.5)";
support.rgba = supportElem.style.backgroundColor.indexOf("rgba") > -1;
// define cache name and alpha properties
// for rgba and hsla spaces
each(spaces, function (spaceName, space) {
space.cache = "_" + spaceName;
space.props.alpha = {
idx: 3,
type: "percent",
def: 1
};
});
function clamp(value, prop, allowEmpty) {
var type = propTypes[prop.type] || {};
if (value == null) {
return (allowEmpty || !prop.def) ? null : prop.def;
}
// ~~ is an short way of doing floor for positive numbers
value = type.floor ? ~~value : parseFloat(value);
// IE will pass in empty strings as value for alpha,
// which will hit this case
if (isNaN(value)) {
return prop.def;
}
if (type.mod) {
// we add mod before modding to make sure that negatives values
// get converted properly: -10 -> 350
return (value + type.mod) % type.mod;
}
// for now all property types without mod have min and max
return 0 > value ? 0 : type.max < value ? type.max : value;
}
function stringParse(string) {
var inst = color(),
rgba = inst._rgba = [];
string = string.toLowerCase();
each(stringParsers, function (i, parser) {
var parsed,
match = parser.re.exec(string),
values = match && parser.parse(match),
spaceName = parser.space || "rgba";
if (values) {
parsed = inst[spaceName](values);
// if this was an rgba parse the assignment might happen twice
// oh well....
inst[spaces[spaceName].cache] = parsed[spaces[spaceName].cache];
rgba = inst._rgba = parsed._rgba;
// exit each( stringParsers ) here because we matched
return false;
}
});
// Found a stringParser that handled it
if (rgba.length) {
// if this came from a parsed string, force "transparent" when alpha is 0
// chrome, (and maybe others) return "transparent" as rgba(0,0,0,0)
if (rgba.join() === "0,0,0,0") {
jQuery.extend(rgba, colors.transparent);
}
return inst;
}
// named colors
return colors[string];
}
color.fn = jQuery.extend(color.prototype, {
parse: function (red, green, blue, alpha) {
if (red === undefined) {
this._rgba = [null, null, null, null];
return this;
}
if (red.jquery || red.nodeType) {
red = jQuery(red).css(green);
green = undefined;
}
var inst = this,
type = jQuery.type(red),
rgba = this._rgba = [];
// more than 1 argument specified - assume ( red, green, blue, alpha )
if (green !== undefined) {
red = [red, green, blue, alpha];
type = "array";
}
if (type === "string") {
return this.parse(stringParse(red) || colors._default);
}
if (type === "array") {
each(spaces.rgba.props, function (key, prop) {
rgba[prop.idx] = clamp(red[prop.idx], prop);
});
return this;
}
if (type === "object") {
if (red instanceof color) {
each(spaces, function (spaceName, space) {
if (red[space.cache]) {
inst[space.cache] = red[space.cache].slice();
}
});
} else {
each(spaces, function (spaceName, space) {
var cache = space.cache;
each(space.props, function (key, prop) {
// if the cache doesn't exist, and we know how to convert
if (!inst[cache] && space.to) {
// if the value was null, we don't need to copy it
// if the key was alpha, we don't need to copy it either
if (key === "alpha" || red[key] == null) {
return;
}
inst[cache] = space.to(inst._rgba);
}
// this is the only case where we allow nulls for ALL properties.
// call clamp with alwaysAllowEmpty
inst[cache][prop.idx] = clamp(red[key], prop, true);
});
// everything defined but alpha?
if (inst[cache] && jQuery.inArray(null, inst[cache].slice(0, 3)) < 0) {
// use the default of 1
inst[cache][3] = 1;
if (space.from) {
inst._rgba = space.from(inst[cache]);
}
}
});
}
return this;
}
},
is: function (compare) {
var is = color(compare),
same = true,
inst = this;
each(spaces, function (_, space) {
var localCache,
isCache = is[space.cache];
if (isCache) {
localCache = inst[space.cache] || space.to && space.to(inst._rgba) || [];
each(space.props, function (_, prop) {
if (isCache[prop.idx] != null) {
same = (isCache[prop.idx] === localCache[prop.idx]);
return same;
}
});
}
return same;
});
return same;
},
_space: function () {
var used = [],
inst = this;
each(spaces, function (spaceName, space) {
if (inst[space.cache]) {
used.push(spaceName);
}
});
return used.pop();
},
transition: function (other, distance) {
var end = color(other),
spaceName = end._space(),
space = spaces[spaceName],
startColor = this.alpha() === 0 ? color("transparent") : this,
start = startColor[space.cache] || space.to(startColor._rgba),
result = start.slice();
end = end[space.cache];
each(space.props, function (key, prop) {
var index = prop.idx,
startValue = start[index],
endValue = end[index],
type = propTypes[prop.type] || {};
// if null, don't override start value
if (endValue === null) {
return;
}
// if null - use end
if (startValue === null) {
result[index] = endValue;
} else {
if (type.mod) {
if (endValue - startValue > type.mod / 2) {
startValue += type.mod;
} else if (startValue - endValue > type.mod / 2) {
startValue -= type.mod;
}
}
result[index] = clamp((endValue - startValue) * distance + startValue, prop);
}
});
return this[spaceName](result);
},
blend: function (opaque) {
// if we are already opaque - return ourself
if (this._rgba[3] === 1) {
return this;
}
var rgb = this._rgba.slice(),
a = rgb.pop(),
blend = color(opaque)._rgba;
return color(jQuery.map(rgb, function (v, i) {
return (1 - a) * blend[i] + a * v;
}));
},
toRgbaString: function () {
var prefix = "rgba(",
rgba = jQuery.map(this._rgba, function (v, i) {
return v == null ? (i > 2 ? 1 : 0) : v;
});
if (rgba[3] === 1) {
rgba.pop();
prefix = "rgb(";
}
return prefix + rgba.join() + ")";
},
toHslaString: function () {
var prefix = "hsla(",
hsla = jQuery.map(this.hsla(), function (v, i) {
if (v == null) {
v = i > 2 ? 1 : 0;
}
// catch 1 and 2
if (i && i < 3) {
v = Math.round(v * 100) + "%";
}
return v;
});
if (hsla[3] === 1) {
hsla.pop();
prefix = "hsl(";
}
return prefix + hsla.join() + ")";
},
toHexString: function (includeAlpha) {
var rgba = this._rgba.slice(),
alpha = rgba.pop();
if (includeAlpha) {
rgba.push(~~(alpha * 255));
}
return "#" + jQuery.map(rgba, function (v) {
// default to 0 when nulls exist
v = (v || 0).toString(16);
return v.length === 1 ? "0" + v : v;
}).join("");
},
toString: function () {
return this._rgba[3] === 0 ? "transparent" : this.toRgbaString();
}
});
color.fn.parse.prototype = color.fn;
// hsla conversions adapted from:
// https://code.google.com/p/maashaack/source/browse/packages/graphics/trunk/src/graphics/colors/HUE2RGB.as?r=5021
function hue2rgb(p, q, h) {
h = (h + 1) % 1;
if (h * 6 < 1) {
return p + (q - p) * h * 6;
}
if (h * 2 < 1) {
return q;
}
if (h * 3 < 2) {
return p + (q - p) * ((2 / 3) - h) * 6;
}
return p;
}
spaces.hsla.to = function (rgba) {
if (rgba[0] == null || rgba[1] == null || rgba[2] == null) {
return [null, null, null, rgba[3]];
}
var r = rgba[0] / 255,
g = rgba[1] / 255,
b = rgba[2] / 255,
a = rgba[3],
max = Math.max(r, g, b),
min = Math.min(r, g, b),
diff = max - min,
add = max + min,
l = add * 0.5,
h, s;
if (min === max) {
h = 0;
} else if (r === max) {
h = (60 * (g - b) / diff) + 360;
} else if (g === max) {
h = (60 * (b - r) / diff) + 120;
} else {
h = (60 * (r - g) / diff) + 240;
}
// chroma (diff) == 0 means greyscale which, by definition, saturation = 0%
// otherwise, saturation is based on the ratio of chroma (diff) to lightness (add)
if (diff === 0) {
s = 0;
} else if (l <= 0.5) {
s = diff / add;
} else {
s = diff / (2 - add);
}
return [Math.round(h) % 360, s, l, a == null ? 1 : a];
};
spaces.hsla.from = function (hsla) {
if (hsla[0] == null || hsla[1] == null || hsla[2] == null) {
return [null, null, null, hsla[3]];
}
var h = hsla[0] / 360,
s = hsla[1],
l = hsla[2],
a = hsla[3],
q = l <= 0.5 ? l * (1 + s) : l + s - l * s,
p = 2 * l - q;
return [
Math.round(hue2rgb(p, q, h + (1 / 3)) * 255),
Math.round(hue2rgb(p, q, h) * 255),
Math.round(hue2rgb(p, q, h - (1 / 3)) * 255),
a
];
};
each(spaces, function (spaceName, space) {
var props = space.props,
cache = space.cache,
to = space.to,
from = space.from;
// makes rgba() and hsla()
color.fn[spaceName] = function (value) {
// generate a cache for this space if it doesn't exist
if (to && !this[cache]) {
this[cache] = to(this._rgba);
}
if (value === undefined) {
return this[cache].slice();
}
var ret,
type = jQuery.type(value),
arr = (type === "array" || type === "object") ? value : arguments,
local = this[cache].slice();
each(props, function (key, prop) {
var val = arr[type === "object" ? key : prop.idx];
if (val == null) {
val = local[prop.idx];
}
local[prop.idx] = clamp(val, prop);
});
if (from) {
ret = color(from(local));
ret[cache] = local;
return ret;
} else {
return color(local);
}
};
// makes red() green() blue() alpha() hue() saturation() lightness()
each(props, function (key, prop) {
// alpha is included in more than one space
if (color.fn[key]) {
return;
}
color.fn[key] = function (value) {
var vtype = jQuery.type(value),
fn = (key === "alpha" ? (this._hsla ? "hsla" : "rgba") : spaceName),
local = this[fn](),
cur = local[prop.idx],
match;
if (vtype === "undefined") {
return cur;
}
if (vtype === "function") {
value = value.call(this, cur);
vtype = jQuery.type(value);
}
if (value == null && prop.empty) {
return this;
}
if (vtype === "string") {
match = rplusequals.exec(value);
if (match) {
value = cur + parseFloat(match[2]) * (match[1] === "+" ? 1 : -1);
}
}
local[prop.idx] = value;
return this[fn](local);
};
});
});
// add cssHook and .fx.step function for each named hook.
// accept a space separated string of properties
color.hook = function (hook) {
var hooks = hook.split(" ");
each(hooks, function (i, hook) {
jQuery.cssHooks[hook] = {
set: function (elem, value) {
var parsed, curElem,
backgroundColor = "";
if (value !== "transparent" && (jQuery.type(value) !== "string" || (parsed = stringParse(value)))) {
value = color(parsed || value);
if (!support.rgba && value._rgba[3] !== 1) {
curElem = hook === "backgroundColor" ? elem.parentNode : elem;
while (
(backgroundColor === "" || backgroundColor === "transparent") &&
curElem && curElem.style
) {
try {
backgroundColor = jQuery.css(curElem, "backgroundColor");
curElem = curElem.parentNode;
} catch (e) {
}
}
value = value.blend(backgroundColor && backgroundColor !== "transparent" ?
backgroundColor :
"_default");
}
value = value.toRgbaString();
}
try {
elem.style[hook] = value;
} catch (e) {
// wrapped to prevent IE from throwing errors on "invalid" values like 'auto' or 'inherit'
}
}
};
jQuery.fx.step[hook] = function (fx) {
if (!fx.colorInit) {
fx.start = color(fx.elem, hook);
fx.end = color(fx.end);
fx.colorInit = true;
}
jQuery.cssHooks[hook].set(fx.elem, fx.start.transition(fx.end, fx.pos));
};
});
};
color.hook(stepHooks);
jQuery.cssHooks.borderColor = {
expand: function (value) {
var expanded = {};
each(["Top", "Right", "Bottom", "Left"], function (i, part) {
expanded["border" + part + "Color"] = value;
});
return expanded;
}
};
// Basic color names only.
// Usage of any of the other color names requires adding yourself or including
// jquery.color.svg-names.js.
colors = jQuery.Color.names = {
// 4.1. Basic color keywords
aqua: "#00ffff",
black: "#000000",
blue: "#0000ff",
fuchsia: "#ff00ff",
gray: "#808080",
green: "#008000",
lime: "#00ff00",
maroon: "#800000",
navy: "#000080",
olive: "#808000",
purple: "#800080",
red: "#ff0000",
silver: "#c0c0c0",
teal: "#008080",
white: "#ffffff",
yellow: "#ffff00",
// 4.2.3. "transparent" color keyword
transparent: [null, null, null, 0],
_default: "#ffffff"
};
}(jQuery));