{"_id":"jquery-color","_rev":"20-deb6144c3b9ca5117d4984a340e60fac","name":"jquery-color","dist-tags":{"beta":"3.0.0","latest":"3.0.0"},"versions":{"1.0.0":{"name":"jquery-color","version":"1.0.0","author":{"name":"jquery"},"_id":"jquery-color@1.0.0","maintainers":[{"name":"znetstar","email":"admin@znetstar.net"}],"dist":{"shasum":"003aba988a6f2d21d963d1f2eeeb6cdbc80471f1","tarball":"https://registry.npmjs.org/jquery-color/-/jquery-color-1.0.0.tgz","integrity":"sha512-BbCnUFbtYLS4ZeI+lNkP8Ff9/BYdNOov1f4wPxH15LzBhKt6i/RVmuPsvsy1oVfUyFBbg2LuN5z3XzGLA/EvZg==","signatures":[{"sig":"MEUCIQCvBq3kNtjYR39mm+k8ut1S+jfH1VExvfCswiS1Zg3eCwIgcalSPL7IUldShsE3k/fu9YwksiH2tG/4zk0jFA0fJAg=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}]},"main":"./require.js","ender":"./require.js","engines":{"node":"*"},"_npmUser":{"name":"znetstar","email":"admin@znetstar.net"},"repository":{"url":"git://github.com/znetstar/jquery-color.git","type":"git"},"_npmVersion":"1.1.9","description":"A jQuery plugin that adds color animation support.","directories":{},"_nodeVersion":"v0.6.12","dependencies":{"jQuery":"latest"},"_defaultsLoaded":true,"devDependencies":{},"_engineSupported":true,"optionalDependencies":{}},"3.0.0-alpha.1":{"name":"jquery-color","version":"3.0.0-alpha.1","keywords":["color","animation","jquery-plugin"],"author":{"url":"https://github.com/jquery/jquery-color/blob/3.0.0-alpha.1/AUTHORS.txt","name":"jQuery Foundation and other contributors"},"license":"MIT","_id":"jquery-color@3.0.0-alpha.1","maintainers":[{"name":"gnarf","email":"gnarf37@gmail.com"},{"name":"leobalter","email":"leonardo.balter@gmail.com"},{"name":"mgol","email":"m.goleb@gmail.com"}],"homepage":"https://github.com/jquery/jquery-color","bugs":{"url":"https://github.com/jquery/jquery-color/issues"},"dist":{"shasum":"0c00ed91251bac45fc4ff3143939f434ef46d188","tarball":"https://registry.npmjs.org/jquery-color/-/jquery-color-3.0.0-alpha.1.tgz","integrity":"sha512-UjsdBsWuehWLfnXfL4JZtxGbRB2eUz6Rhn3qxBKaVR3Qwm7fQlY1y/Va0o7GzDwGJnOvYKc3H+i2k7bC1yGcJg==","signatures":[{"sig":"MEYCIQDMwhyJtfr3YwbD1px8G0MGwqpb7xkqDezV4mK/nSsHgQIhAI5Yy/Kaa2BAwqQ+MAU5eXr8pA1HazeGSsZcMFkNkzfU","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}]},"main":"dist/jquery.color.js","files":["dist","README.md","AUTHORS.txt","LICENSE.txt"],"title":"jQuery Color","gitHead":"46d71af2cc92e1d5269f7fa7a1f0226fc5b80aad","scripts":{"ci":"grunt ci","test":"grunt ci","browserstack":"sh build/run-browserstack.sh"},"_npmUser":{"name":"mgol","email":"m.goleb@gmail.com"},"repository":{"url":"git://github.com/jquery/jquery-color.git","type":"git"},"_npmVersion":"5.6.0","description":"jQuery plugin for color manipulation and animation support.","directories":{},"_nodeVersion":"8.9.4","commitplease":{"components":["All","Build","Core","Readme","Test"]},"dependencies":{},"devDependencies":{"grunt":"1.0.1","grunt-cli":"1.2.0","testswarm":"1.1.0","commitplease":"2.7.10","grunt-eslint":"20.1.0","grunt-bowercopy":"1.2.4","load-grunt-tasks":"3.5.2","grunt-git-authors":"3.2.0","grunt-compare-size":"0.4.2","browserstack-runner":"0.7.0","grunt-contrib-qunit":"2.0.0","eslint-config-jquery":"1.0.1","grunt-contrib-concat":"1.0.1","grunt-contrib-uglify":"3.3.0"},"peerDependencies":{"jquery":">=1.11.0"},"_npmOperationalInternal":{"tmp":"tmp/jquery-color-3.0.0-alpha.1.tgz_1517416198960_0.8340115246828645","host":"s3://npm-registry-packages"}},"2.2.0":{"name":"jquery-color","version":"2.2.0","keywords":["color","animation","jquery-plugin"],"author":{"url":"https://github.com/jquery/jquery-color/blob/2.2.0/AUTHORS.txt","name":"OpenJS Foundation and other contributors"},"license":"MIT","_id":"jquery-color@2.2.0","maintainers":[{"name":"gnarf","email":"gnarf37@gmail.com"},{"name":"leobalter","email":"leonardo.balter@gmail.com"},{"name":"mgol","email":"m.goleb@gmail.com"}],"homepage":"https://github.com/jquery/jquery-color","bugs":{"url":"https://github.com/jquery/jquery-color/issues"},"dist":{"shasum":"2596bb782b69d9368b7840e6b3fe1e70fdd821c3","tarball":"https://registry.npmjs.org/jquery-color/-/jquery-color-2.2.0.tgz","fileCount":10,"integrity":"sha512-4VoxsLMw860EQGNT/TmP3Lbr7/1OCQlBPS4ILj7bxRApJrPQfpqzdIOTY8Ll9nGY7UHtWqDuzR7cUcS1lcWjVw==","signatures":[{"sig":"MEUCIH2GyQyXbG5zWYIQ5knf0+ZvXdw41gAgKax86RJkoycCAiEAlDPyI+ToQ0g57KmxtXgCEoJmm8vCfCIXelNrwu2pqn0=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":75611,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeuAFlCRA9TVsSAnZWagAA+pQP/1gmeXBPpPETKfu1Vn5B\nFmkNrAmb/FQOQ49ugjN1V4G5EcK1WJUiFiob7xp3yEALbKWJ/ze2lx/JlYMK\nEzgFsiooXXbnMnfhzY2dbaZQX61mfBmIegrRblbdCS2xoqb0eLubNCb9UvIL\nWjyMKFgZO31IUg4iYckbBPajLn1qoGTR2Dr2GmkLG/ihGzBTHAPYzwXztdcZ\njWbl34j++XtVrJbaQkPcgR5w3OqsVxfhL5EP86xhI8fezeCOvb9KRK0GOX/Q\nbyOOVA3MpFemJ35emri9ETpLeMLxcioTxzhQ1FX1Onv+SsRPgPBesYLm5Jj6\nS0qTIxdL7i3VN3XrOmC7w0IJ+rFyHd/LEOPUNIYU7w2ipZIZ3JFWbG7OZbfH\nGSHWkRJchamhvLJHYjb3oJ8zKB6szo6drl3n4FmJtS20nXzafK7mVFMz101Z\nBX8qovMDewMCQH+5NSUPTCHeD92rwRuDRMRrHxNiOmSpZHtdRId8GppT1Bs3\nhTzaCOMzEuvEPSjVRg0JtYfU6/yrH3wlwRmo0Y7el6iUzUabBjqILHxe6W2v\noSMRdUmIg8+SFZY5cbXakmyLI120uWQiYSE1k5jph05jWzNKbeaVCg9cyGvx\nziCtwSmCs8B2RZVvS5bPZf66DTZI6O6jRowoUq2jPqKuDc0d6iVrZ58zWI68\nFdg0\r\n=2p8A\r\n-----END PGP SIGNATURE-----\r\n"},"main":"dist/jquery.color.js","title":"jQuery Color","gitHead":"65cf228551a58627915df094827bccaafa8292e2","scripts":{"ci":"grunt ci","test":"grunt ci"},"_npmUser":{"name":"mgol","email":"m.goleb@gmail.com"},"repository":{"url":"git://github.com/jquery/jquery-color.git","type":"git"},"_npmVersion":"6.14.4","description":"jQuery plugin for color manipulation and animation support.","directories":{},"_nodeVersion":"12.16.3","commitplease":{"components":["All","Build","Core","Readme","Test"]},"dependencies":{},"_hasShrinkwrap":false,"devDependencies":{"grunt":"1.1.0","grunt-cli":"1.3.2","testswarm":"1.1.0","commitplease":"3.2.0","grunt-eslint":"22.0.0","grunt-bowercopy":"1.2.5","load-grunt-tasks":"5.1.0","grunt-git-authors":"3.2.0","grunt-compare-size":"0.4.2","grunt-contrib-qunit":"3.1.0","eslint-config-jquery":"3.0.0","grunt-contrib-concat":"1.0.1","grunt-contrib-uglify":"4.0.1"},"peerDependencies":{"jquery":">=1.11.0"},"_npmOperationalInternal":{"tmp":"tmp/jquery-color_2.2.0_1589117285466_0.10767167701402536","host":"s3://npm-registry-packages"}},"3.0.0-alpha.2":{"name":"jquery-color","version":"3.0.0-alpha.2","keywords":["color","animation","jquery-plugin"],"author":{"url":"https://github.com/jquery/jquery-color/blob/3.0.0-alpha.2/AUTHORS.txt","name":"OpenJS Foundation and other contributors"},"license":"MIT","_id":"jquery-color@3.0.0-alpha.2","maintainers":[{"name":"gnarf","email":"gnarf37@gmail.com"},{"name":"leobalter","email":"leonardo.balter@gmail.com"},{"name":"mgol","email":"m.goleb@gmail.com"}],"homepage":"https://github.com/jquery/jquery-color","bugs":{"url":"https://github.com/jquery/jquery-color/issues"},"dist":{"shasum":"9ab2917d381162e85f4a9548cab398fd1e21b4ff","tarball":"https://registry.npmjs.org/jquery-color/-/jquery-color-3.0.0-alpha.2.tgz","fileCount":16,"integrity":"sha512-dG5Y4YO/SQ7tgMYQjEu8zqFqx6gzrZyXhObGRIJkprBCaMsuH6vpxjXclK4d3qwkp1XZBlyOuf5Hv5Spjoy2aw==","signatures":[{"sig":"MEUCIQDm1NKprxA85Pr+zKG0reFry+ABBHXpVI4DkByiofnR0AIgfTwsmVtfg/SNsFFJg1JXA0U+0WJTWWv+lj3s2V1orD4=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":131490,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJeuTd3CRA9TVsSAnZWagAATg4P/iWqX1D3f9ytoETZtlOv\n0TPQMSG6D0KvHgJpy6MTccMx/lES9DdrUEjgltoPnbzBtX4wvT67iIeMbAKX\nWi6NkIBG2Lqc09M0Cr0V/2xqrQEPPXlXDsbJOU/CWl4jllzGMKfq1wkV/JRm\nuCuvCi8thcWql9txDDqQM1Rp5eYg+Oh5KiGaOIR7c4ii0OFMjHlpA6zODmTy\nCyerfcxS2ZIs2hF9cMLrSC/Yz4ZiQHvOS7fb2EL68GxJd6EM0oAK+X4SOWSj\npzoW/JrVA4kCSYNRVYWAp7U2IyOd/mJOXNOywFgfzZh5s8F9bpWSPDWDu8bN\nBUK6IhHHgNIIMeRICfIC3C9fA4PJs3DNyzOESpUJtEWUquYIz3wWQavnmt7A\nhODjJejs1TEI6mpBY/feMc3z7F0sqU0dw84vZpOa3MFERGkmMKcWoyNmVgSe\nAxsOvAoYBXgFqfQhA+yxZiquhRLit1V4XJ5dMB5YgKj94WiP6uSQw1NeTyY+\nDVo9kRvdPPANc6z+aHU8ijyPAtWpoLmJumhmHKwjECHgnPA+Uy/CYT2ud9LN\np2RU7WpVcz17kTrecw0k8dE2Jt7CA51oxx8uYboEcQ1QF5LJJdtIihr5F946\n+r2717yLcRnCafHr8V65SCMP8HFVMhxfhfTKMzzeUdptIrjzTQYtZ6mKthK9\nUU2d\r\n=EqYk\r\n-----END PGP SIGNATURE-----\r\n"},"main":"dist/jquery.color.js","title":"jQuery Color","readme":"[![Build Status](http://jenkins.jquery.com/job/jQuery%20Color/badge/icon)](http://jenkins.jquery.com/job/jQuery%20Color/)\n\n# jQuery Color\n\nSupported jQuery versions: 1.7+\n\n## Browser Support\n\njQuery Color 3.x supports the following browsers:\n\nDesktop:\n* Chrome: (Current - 1) and Current\n* Edge: (Current - 1) and Current, 18\n* Firefox: (Current - 1) and Current, ESR\n* Internet Explorer: 9+\n* Safari: (Current - 1) and Current\n* Opera: Current\n\nMobile:\n* Chrome on Android: (Current - 1) and Current\n* Safari on iOS: (Current - 2), (Current - 1) and Current\n\nInformation on browser support of jQuery Color 2.x can be found in the [Browser Support section](https://github.com/jquery/jquery-color/blob/2.x-stable/README.md#browser-support) in its README.\n\n## Using jQuery Color in Production\nWe release jQuery Color by itself, or in a bundle. The extended names can be included as a jQuery Color plugin, or you can download the version of jQuery Color that includes the names. Choose your build from the following list:\n\n**Current version: 2.1.2**\n\n* jQuery Color [Compressed](http://code.jquery.com/color/jquery.color-2.1.2.min.js) [Uncompressed](http://code.jquery.com/color/jquery.color-2.1.2.js)\n* jQuery Color Extended Names [Compressed](http://code.jquery.com/color/jquery.color.svg-names-2.1.2.min.js) [Uncompressed](http://code.jquery.com/color/jquery.color.svg-names-2.1.2.js)\n* jQuery Color & Extended Names(previous two combined) [Compressed](http://code.jquery.com/color/jquery.color.plus-names-2.1.2.min.js) [Uncompressed](http://code.jquery.com/color/jquery.color.plus-names-2.1.2.js)\n\n## How to build and test jQuery Color\n\nFirst, get a copy of the git repo by running:\n\n```shell\ngit clone git://github.com/jquery/jquery-color.git\n```\n\nEnter the directory and install the node dependencies:\n\n```shell\ncd jquery-color && npm install\n```\n\nMake sure you have `grunt` installed by testing:\n\n```shell\ngrunt -version\n```\n\nIf not, run:\n\n```shell\nnpm install -g grunt\n```\n\nTo run tests locally, run `grunt`, and this will run the tests in PhantomJS.\n\nYou can also run the tests in a browser by navigating to the `test/` directory.\n\n## Animated colors\n\nThis plugins installs a [`cssHook`](http://api.jquery.com/jQuery.cssHooks/) which allows jQuery's [`.animate()`](http://api.jquery.com/animate) to animate between two colors.\n\n## Supported properties\n`backgroundColor`, `borderBottomColor`, `borderLeftColor`, `borderRightColor`, `borderTopColor`, `color`, `columnRuleColor`, `outlineColor`, `textDecorationColor`, `textEmphasisColor`\n\n## Example use\n\n```html\n\n\n\n\n\n\n\n\n\n\n
Hello!
\n\n\n\n```\n\n## Supporting other properties\nThe `jQuery.Color.hook()` function can be called to support additional css properties as colors, and allow them to be animated.\n\n## Example use\n```javascript\n// we want to animate SVG fill and stroke properties\njQuery.Color.hook( \"fill stroke\" );\n```\n\n## The jQuery.Color Factory\n\nThe `jQuery.Color()` function allows you to create and manipulate color objects that are accepted by jQuery's `.animate()` and `.css()` functions.\n\n* Returns a new Color object, similar to `jQuery()` or `jQuery.Event`\n* Accepts many formats to create a new Color object with a `jQuery.Color.fn` prototype\n\n### Example uses:\n\n```javascript\n// Parsing String Colors:\njQuery.Color( \"#abcdef\" );\njQuery.Color( \"rgb(100, 200, 255)\" );\njQuery.Color( \"rgba(100, 200, 255, 0.5)\" );\njQuery.Color( \"aqua\" );\n\n// Creating Color Objects in Code:\n// use null or undefined for values you wish to leave out\njQuery.Color( red, green, blue, alpha );\njQuery.Color([ red, green, blue, alpha ]);\njQuery.Color({ red: red, green: green, blue: blue, alpha: alpha });\njQuery.Color({ hue: hue, saturation: saturation, lightness: lightness, alpha: alpha });\n\n// Helper to get value from CSS\njQuery.Color( element, cssProperty );\n```\n## jQuery.Color.fn / prototype / the Color Object methods\n\n### Getters / Setters:\n\n```javascript\nred() // returns the \"red\" component of the color ( Integer from 0 - 255 )\nred( val ) // returns a copy of the color object with the red set to val\ngreen() // returns the \"green\" component of the color from ( Integer from 0 - 255 )\ngreen( val ) // returns a copy of the color object with the green set to val\nblue() // returns the \"blue\" component of the color from ( Integer from 0 - 255 )\nblue( val ) // returns a copy of the color object with the blue set to val\nalpha() // returns the \"alpha\" component of the color from ( Float from 0.0 - 1.0 )\nalpha( val ) // returns a copy of the color object with the alpha set to val\nhue() // returns the \"hue\" component of the color ( Integer from 0 - 359 )\nhue( val ) // returns a copy of the color object with the hue set to val\nsaturation() // returns the \"saturation\" component of the color ( Float from 0.0 - 1.0 )\nsaturation( val ) // returns a copy of the color object with the saturation set to val\nlightness() // returns the \"lightness\" component of the color ( Float from 0.0 - 1.0 )\nlightness( val ) // returns a copy of the color object with the lightness set to val\n// all of the above values can also take strings in the format of \"+=100\" or \"-=100\"\n\nrgba() // returns a rgba \"tuple\" [ red, green, blue, alpha ]\n// rgba() setters: returns a copy of the color with any defined values set to the new value\nrgba( red, green, blue, alpha )\nrgba( { red: red, green: green, blue: blue, alpha: alpha } )\nrgba( [ red, green, blue, alpha ] )\n\nhsla() // returns a HSL tuple [ hue, saturation, lightness, alpha ]\n// much like the rgb setter - returns a copy with any defined values set\nhsla( hue, saturation, lightness, alpha )\nhsla( { hue: hue, saturation: saturation, lightness: lightness, alpha: alpha } )\nhsla( [ hue, saturation, lightness, alpha ] )\n```\n\n### String methods\n\n```javascript\ntoRgbaString() // returns a css string \"rgba(255, 255, 255, 0.4)\"\ntoHslaString() // returns a css string \"hsla(330, 75%, 25%, 0.4)\"\ntoHexString( includeAlpha ) // returns a css string \"#abcdef\", with \"includeAlpha\" uses \"#rrggbbaa\" (alpha *= 255)\n```\n\nThe `toRgbaString` and `toHslaString` methods will only include the alpha channel if it is not `1`. They will return `rgb(...)` and `hsl(...)` strings if the alpha is set to `1`. \n### Working with other colors:\n\n```javascript\ntransition( othercolor, distance ) // the color distance ( 0.0 - 1.0 ) of the way between this color and othercolor\nblend( othercolor ) // Will apply this color on top of the other color using alpha blending\nis( othercolor ) // Will determine if this color is equal to all defined properties of othercolor\n```\n\n## jQuery.Color properties\n\n\n## Internals on The Color Object\n* Internally, RGBA values are stored as `color._rgba[0] = red, color._rgba[1] = green, color._rgba[2] = blue, color._rgba[3] = alpha`. However, please remember there are nice convenient setters and getters for each of these properties.\n* `undefined`/`null` values for colors indicate non-existence. This signals the `transition()` function to keep whatever value was set in the other end of the transition. For example, animating to `jQuery.Color([ 255, null, null, 1 ])` would only animate the red and alpha values of the color.\n\n### `jQuery.Color.names`\n\nA list of named colors is stored on the `jQuery.Color.names` object. The value they contain should be parseable by `jQuery.Color()`. All names on this object should be lowercased. I.E. `jQuery.Color(\"Red\")` is the same as doing `jQuery.Color( jQuery.Color.names[\"red\"] );`\n\nThere is also a named color `\"_default\"` which by default is white, this is used for situations where a color is unparseable.\n\n### `\"transparent\"`\n\nA special note about the color `\"transparent\"` - It returns `null` for red green and blue unless you specify colors for these values.\n\n```javascript\njQuery.Color( \"#abcdef\" ).transition( \"transparent\", 0.5 )\n```\n\nAnimating to or from the value `\"transparent\"` will still use \"#abcdef\" for red green and blue.\n\n## HSLA Support\n\nIf a color is created using any of the HSLA functions or parsers, it will keep the `_rgba` array up to date as well as having a `_hsla` array. Once an RGBA operation is performed on HSLA, however, the `_hsla` cache is removed and all operations will continue based off of rgb (unless you go back into HSLA). The `._hsla` array follows the same format as `._rbga`, `[hue, saturation, lightness, alpha ]`. If you need to build an HSLA color from an HSLA array, `jQuery.Color().hsla( array )` works for that purpose.\n\n**Colors with 0 saturation, or 100%/0% lightness will be stored with a hue of 0**\n\n## Extensibility\n\nIt is possible for you to add your own functions to the color object. For instance, this function will tell you if its better to use black or white on a given background color.\n\n\n```javascript\n// method taken from https://gist.github.com/960189\njQuery.Color.fn.contrastColor = function() {\n\tvar r = this._rgba[ 0 ], g = this._rgba[ 1 ], b = this._rgba[ 2 ];\n\treturn ( ( ( r * 299 ) + ( g * 587 ) + ( b * 144 ) ) / 1000 ) >= 131.5 ? \"black\" : \"white\";\n};\n\n// usage examples:\njQuery.Color( \"#bada55\" ).contrastColor(); // \"black\"\nelement.css( \"color\", jQuery.Color( element, \"backgroundColor\" ).contrastColor() );\n```\n","gitHead":"6e0406bb571ecea928446b2a778a68adcec3559f","scripts":{"ci":"grunt ci","test":"grunt ci","browserstack":"sh build/run-browserstack.sh"},"_npmUser":{"name":"mgol","email":"m.goleb@gmail.com"},"repository":{"url":"git://github.com/jquery/jquery-color.git","type":"git"},"_npmVersion":"6.14.4","description":"jQuery plugin for color manipulation and animation support.","directories":{},"_nodeVersion":"12.16.3","commitplease":{"components":["All","Build","Core","Readme","Test"]},"dependencies":{},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"grunt":"1.1.0","grunt-cli":"1.3.2","testswarm":"1.1.0","commitplease":"3.2.0","grunt-eslint":"22.0.0","grunt-bowercopy":"1.2.5","load-grunt-tasks":"5.1.0","grunt-git-authors":"3.2.0","grunt-compare-size":"0.4.2","browserstack-runner":"0.9.1","grunt-contrib-qunit":"3.1.0","eslint-config-jquery":"3.0.0","grunt-contrib-concat":"1.0.1","grunt-contrib-uglify":"4.0.1"},"peerDependencies":{"jquery":">=1.11.0"},"_npmOperationalInternal":{"tmp":"tmp/jquery-color_3.0.0-alpha.2_1589196662140_0.9529461513993751","host":"s3://npm-registry-packages"}},"3.0.0":{"name":"jquery-color","version":"3.0.0","keywords":["color","animation","jquery-plugin","ecosystem:jquery"],"author":{"url":"https://github.com/jquery/jquery-color/blob/3.0.0/AUTHORS.txt","name":"OpenJS Foundation and other contributors"},"license":"MIT","_id":"jquery-color@3.0.0","maintainers":[{"name":"leobalter","email":"leonardo.balter@gmail.com"},{"name":"gnarf","email":"gnarf37@gmail.com"},{"name":"mgol","email":"m.goleb@gmail.com"},{"name":"openjsfoundation","email":"npm@openjsf.org"}],"homepage":"https://github.com/jquery/jquery-color","bugs":{"url":"https://github.com/jquery/jquery-color/issues"},"dist":{"shasum":"c876abbeeee32ad48cedfc5e5447011824ad2b45","tarball":"https://registry.npmjs.org/jquery-color/-/jquery-color-3.0.0.tgz","fileCount":16,"integrity":"sha512-TbyqpkxEfVq9K/eUn4jW14YnJn19dORJrplJ3vo9jgLrqnuOyH6gyv8yDZdYcERlrVVDub4HV5r2t5KGjcvbKg==","signatures":[{"sig":"MEQCIE6USy4o23rxeRzDVkb6RwepaG7jMZRCWvp8LKZDQoQUAiBhTxcsB97OkM1Oi06jA4i9SQGAYKJpq5xMhxZUt7zh+Q==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":131360},"main":"dist/jquery.color.js","type":"commonjs","title":"jQuery Color","gitHead":"df75d29fc2337b8ce3321c37f3c8654eb83b293c","scripts":{"test":"grunt && npm run test:unit -- -h","build":"grunt","test:unit":"node test/runner/command.js","test:server":"node test/runner/server.js"},"_npmUser":{"name":"mgol","email":"m.goleb@gmail.com"},"repository":{"url":"git://github.com/jquery/jquery-color.git","type":"git"},"_npmVersion":"10.5.2","description":"jQuery plugin for color manipulation and animation support.","directories":{},"_nodeVersion":"20.13.0","commitplease":{"components":["All","Build","Core","Readme","Test"]},"_hasShrinkwrap":false,"devDependencies":{"diff":"5.2.0","chalk":"5.3.0","grunt":"1.6.1","qunit":"2.20.1","yargs":"17.7.2","jquery":"3.7.1","express":"4.19.2","globals":"15.2.0","exit-hook":"4.0.0","body-parser":"1.20.2","commitplease":"3.2.0","grunt-eslint":"25.0.0","jquery-2.2.4":"npm:jquery@2.2.4","jquery-3.0.0":"npm:jquery@3.0.0","jquery-3.1.1":"npm:jquery@3.1.1","jquery-3.2.1":"npm:jquery@3.2.1","jquery-3.3.1":"npm:jquery@3.3.1","jquery-3.4.1":"npm:jquery@3.4.1","jquery-3.5.1":"npm:jquery@3.5.1","jquery-3.6.4":"npm:jquery@3.6.4","jquery-3.7.1":"npm:jquery@3.7.1","grunt-npmcopy":"0.2.0","jquery-1.12.4":"npm:jquery@1.12.4","load-grunt-tasks":"5.1.0","grunt-git-authors":"3.2.0","browserstack-local":"1.5.5","grunt-compare-size":"0.4.2","selenium-webdriver":"4.20.0","eslint-config-jquery":"3.0.2","grunt-contrib-concat":"2.1.0","grunt-contrib-uglify":"5.2.2","@types/selenium-webdriver":"4.1.22","express-body-parser-error-handler":"1.0.7"},"peerDependencies":{"jquery":">=1.12.0"},"_npmOperationalInternal":{"tmp":"tmp/jquery-color_3.0.0_1715787184757_0.16884878272312198","host":"s3://npm-registry-packages"}}},"time":{"created":"2012-03-18T19:13:05.799Z","modified":"2026-05-20T00:48:56.098Z","1.0.0":"2012-03-18T19:13:06.287Z","3.0.0-alpha.1":"2018-01-31T16:30:01.209Z","2.2.0":"2020-05-10T13:28:05.603Z","3.0.0-alpha.2":"2020-05-11T11:31:02.323Z","3.0.0":"2024-05-15T15:33:04.907Z"},"bugs":{"url":"https://github.com/jquery/jquery-color/issues"},"author":{"url":"https://github.com/jquery/jquery-color/blob/3.0.0/AUTHORS.txt","name":"OpenJS Foundation and other contributors"},"license":"MIT","homepage":"https://github.com/jquery/jquery-color","keywords":["color","animation","jquery-plugin","ecosystem:jquery"],"repository":{"url":"git://github.com/jquery/jquery-color.git","type":"git"},"description":"jQuery plugin for color manipulation and animation support.","maintainers":[{"email":"gnarf37@gmail.com","name":"gnarf"},{"email":"m.goleb@gmail.com","name":"mgol"},{"email":"npm@openjsf.org","name":"openjsfoundation"}],"readme":"# jQuery Color\n\nSupported jQuery versions: 1.12+ (only the latest version within each jQuery major is tested)\n\n## Browser Support\n\njQuery Color 3.x supports the following browsers:\n* Chrome: Current\n* Edge: Current\n* Firefox: Current\n* Safari: Current\n\nOther browsers may also work correctly with this plugin but support is not guaranteed.\n\nInformation on browser support of jQuery Color 2.x can be found in the [Browser Support section](https://github.com/jquery/jquery-color/blob/2.x-stable/README.md#browser-support) in its README.\n\n## Using jQuery Color in Production\n\nWe release jQuery Color by itself, or in a bundle. The extended names can be included as a jQuery Color plugin, or you can download the version of jQuery Color that includes the names. Choose your version & build from the list at https://releases.jquery.com/color/.\n\n## How to build and test jQuery Color\n\nFirst, [clone the jQuery Color git repo](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository).\n\nEnter the directory and install the node dependencies:\n\n```shell\ncd jquery-color && npm install\n```\n\nTo build and test jQuery Color, run:\n```\nnpm test\n```\n\n## Animated colors\n\nThis plugin installs a [`cssHook`](https://api.jquery.com/jQuery.cssHooks/) which allows jQuery's [`.animate()`](https://api.jquery.com/animate) to animate between two colors.\n\n## Supported properties\n`backgroundColor`, `borderBottomColor`, `borderLeftColor`, `borderRightColor`, `borderTopColor`, `color`, `columnRuleColor`, `outlineColor`, `textDecorationColor`, `textEmphasisColor`\n\n## Example use\n\n```html\n\n\n\njQuery Color demo\n\n\n\n\n\n\n\n
Hello!
\n\n\n\n```\n\n## Supporting other properties\nThe `jQuery.Color.hook()` function can be called to support additional css properties as colors, and allow them to be animated.\n\n## Example use\n```javascript\n// we want to animate SVG fill and stroke properties\njQuery.Color.hook( \"fill stroke\" );\n```\n\n## The jQuery.Color Factory\n\nThe `jQuery.Color()` function allows you to create and manipulate color objects that are accepted by jQuery's `.animate()` and `.css()` functions.\n\n* Returns a new Color object, similar to `jQuery()` or `jQuery.Event`\n* Accepts many formats to create a new Color object with a `jQuery.Color.fn` prototype\n\n### Example uses:\n\n```javascript\n// Parsing String Colors:\njQuery.Color( \"#abcdef\" );\njQuery.Color( \"rgb(100, 200, 255)\" );\njQuery.Color( \"rgba(100, 200, 255, 0.5)\" );\njQuery.Color( \"aqua\" );\n\n// Creating Color Objects in Code:\n// use null or undefined for values you wish to leave out\njQuery.Color( red, green, blue, alpha );\njQuery.Color([ red, green, blue, alpha ]);\njQuery.Color({ red: red, green: green, blue: blue, alpha: alpha });\njQuery.Color({ hue: hue, saturation: saturation, lightness: lightness, alpha: alpha });\n\n// Helper to get value from CSS\njQuery.Color( element, cssProperty );\n```\n## jQuery.Color.fn / prototype / the Color Object methods\n\n### Getters / Setters:\n\n```javascript\nred() // returns the \"red\" component of the color ( Integer from 0 - 255 )\nred( val ) // returns a copy of the color object with the red set to val\ngreen() // returns the \"green\" component of the color from ( Integer from 0 - 255 )\ngreen( val ) // returns a copy of the color object with the green set to val\nblue() // returns the \"blue\" component of the color from ( Integer from 0 - 255 )\nblue( val ) // returns a copy of the color object with the blue set to val\nalpha() // returns the \"alpha\" component of the color from ( Float from 0.0 - 1.0 )\nalpha( val ) // returns a copy of the color object with the alpha set to val\nhue() // returns the \"hue\" component of the color ( Integer from 0 - 359 )\nhue( val ) // returns a copy of the color object with the hue set to val\nsaturation() // returns the \"saturation\" component of the color ( Float from 0.0 - 1.0 )\nsaturation( val ) // returns a copy of the color object with the saturation set to val\nlightness() // returns the \"lightness\" component of the color ( Float from 0.0 - 1.0 )\nlightness( val ) // returns a copy of the color object with the lightness set to val\n// all of the above values can also take strings in the format of \"+=100\" or \"-=100\"\n\nrgba() // returns a rgba \"tuple\" [ red, green, blue, alpha ]\n// rgba() setters: returns a copy of the color with any defined values set to the new value\nrgba( red, green, blue, alpha )\nrgba( { red: red, green: green, blue: blue, alpha: alpha } )\nrgba( [ red, green, blue, alpha ] )\n\nhsla() // returns a HSL tuple [ hue, saturation, lightness, alpha ]\n// much like the rgb setter - returns a copy with any defined values set\nhsla( hue, saturation, lightness, alpha )\nhsla( { hue: hue, saturation: saturation, lightness: lightness, alpha: alpha } )\nhsla( [ hue, saturation, lightness, alpha ] )\n```\n\n### String methods\n\n```javascript\ntoRgbaString() // returns a css string \"rgba(255, 255, 255, 0.4)\"\ntoHslaString() // returns a css string \"hsla(330, 75%, 25%, 0.4)\"\ntoHexString( includeAlpha ) // returns a css string \"#abcdef\", with \"includeAlpha\" uses \"#rrggbbaa\" (alpha *= 255)\n```\n\nThe `toRgbaString` and `toHslaString` methods will only include the alpha channel if it is not `1`. They will return `rgb(...)` and `hsl(...)` strings if the alpha is set to `1`.\n### Working with other colors:\n\n```javascript\ntransition( othercolor, distance ) // the color distance ( 0.0 - 1.0 ) of the way between this color and othercolor\nblend( othercolor ) // Will apply this color on top of the other color using alpha blending\nis( othercolor ) // Will determine if this color is equal to all defined properties of othercolor\n```\n\n## jQuery.Color properties\n\n\n## Internals on The Color Object\n* Internally, RGBA values are stored as `color._rgba[0] = red, color._rgba[1] = green, color._rgba[2] = blue, color._rgba[3] = alpha`. However, please remember there are nice convenient setters and getters for each of these properties.\n* `undefined`/`null` values for colors indicate non-existence. This signals the `transition()` function to keep whatever value was set in the other end of the transition. For example, animating to `jQuery.Color([ 255, null, null, 1 ])` would only animate the red and alpha values of the color.\n\n### `jQuery.Color.names`\n\nA list of named colors is stored on the `jQuery.Color.names` object. The value they contain should be parseable by `jQuery.Color()`. All names on this object should be lowercased. I.E. `jQuery.Color(\"Red\")` is the same as doing `jQuery.Color( jQuery.Color.names[\"red\"] );`\n\nThere is also a named color `\"_default\"` which by default is white, this is used for situations where a color is unparseable.\n\n### `\"transparent\"`\n\nA special note about the color `\"transparent\"` - It returns `null` for red green and blue unless you specify colors for these values.\n\n```javascript\njQuery.Color( \"#abcdef\" ).transition( \"transparent\", 0.5 )\n```\n\nAnimating to or from the value `\"transparent\"` will still use \"#abcdef\" for red green and blue.\n\n## HSLA Support\n\nIf a color is created using any of the HSLA functions or parsers, it will keep the `_rgba` array up to date as well as having a `_hsla` array. Once an RGBA operation is performed on HSLA, however, the `_hsla` cache is removed and all operations will continue based off of rgb (unless you go back into HSLA). The `._hsla` array follows the same format as `._rbga`, `[hue, saturation, lightness, alpha ]`. If you need to build an HSLA color from an HSLA array, `jQuery.Color().hsla( array )` works for that purpose.\n\n**Colors with 0 saturation, or 100%/0% lightness will be stored with a hue of 0**\n\n## Extensibility\n\nIt is possible for you to add your own functions to the color object. For instance, this function will tell you if it's better to use black or white on a given background color.\n\n\n```javascript\n// method taken from https://gist.github.com/960189\njQuery.Color.fn.contrastColor = function() {\n\tvar r = this._rgba[ 0 ], g = this._rgba[ 1 ], b = this._rgba[ 2 ];\n\treturn ( ( ( r * 299 ) + ( g * 587 ) + ( b * 144 ) ) / 1000 ) >= 131.5 ? \"black\" : \"white\";\n};\n\n// usage examples:\njQuery.Color( \"#bada55\" ).contrastColor(); // \"black\"\nelement.css( \"color\", jQuery.Color( element, \"backgroundColor\" ).contrastColor() );\n```\n","readmeFilename":"README.md","users":{}}