Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/webcore-it/colorful-background-css-generator
A colorful css gradient background generator
https://github.com/webcore-it/colorful-background-css-generator
Last synced: 29 days ago
JSON representation
A colorful css gradient background generator
- Host: GitHub
- URL: https://github.com/webcore-it/colorful-background-css-generator
- Owner: webcore-it
- License: mit
- Created: 2014-08-25T10:07:30.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2018-06-03T11:54:00.000Z (over 6 years ago)
- Last Synced: 2024-10-30T08:56:56.162Z (about 1 month ago)
- Language: JavaScript
- Homepage: http://www.webcore-it.com/colorful-background/
- Size: 328 KB
- Stars: 319
- Watchers: 15
- Forks: 46
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-gradient - colorful-background-css-generator - A colorful css gradient background generator. (JavaScript)
README
A colorful css gradient background generator
============================================
A pure javascript generator to create colorful css backgrounds.
Check [this website](http://www.webcore-it.com/colorful-background) to see the generator in action and play with the colors settings.
Idea
----
The idea is to have multiple layers of linear css gradients at different angles. The gradients go from color to transparent to let the lower layers shine through and generate the wanted effect. There is no limit in the number of layers.
Usage
-----
There are two ways to use this generator:
1. Include the generator in the website
2. Use it just as a code generator
There are examples in the `examples` folder.
###1. Include the generator in the website
Add the generator (it's in the `dist` folder) to your html file and let it set the background to the element directly.
**include_generator_example.html**
```html
#colorful { height: 30em; width: 30em; padding: 1em; }
This element will have the colorful background.
// The Generator
var generator = new ColorfulBackgroundGenerator();
// This adds 5 layers to the generator
// The parameters are: degree[0-360],
// h[0-360],
// s[0-1],
// l[0-1],
// posColor[0-100],
// posTransparency[0-100]
// The lowest layer (at the bottom) in the css is the first added layer.
generator.addLayer(new ColorfulBackgroundLayer({degree: 325, h: 5, s: 0.95, l: 0.55,posColor: 100})); // bottom layer
generator.addLayer(new ColorfulBackgroundLayer({degree: 225, h: 75, s: 0.9, l: 0.7, posColor: 30, posTransparency: 80}));
generator.addLayer(new ColorfulBackgroundLayer({degree: 155, h: 150, s: 0.95, l: 0.7, posColor: 10, posTransparency: 80}));
generator.addLayer(new ColorfulBackgroundLayer({degree: 55, h: 230, s: 0.95, l: 0.65, posColor: 0, posTransparency: 70}));
generator.addLayer(new ColorfulBackgroundLayer({degree: 20, h: 300, s: 0.9, l: 0.65, posColor: 0, posTransparency: 55})); // top layer
// Assign generated style to the element identified by it's id
generator.assignStyleToElementId("colorful");
```
###2. Use it just as code generator
Another way is to use the generator to generate the css for the background and add this generated css to your style.css.
**generate_css_example.html**
```html
Generate the css class
// The Generator
var generator = new ColorfulBackgroundGenerator();
// This adds 3 layers to the generator
// The parameters are: degree[0-360],
// h[0-360],
// s[0-1],
// l[0-1],
// posColor[0-100],
// posTransparency[0-100]
// The lowest layer (at the bottom) in the css is the first added layer.
generator.addLayer(new ColorfulBackgroundLayer({degree: 50, h: 35, s: 0.95, l: 45, posColor: 100})); // bottom layer
generator.addLayer(new ColorfulBackgroundLayer({degree: 140, h: 220, s: 0.9, l: 0.7, posColor: 30, posTransparency: 80}));
generator.addLayer(new ColorfulBackgroundLayer({degree: 210, h: 340, s: 0.9, l: 0.65, posColor: 10, posTransparency: 55})); // top layer
// Print the css style.
var element = document.getElementById("code");
element.innerHTML = generator.getCSSAsText();
```
Hints
-----
* Choose a high saturation between `80` and `100`
* Choose a lightness between `40` and `60`
* The lowest (first added) layer should have the `posTransparency` at `100` and `posColor` > `50` to make the lowest layer more colorful then the other layers
Supported Browsers
------------------
The only magic are css gradients. So it works with
* Firefox 16+
* Safari 5.1+
* Chrome 10+
* Internet Explorer 10+
* Opera 12.1+
* iOS 5.1+
* Android 4+
* Blackberry 10+
* IE Mobile 10+
See http://caniuse.com/#feat=css-gradients for more details on css gradients.
Lessons Learned
--------------
###Transparency in Firefox
This is fixed in Firefox 36+ but an issue in earlier versions.
Firefox renders transparency in gradients different than webkit. The trick is to not use `transparent` or `rgba(0,0,0,0)` but the first color with alpha transparency = 0.
```css
/* This fades to gray first before fading to transparent. */
div.gray {
background: linear-gradient(0deg, hsla(0,100%,50%,1) 0%, transparent 100%);
}
/* This fades from color to transparent. */
div.color {
background: linear-gradient(0deg, hsla(0,100%,50%,1) 0%, hsla(0,100%,50%,0) 100%);
}
```
Open [this fiddle](http://jsfiddle.net/WebCore_IT/v1gnw2wc/) with Firefox version 16 till 35 to see the difference.
###Degrees counting in webkit
* Prefixed `-webkit-linear-gradient` is counting degrees **counterclockwise**.
0° is at the **left side**.
* The standard `linear-gradient` is counting degrees **clockwise**.
0° is at the **bottom side**.
To convert the degrees of the standard linear-gradient to the -webkit-prefix degrees: (360 - standard-degrees) + 90
Open [this fiddle](http://jsfiddle.net/WebCore_IT/666datts/) in Chrome 26+ (or Safari 6.1+) to see the difference.
License
-----
The MIT License (MIT)
Copyright (c) 2014 webcore-it
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.