- Overview
- Documents
Shine.js is a library for pretty shadows
Features
- Dynamic light positions
- Customizable shadows
- No library dependencies, AMD compatible
- Uses text or box shadows based on content
- Works in browsers that support textShadow or boxShadow and auto-prefixes if necessary
Source: bigspaceship.github.io
1. INCLUDE JS FILES
<script src="path/to/shine.min.js"></script>
2. HTML
<h1 id="headline" class="demo-text">Shine Mouse-Follow Demo</h1>
3. JAVASCRIPT
var shine = new Shine(document.getElementById('headline')); window.addEventListener('mousemove', function(event) { shine.light.position.x = event.clientX; shine.light.position.y = event.clientY; shine.draw(); }, false);
4. CONFIGURATION
Each shine instance has a property pointing to an instance of shinejs.Config. One config can be shared amongst multiple shine instances.
When a config value changes, shine.draw() needs to be called to re-draw with the new settings.
Change the shadow of a shine instance:
shine.config.opacity = 0.1; shine.config.blur = 0.2; shine.draw(); // make sure to re-draw
Create a shared shinejs.Config instance:
// all parameters are optional and can be changed later var config = new shinejs.Config({ numSteps: 4, opacity: 0.2, shadowRGB: new shinejs.Color(255, 0, 0) }); // pass the config in the constructor var shineA = new Shine(document.getElementById('my-shine-object-a'), config); var shineB = new Shine(document.getElementById('my-shine-object-b'), config); // or assign it to an instance later var shineC = new Shine(document.getElementById('my-shine-object-c')); shineC.config = config; shineC.draw(); // make sure to re-draw
5. SHINE API
Note: Shine is also mapped to shinejs.Shine. Use the long version if Shine is already defined.
Shine(domElement, optConfig, optClassPrefix, optShadowProperty)
The Shine constructor. Instantiate as new Shine(...) to create a new instance.
Parameter | Type | Description |
---|---|---|
domElement | !HTMLElement | The DOM element to apply the shine effect to. |
optConfig | ?shinejs.Config= | Optional config instance. If no instance is passed it a new instance with default values will be stored in theconfig property. |
optClassPrefix | ?string= | Optional class prefix that will be applied to all shine DOM elements. Defaults to shine-. |
optShadowProperty | ?string= | Optional property name that the shadow will be applied to. Overrides the automatic detection for use of either textShadow or boxShadow. The value will be applied as element.style[shadowProperty] = '...' and automatically prefixed for legacy browsers (e.g. MozBoxShadow). |
Draws all shadows based on the current light position. Call this method whenever a shine parameter is changed.
Releases all resources and removes event listeners. Destroyed instance can't be reused and must be discarded.
Shine.prototype.updateContent(optText)
Re-initializes all shadows. Use this when you want to change the text or the domElement's contents have changed.
Parameter | Type | Description |
---|---|---|
optText | ?string= | If defined, will replace the DOM element's textContent. If omitted, the content will be read from the DOM element. |
Shine.prototype.enableAutoUpdates()
Adds DOM event listeners to automatically update all properties.
Shine.prototype.disableAutoUpdates()
Removes DOM event listeners to automatically update all properties.
Property | Type | Description |
---|---|---|
domElement | HTMLElement | The DOM element to apply the shine effect to. |
config | shinejs.Config | Stores all config parameters. |
light | shinejs.Light | Stores the light position and intensity. |
6. SHINEJS.CONFIG API
The shine config constructor. Pass an optional settings object from which to read values.
Parameter | Type | Description |
---|---|---|
optSettings | ?Object= | An optional object containing config parameters. |
Property | Type | Default | Description |
---|---|---|---|
numSteps | number | 8 | The number of steps drawn in each shadow |
opacity | number | 0.1 | The opacity of each shadow (range: 0...1) |
opacityPow | number | 1.2 | The exponent applied to each step's opacity (1.0 = linear opacity). |
offset | number | 0.15 | Larger offsets create longer shadows |
offsetPow | number | 1.8 | The exponent applied to each step's offset (1.0 = linear offset). |
blur | number | 40 | The strength of the shadow blur. |
blurPow | number | 1.4 | The exponent applied to each step's blur (1.0 = linear blur). |
shadowRGB | shinejs.Color | new shinejs.Color(0, 0, 0) | The shadow color in r, g, b (0...255) |
7. SHINEJS.LIGHT API
The light constructor. Pass an optional position to apply by default.
Parameter | Type | Description |
---|---|---|
optPosition | ?shinejs.Point= | An position. Defaults to new shinejs.Point(0, 0). |
Property | Type | Default | Description |
---|---|---|---|
position | shinejs.Point | new shinejs.Point(0, 0) | The position of this light. |
intensity | number | 1.0 | The intensity of this light. Gets multiplied with shadow opacity. |
8. SHINEJS.POINT API
A 2D point class.
Parameter | Type | Description |
---|---|---|
x | number= | The x-coordinate. Defaults to 0. |
y | number= | The y-coordinate. Defaults to 0. |
Property | Type | Default | Description |
---|---|---|---|
x | number | 0 | The x-coordinate. |
y | number | 0 | The y-coordinate. |
shinejs.Point.prototype.delta(p)
Returns a new instance of shinejs.Point with the x- and y-distance between this instance and the point p.
Parameter | Type | Description |
---|---|---|
p | shinejs.Point | The point to which to calculate the distance to. Distance will be expressed as this.x - p.x and this.y - p.y. |