1 //fgnass.github.com/spin.js#v1.3
4 * Copyright (c) 2011-2013 Felix Gnass
5 * Licensed under the MIT license
7 (function(root, factory) {
10 if (typeof exports == 'object') module.exports = factory()
13 else if (typeof define == 'function' && define.amd) define(factory)
16 else root.Spinner = factory()
21 var prefixes = ['webkit', 'Moz', 'ms', 'O'] /* Vendor prefixes */
22 , animations = {} /* Animation rules keyed by their name */
23 , useCssAnimations /* Whether to use CSS animations or setTimeout */
26 * Utility function to create elements. If no tag name is given,
27 * a DIV is created. Optionally properties can be passed.
29 function createEl(tag, prop) {
30 var el = document.createElement(tag || 'div')
33 for(n in prop) el[n] = prop[n]
38 * Appends children and returns the parent.
40 function ins(parent /* child1, child2, ...*/) {
41 for (var i=1, n=arguments.length; i<n; i++)
42 parent.appendChild(arguments[i])
48 * Insert a new stylesheet to hold the @keyframe or VML rules.
50 var sheet = (function() {
51 var el = createEl('style', {type : 'text/css'})
52 ins(document.getElementsByTagName('head')[0], el)
53 return el.sheet || el.styleSheet
57 * Creates an opacity keyframe animation rule and returns its name.
58 * Since most mobile Webkits have timing issues with animation-delay,
59 * we create separate rules for each line/segment.
61 function addAnimation(alpha, trail, i, lines) {
62 var name = ['opacity', trail, ~~(alpha*100), i, lines].join('-')
63 , start = 0.01 + i/lines * 100
64 , z = Math.max(1 - (1-alpha) / trail * (100-start), alpha)
65 , prefix = useCssAnimations.substring(0, useCssAnimations.indexOf('Animation')).toLowerCase()
66 , pre = prefix && '-' + prefix + '-' || ''
68 if (!animations[name]) {
70 '@' + pre + 'keyframes ' + name + '{' +
71 '0%{opacity:' + z + '}' +
72 start + '%{opacity:' + alpha + '}' +
73 (start+0.01) + '%{opacity:1}' +
74 (start+trail) % 100 + '%{opacity:' + alpha + '}' +
75 '100%{opacity:' + z + '}' +
76 '}', sheet.cssRules.length)
85 * Tries various vendor prefixes and returns the first supported property.
87 function vendor(el, prop) {
92 if(s[prop] !== undefined) return prop
93 prop = prop.charAt(0).toUpperCase() + prop.slice(1)
94 for(i=0; i<prefixes.length; i++) {
96 if(s[pp] !== undefined) return pp
101 * Sets multiple style properties at once.
103 function css(el, prop) {
105 el.style[vendor(el, n)||n] = prop[n]
111 * Fills in default values.
113 function merge(obj) {
114 for (var i=1; i < arguments.length; i++) {
115 var def = arguments[i]
117 if (obj[n] === undefined) obj[n] = def[n]
123 * Returns the absolute page-offset of the given element.
126 var o = { x:el.offsetLeft, y:el.offsetTop }
127 while((el = el.offsetParent))
128 o.x+=el.offsetLeft, o.y+=el.offsetTop
136 lines: 12, // The number of lines to draw
137 length: 7, // The length of each line
138 width: 5, // The line thickness
139 radius: 10, // The radius of the inner circle
140 rotate: 0, // Rotation offset
141 corners: 1, // Roundness (0..1)
142 color: '#000', // #rgb or #rrggbb
143 direction: 1, // 1: clockwise, -1: counterclockwise
144 speed: 1, // Rounds per second
145 trail: 100, // Afterglow percentage
146 opacity: 1/4, // Opacity of the lines
147 fps: 20, // Frames per second when using setTimeout()
148 zIndex: 2e9, // Use a high z-index by default
149 className: 'spinner', // CSS class to assign to the element
150 top: 'auto', // center vertically
151 left: 'auto', // center horizontally
152 position: 'relative' // element position
155 /** The constructor */
156 function Spinner(o) {
157 if (typeof this == 'undefined') return new Spinner(o)
158 this.opts = merge(o || {}, Spinner.defaults, defaults)
161 // Global defaults that override the built-ins:
162 Spinner.defaults = {}
164 merge(Spinner.prototype, {
167 * Adds the spinner to the given target element. If this instance is already
168 * spinning, it is automatically removed from its previous target b calling
171 spin: function(target) {
176 , el = self.el = css(createEl(0, {className: o.className}), {position: o.position, width: 0, zIndex: o.zIndex})
177 , mid = o.radius+o.length+o.width
178 , ep // element position
179 , tp // target position
182 target.insertBefore(el, target.firstChild||null)
186 left: (o.left == 'auto' ? tp.x-ep.x + (target.offsetWidth >> 1) : parseInt(o.left, 10) + mid) + 'px',
187 top: (o.top == 'auto' ? tp.y-ep.y + (target.offsetHeight >> 1) : parseInt(o.top, 10) + mid) + 'px'
191 el.setAttribute('role', 'progressbar')
192 self.lines(el, self.opts)
194 if (!useCssAnimations) {
195 // No CSS animation support, use setTimeout() instead
197 , start = (o.lines - 1) * (1 - o.direction) / 2
201 , ostep = (1-o.opacity) / (f*o.trail / 100)
206 for (var j = 0; j < o.lines; j++) {
207 alpha = Math.max(1 - (i + (o.lines - j) * astep) % f * ostep, o.opacity)
209 self.opacity(el, j * o.direction + start, alpha, o)
211 self.timeout = self.el && setTimeout(anim, ~~(1000/fps))
218 * Stops and removes the Spinner.
223 clearTimeout(this.timeout)
224 if (el.parentNode) el.parentNode.removeChild(el)
231 * Internal method that draws the individual lines. Will be overwritten
232 * in VML fallback mode below.
234 lines: function(el, o) {
236 , start = (o.lines - 1) * (1 - o.direction) / 2
239 function fill(color, shadow) {
240 return css(createEl(), {
241 position: 'absolute',
242 width: (o.length+o.width) + 'px',
243 height: o.width + 'px',
246 transformOrigin: 'left',
247 transform: 'rotate(' + ~~(360/o.lines*i+o.rotate) + 'deg) translate(' + o.radius+'px' +',0)',
248 borderRadius: (o.corners * o.width>>1) + 'px'
252 for (; i < o.lines; i++) {
253 seg = css(createEl(), {
254 position: 'absolute',
255 top: 1+~(o.width/2) + 'px',
256 transform: o.hwaccel ? 'translate3d(0,0,0)' : '',
258 animation: useCssAnimations && addAnimation(o.opacity, o.trail, start + i * o.direction, o.lines) + ' ' + 1/o.speed + 's linear infinite'
261 if (o.shadow) ins(seg, css(fill('#000', '0 0 4px ' + '#000'), {top: 2+'px'}))
263 ins(el, ins(seg, fill(o.color, '0 0 1px rgba(0,0,0,.1)')))
269 * Internal method that adjusts the opacity of a single line.
270 * Will be overwritten in VML fallback mode below.
272 opacity: function(el, i, val) {
273 if (i < el.childNodes.length) el.childNodes[i].style.opacity = val
281 /* Utility function to create a VML tag */
282 function vml(tag, attr) {
283 return createEl('<' + tag + ' xmlns="urn:schemas-microsoft.com:vml" class="spin-vml">', attr)
286 // No CSS transforms but VML support, add a CSS rule for VML elements:
287 sheet.addRule('.spin-vml', 'behavior:url(#default#VML)')
289 Spinner.prototype.lines = function(el, o) {
290 var r = o.length+o.width
296 coordsize: s + ' ' + s,
297 coordorigin: -r + ' ' + -r
299 { width: s, height: s }
303 var margin = -(o.width+o.length)*2 + 'px'
304 , g = css(grp(), {position: 'absolute', top: margin, left: margin})
307 function seg(i, dx, filter) {
309 ins(css(grp(), {rotation: 360 / o.lines * i + 'deg', left: ~~dx}),
310 ins(css(vml('roundrect', {arcsize: o.corners}), {
317 vml('fill', {color: o.color, opacity: o.opacity}),
318 vml('stroke', {opacity: 0}) // transparent stroke to fix color bleeding upon opacity change
325 for (i = 1; i <= o.lines; i++)
326 seg(i, -2, 'progid:DXImageTransform.Microsoft.Blur(pixelradius=2,makeshadow=1,shadowopacity=.3)')
328 for (i = 1; i <= o.lines; i++) seg(i)
332 Spinner.prototype.opacity = function(el, i, val, o) {
333 var c = el.firstChild
334 o = o.shadow && o.lines || 0
335 if (c && i+o < c.childNodes.length) {
336 c = c.childNodes[i+o]; c = c && c.firstChild; c = c && c.firstChild
337 if (c) c.opacity = val
342 var probe = css(createEl('group'), {behavior: 'url(#default#VML)'})
344 if (!vendor(probe, 'transform') && probe.adj) initVML()
345 else useCssAnimations = vendor(probe, 'animation')