zurb-foundation 0.0.5 → 1.0.0

data/README.markdown

@@ -1,14 +1,61 @@
-USAGE
-=====
-1. Inside your Gemfile add the following:
+WELCOME TO FOUNDATION
+=====================
+
+Foundation is a rock-solid, responsive framework for rapidly prototyping and iterating into production code. It includes a 12-column, future-friendly grid and tons of great tools and elements that'll get you up and running in no time.
+
+Homepage:      http://foundation.zurb.com  
+Documentation: http://foundation.zurb.com/docs
+
+Foundation is MIT-licensed and absolutely free to use. Foundation wouldn't be possible without the support of the entire ZURB team, our friends and colleagues who gave feedback, and some luminaries who did some heavy lifting that we took advantage of (thanks guys).
+
+Installation
+============
+
+Inside your Gemfile add the following line:
 
   `gem "zurb-foundation"`
 
-1. Run `bundle install`
-1. Run `rails g foundation:install`
-1. If you want to replace your application layout, run `rails g foundation:layout`
-1. Eat a cookie.
+Then run `bundle install` to install the gem.
+
+What now?
+---------
+
+If you want to include Foundation on all of your application pages (and why wouldn't you!) then run the following to append `foundation` to your application sprockets files:
+
+`rails g foundation:install`
+
+You can also manually include `foundation` on specific pages using:
 
-DEPENDENCIES
+```
+stylesheet_link_tag "foundation"
+javascript_include_tag "foundation"
+```
+
+Or add `require "foundation"` to your sprockets files like so:
+
+**in application.css**  
+`/*= require "foundation" */`
+
+**in application.js**  
+`//= require "foundation"`
+
+Why use this gem?
+-----------------
+
+* Easy to setup: Start using Foundation in mere seconds, like a boss
+* Paths: All images will work regardless of if you deploy to a sub-uri or not
+* Clean: Don't clutter up your assets directory
+  
+Dependencies
 ============
-* Rails 3.1
+* rails (~> 3.1)
+* jquery-rails (~> 1.0)
+
+MIT Open Source License
+=======================
+
+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.

data/app/assets/javascripts/foundation/app.js

@@ -36,28 +36,8 @@ $(document).ready(function() {
 	
 	
 	/* PLACEHOLDER FOR FORMS ------------- */
-	/* Remove if you don't need :) */
+	/* Remove this and jquery.placeholder.min.js if you don't need :) */
+	
+	$('input, textarea').placeholder();
 	
-	$('[placeholder]').focus(function() {
-		var input = $(this);
-		if (input.val() == input.attr('placeholder')) {
-			input.val('');
-			input.removeClass('placeholder');
-		}
-		}).blur(function() {
-			var input = $(this);
-			if (input.val() == '' || input.val() == input.attr('placeholder')) {
-				input.addClass('placeholder');
-				input.val(input.attr('placeholder'));
-		}
-	}).blur();
-	$('[placeholder]').parents('form').submit(function() {
-		$(this).find('[placeholder]').each(function() {
-			var input = $(this);
-			if (input.val() == input.attr('placeholder')) {
-				input.val('');
-			}
-		});
-	});
-
 });

data/app/assets/javascripts/foundation/index.js

@@ -1,6 +1,6 @@
-//= require ./jquery.reveal
-//= require ./jquery.orbit-1.2.3
-//= require ./jquery.orbit-1.2.3
-//= require ./forms.jquery.js
-//= require ./jquery.customforms
-//= require ./app
+//=require ./jquery.reveal.js
+//=require ./jquery.orbit-1.3.0.js
+//=require ./forms.jquery.js
+//=require ./jquery.customforms.js
+//=require ./jquery.placeholder.min.js
+//=require ./app.js

data/app/assets/javascripts/foundation/jquery.orbit-1.3.0.js

@@ -0,0 +1,596 @@
+/*
+ * jQuery Orbit Plugin 1.3.0
+ * www.ZURB.com/playground
+ * Copyright 2010, ZURB
+ * Free to use under the MIT license.
+ * http://www.opensource.org/licenses/mit-license.php
+*/
+
+
+(function($) {
+  
+  var ORBIT = {
+    
+    defaults: {  
+      animation: 'horizontal-push', 		// fade, horizontal-slide, vertical-slide, horizontal-push, vertical-push
+      animationSpeed: 600, 				// how fast animtions are
+      timer: true, 						// true or false to have the timer
+      advanceSpeed: 4000, 				// if timer is enabled, time between transitions 
+      pauseOnHover: false, 				// if you hover pauses the slider
+      startClockOnMouseOut: false, 		// if clock should start on MouseOut
+      startClockOnMouseOutAfter: 1000, 	// how long after MouseOut should the timer start again
+      directionalNav: true, 				// manual advancing directional navs
+      captions: true, 					// do you want captions?
+      captionAnimation: 'fade', 			// fade, slideOpen, none
+      captionAnimationSpeed: 600, 		// if so how quickly should they animate in
+      bullets: false,						// true or false to activate the bullet navigation
+      bulletThumbs: false,				// thumbnails for the bullets
+      bulletThumbLocation: '',			// location from this file where thumbs will be
+      afterSlideChange: $.noop,		// empty function 
+      fluid: true,
+      centerBullets: true    // center bullet nav with js, turn this off if you want to position the bullet nav manually
+ 	  },
+ 	  
+ 	  activeSlide: 0,
+    numberSlides: 0,
+    orbitWidth: null,
+    orbitHeight: null,
+    locked: null,
+    timerRunning: null,
+    degrees: 0,
+    wrapperHTML: '<div class="orbit-wrapper" />',
+    timerHTML: '<div class="timer"><span class="mask"><span class="rotator"></span></span><span class="pause"></span></div>',
+    captionHTML: '<div class="orbit-caption"></div>',
+    directionalNavHTML: '<div class="slider-nav"><span class="right">Right</span><span class="left">Left</span></div>',
+    bulletHTML: '<ul class="orbit-bullets"></ul>',
+    
+    init: function (element, options) {
+      var $imageSlides,
+          imagesLoadedCount = 0,
+          self = this;
+      
+      // Bind functions to correct context
+      this.clickTimer = $.proxy(this.clickTimer, this);
+      this.addBullet = $.proxy(this.addBullet, this);
+      this.resetAndUnlock = $.proxy(this.resetAndUnlock, this);
+      this.stopClock = $.proxy(this.stopClock, this);
+      this.startTimerAfterMouseLeave = $.proxy(this.startTimerAfterMouseLeave, this);
+      this.clearClockMouseLeaveTimer = $.proxy(this.clearClockMouseLeaveTimer, this);
+      this.rotateTimer = $.proxy(this.rotateTimer, this);
+      
+      this.options = $.extend({}, this.defaults, options);
+      if (this.options.timer === 'false') this.options.timer = false;
+      if (this.options.captions === 'false') this.options.captions = false;
+      if (this.options.directionalNav === 'false') this.options.directionalNav = false;
+      
+      this.$element = $(element);
+      this.$wrapper = this.$element.wrap(this.wrapperHTML).parent();
+      this.$slides = this.$element.children('img, a, div');
+      
+      this.$element.bind('orbit.next', function () {
+        self.shift('next');
+      });
+      
+      this.$element.bind('orbit.prev', function () {
+        self.shift('prev');
+      });
+      
+      this.$element.bind('orbit.goto', function (event, index) {
+        self.shift(index);
+      });
+      
+      this.$element.bind('orbit.start', function (event, index) {
+        self.startClock();
+      });
+      
+      this.$element.bind('orbit.stop', function (event, index) {
+        self.stopClock();
+      });
+      
+      $imageSlides = this.$slides.filter('img');
+      
+      if ($imageSlides.length === 0) {
+        this.loaded();
+      } else {
+        $imageSlides.bind('imageready', function () {
+          imagesLoadedCount += 1;
+          if (imagesLoadedCount === $imageSlides.length) {
+            self.loaded();
+          }
+        });
+      }
+    },
+    
+    loaded: function () {
+      this.$element
+        .addClass('orbit')
+        .css({width: '1px', height: '1px'});
+        
+      this.setDimentionsFromLargestSlide();
+      this.updateOptionsIfOnlyOneSlide();
+      this.setupFirstSlide();
+      
+      if (this.options.timer) {
+        this.setupTimer();
+        this.startClock();
+      }
+      
+      if (this.options.captions) {
+        this.setupCaptions();
+      }
+      
+      if (this.options.directionalNav) {
+        this.setupDirectionalNav();
+      }
+      
+      if (this.options.bullets) {
+        this.setupBulletNav();
+        this.setActiveBullet();
+      }
+    },
+    
+    currentSlide: function () {
+      return this.$slides.eq(this.activeSlide);
+    },
+    
+    setDimentionsFromLargestSlide: function () {
+      //Collect all slides and set slider size of largest image
+      var self = this,
+          $fluidPlaceholder;
+          
+      self.$element.add(self.$wrapper).width(this.$slides.first().width());
+      self.$element.add(self.$wrapper).height(this.$slides.first().height());
+      self.orbitWidth = this.$slides.first().width();
+      self.orbitHeight = this.$slides.first().height();
+      $fluidPlaceholder = this.$slides.first().clone();
+      
+      this.$slides.each(function () {
+        var slide = $(this),
+            slideWidth = slide.width(),
+            slideHeight = slide.height();
+
+        if (slideWidth > self.$element.width()) {
+          self.$element.add(self.$wrapper).width(slideWidth);
+          self.orbitWidth = self.$element.width();	       			
+        }
+        if (slideHeight > self.$element.height()) {
+          self.$element.add(self.$wrapper).height(slideHeight);
+          self.orbitHeight = self.$element.height();
+          $fluidPlaceholder = $(this).clone();
+	      }
+        self.numberSlides += 1;
+      });
+      
+      if (this.options.fluid) {
+        if (typeof this.options.fluid === "string") {
+          $fluidPlaceholder = $('<img src="http://placehold.it/' + this.options.fluid + '" />')
+        }
+        
+        self.$element.prepend($fluidPlaceholder);
+        $fluidPlaceholder.addClass('fluid-placeholder');
+        self.$element.add(self.$wrapper).css({width: 'inherit'});
+        self.$element.add(self.$wrapper).css({height: 'inherit'});
+        
+        $(window).bind('resize', function () {
+          self.orbitWidth = self.$element.width();
+          self.orbitHeight = self.$element.height();
+        });
+      }
+    },
+    
+    //Animation locking functions
+    lock: function () {
+      this.locked = true;
+    },
+    
+    unlock: function () { 
+      this.locked = false;
+    },
+    
+    updateOptionsIfOnlyOneSlide: function () {
+      if(this.$slides.length === 1) {
+      	this.options.directionalNav = false;
+      	this.options.timer = false;
+      	this.options.bullets = false;
+      }
+    },
+    
+    setupFirstSlide: function () {
+      //Set initial front photo z-index and fades it in
+      var self = this;
+      this.$slides.first()
+      	.css({"z-index" : 3})
+      	.fadeIn(function() {
+      		//brings in all other slides IF css declares a display: none
+      		self.$slides.css({"display":"block"})
+      });
+    },
+    
+    startClock: function () {
+      var self = this;
+      
+      if(!this.options.timer) { 
+    		return false;
+    	} 
+
+    	if (this.$timer.is(':hidden')) {
+        this.clock = setInterval(function () {
+          this.$element.trigger('orbit.next');
+        }, this.options.advanceSpeed);            		
+    	} else {
+        this.timerRunning = true;
+        this.$pause.removeClass('active')
+        this.clock = setInterval(this.rotateTimer, this.options.advanceSpeed / 180);
+      }
+    },
+    
+    rotateTimer: function () {
+      var degreeCSS = "rotate(" + this.degrees + "deg)"
+      this.degrees += 2;
+      this.$rotator.css({ 
+        "-webkit-transform": degreeCSS,
+        "-moz-transform": degreeCSS,
+        "-o-transform": degreeCSS
+      });
+      if(this.degrees > 180) {
+        this.$rotator.addClass('move');
+        this.$mask.addClass('move');
+      }
+      if(this.degrees > 360) {
+        this.$rotator.removeClass('move');
+        this.$mask.removeClass('move');
+        this.degrees = 0;
+        this.$element.trigger('orbit.next');
+      }
+    },
+    
+    stopClock: function () {
+      if (!this.options.timer) { 
+        return false; 
+      } else {
+        this.timerRunning = false;
+        clearInterval(this.clock);
+        this.$pause.addClass('active');
+      }
+    },
+    
+    setupTimer: function () {
+      this.$timer = $(this.timerHTML);
+      this.$wrapper.append(this.$timer);
+
+      this.$rotator = this.$timer.find('.rotator');
+      this.$mask = this.$timer.find('.mask');
+      this.$pause = this.$timer.find('.pause');
+      
+      this.$timer.click(this.clickTimer);
+
+      if (this.options.startClockOnMouseOut) {
+        this.$wrapper.mouseleave(this.startTimerAfterMouseLeave);
+        this.$wrapper.mouseenter(this.clearClockMouseLeaveTimer);
+      }
+      
+      if (this.options.pauseOnHover) {
+        this.$wrapper.mouseenter(this.stopClock);
+      }
+    },
+    
+    startTimerAfterMouseLeave: function () {
+      var self = this;
+
+      this.outTimer = setTimeout(function() {
+        if(!self.timerRunning){
+          self.startClock();
+        }
+      }, this.options.startClockOnMouseOutAfter)
+    },
+    
+    clearClockMouseLeaveTimer: function () {
+      clearTimeout(this.outTimer);
+    },
+    
+    clickTimer: function () {
+      if(!this.timerRunning) {
+          this.startClock();
+      } else { 
+          this.stopClock();
+      }
+    },
+    
+    setupCaptions: function () {
+      this.$caption = $(this.captionHTML);
+      this.$wrapper.append(this.$caption);
+  	  this.setCaption();
+    },
+    
+    setCaption: function () {
+      var captionLocation = this.currentSlide().attr('data-caption'),
+          captionHTML;
+    		
+      if (!this.options.captions) {
+    		return false; 
+    	} 
+    	        		
+    	//Set HTML for the caption if it exists
+    	if (captionLocation) {
+    	  captionHTML = $(captionLocation).html(); //get HTML from the matching HTML entity
+    		this.$caption
+      		.attr('id', captionLocation) // Add ID caption TODO why is the id being set?
+          .html(captionHTML); // Change HTML in Caption 
+          //Animations for Caption entrances
+        switch (this.options.captionAnimation) {
+          case 'none':
+            this.$caption.show();
+            break;
+          case 'fade':
+            this.$caption.fadeIn(this.options.captionAnimationSpeed);
+            break;
+          case 'slideOpen':
+            this.$caption.slideDown(this.options.captionAnimationSpeed);
+            break;
+        }
+    	} else {
+    		//Animations for Caption exits
+    		switch (this.options.captionAnimation) {
+          case 'none':
+            this.$caption.hide();
+            break;
+          case 'fade':
+            this.$caption.fadeOut(this.options.captionAnimationSpeed);
+            break;
+          case 'slideOpen':
+            this.$caption.slideUp(this.options.captionAnimationSpeed);
+            break;
+        }
+    	}
+    },
+    
+    setupDirectionalNav: function () {
+      var self = this;
+
+      this.$wrapper.append(this.directionalNavHTML);
+      
+      this.$wrapper.find('.left').click(function () { 
+        self.stopClock();
+        self.$element.trigger('orbit.prev');
+      });
+      
+      this.$wrapper.find('.right').click(function () {
+        self.stopClock();
+        self.$element.trigger('orbit.next');
+      });
+    },
+    
+    setupBulletNav: function () {
+      this.$bullets = $(this.bulletHTML);
+    	this.$wrapper.append(this.$bullets);
+    	this.$slides.each(this.addBullet);
+    	if (this.options.centerBullets) this.$bullets.css('margin-left', -this.$bullets.width() / 2);
+    },
+    
+    addBullet: function (index, slide) {
+      var position = index + 1,
+          $li = $('<li>' + (position) + '</li>'),
+          thumbName,
+          self = this;
+
+  		if (this.options.bulletThumbs) {
+  			thumbName = $(slide).attr('data-thumb');
+  			if (thumbName) {
+          $li
+            .addClass('has-thumb')
+            .css({background: "url(" + this.options.bulletThumbLocation + thumbName + ") no-repeat"});;
+  			}
+  		}
+  		this.$bullets.append($li);
+  		$li.data('index', index);
+  		$li.click(function () {
+  			self.stopClock();
+  			self.$element.trigger('orbit.goto', [$li.data('index')])
+  		});
+    },
+    
+    setActiveBullet: function () {
+      if(!this.options.bullets) { return false; } else {
+    		this.$bullets.find('li')
+    		  .removeClass('active')
+    		  .eq(this.activeSlide)
+    		  .addClass('active');
+    	}
+    },
+    
+    resetAndUnlock: function () {
+      this.$slides
+      	.eq(this.prevActiveSlide)
+      	.css({"z-index" : 1});
+      this.unlock();
+      this.options.afterSlideChange.call(this, this.$slides.eq(this.prevActiveSlide), this.$slides.eq(this.activeSlide));
+    },
+    
+    shift: function (direction) {
+      var slideDirection = direction;
+      
+      //remember previous activeSlide
+      this.prevActiveSlide = this.activeSlide;
+      
+      //exit function if bullet clicked is same as the current image
+      if (this.prevActiveSlide == slideDirection) { return false; }
+      
+      if (this.$slides.length == "1") { return false; }
+      if (!this.locked) {
+        this.lock();
+	      //deduce the proper activeImage
+        if (direction == "next") {
+          this.activeSlide++;
+          if (this.activeSlide == this.numberSlides) {
+              this.activeSlide = 0;
+          }
+        } else if (direction == "prev") {
+          this.activeSlide--
+          if (this.activeSlide < 0) {
+            this.activeSlide = this.numberSlides - 1;
+          }
+        } else {
+          this.activeSlide = direction;
+          if (this.prevActiveSlide < this.activeSlide) { 
+            slideDirection = "next";
+          } else if (this.prevActiveSlide > this.activeSlide) { 
+            slideDirection = "prev"
+          }
+        }
+
+        //set to correct bullet
+        this.setActiveBullet();  
+             
+        //set previous slide z-index to one below what new activeSlide will be
+        this.$slides
+          .eq(this.prevActiveSlide)
+          .css({"z-index" : 2});    
+            
+        //fade
+        if (this.options.animation == "fade") {
+          this.$slides
+            .eq(this.activeSlide)
+            .css({"opacity" : 0, "z-index" : 3})
+            .animate({"opacity" : 1}, this.options.animationSpeed, this.resetAndUnlock);
+        }
+        
+        //horizontal-slide
+        if (this.options.animation == "horizontal-slide") {
+          if (slideDirection == "next") {
+            this.$slides
+              .eq(this.activeSlide)
+              .css({"left": this.orbitWidth, "z-index" : 3})
+              .animate({"left" : 0}, this.options.animationSpeed, this.resetAndUnlock);
+          }
+          if (slideDirection == "prev") {
+            this.$slides
+              .eq(this.activeSlide)
+              .css({"left": -this.orbitWidth, "z-index" : 3})
+              .animate({"left" : 0}, this.options.animationSpeed, this.resetAndUnlock);
+          }
+        }
+            
+        //vertical-slide
+        if (this.options.animation == "vertical-slide") { 
+          if (slideDirection == "prev") {
+            this.$slides
+              .eq(this.activeSlide)
+              .css({"top": this.orbitHeight, "z-index" : 3})
+              .animate({"top" : 0}, this.options.animationSpeed, this.resetAndUnlock);
+          }
+          if (slideDirection == "next") {
+            this.$slides
+              .eq(this.activeSlide)
+              .css({"top": -this.orbitHeight, "z-index" : 3})
+              .animate({"top" : 0}, this.options.animationSpeed, this.resetAndUnlock);
+          }
+        }
+        
+        //horizontal-push
+        if (this.options.animation == "horizontal-push") {
+          if (slideDirection == "next") {
+            this.$slides
+              .eq(this.activeSlide)
+              .css({"left": this.orbitWidth, "z-index" : 3})
+              .animate({"left" : 0}, this.options.animationSpeed, this.resetAndUnlock);
+            this.$slides
+              .eq(this.prevActiveSlide)
+              .animate({"left" : -this.orbitWidth}, this.options.animationSpeed);
+          }
+          if (slideDirection == "prev") {
+            this.$slides
+              .eq(this.activeSlide)
+              .css({"left": -this.orbitWidth, "z-index" : 3})
+              .animate({"left" : 0}, this.options.animationSpeed, this.resetAndUnlock);
+		        this.$slides
+              .eq(this.prevActiveSlide)
+              .animate({"left" : this.orbitWidth}, this.options.animationSpeed);
+          }
+        }
+        
+        //vertical-push
+        if (this.options.animation == "vertical-push") {
+          if (slideDirection == "next") {
+            this.$slides
+              .eq(this.activeSlide)
+              .css({top: -this.orbitHeight, "z-index" : 3})
+              .animate({top : 0}, this.options.animationSpeed, this.resetAndUnlock);
+            this.$slides
+              .eq(this.prevActiveSlide)
+              .animate({top : this.orbitHeight}, this.options.animationSpeed);
+          }
+          if (slideDirection == "prev") {
+            this.$slides
+              .eq(this.activeSlide)
+              .css({top: this.orbitHeight, "z-index" : 3})
+              .animate({top : 0}, this.options.animationSpeed, this.resetAndUnlock);
+		        this.$slides
+              .eq(this.prevActiveSlide)
+              .animate({top : -this.orbitHeight}, this.options.animationSpeed);
+          }
+        }
+        
+        this.setCaption();
+      }
+    }
+  };
+
+  $.fn.orbit = function (options) {
+    return this.each(function () {
+      var orbit = $.extend({}, ORBIT);
+      orbit.init(this, options);
+    });
+  };
+
+})(jQuery);
+        
+/*!
+ * jQuery imageready Plugin
+ * http://www.zurb.com/playground/
+ *
+ * Copyright 2011, ZURB
+ * Released under the MIT License
+ */
+(function ($) {
+  
+  var options = {};
+  
+  $.event.special.imageready = {
+    
+    setup: function (data, namespaces, eventHandle) {
+      options = data || options;
+    },
+		
+		add: function (handleObj) {
+		  var $this = $(this),
+		      src;
+		      
+	    if ( this.nodeType === 1 && this.tagName.toLowerCase() === 'img' && this.src !== '' ) {
+  			if (options.forceLoad) {
+  			  src = $this.attr('src');
+  			  $this.attr('src', '');
+  			  bindToLoad(this, handleObj.handler);
+          $this.attr('src', src);
+  			} else if ( this.complete || this.readyState === 4 ) {
+          handleObj.handler.apply(this, arguments);
+  			} else {
+  			  bindToLoad(this, handleObj.handler);
+  			}
+  		}
+		},
+		
+		teardown: function (namespaces) {
+		  $(this).unbind('.imageready');
+		}
+	};
+	
+	function bindToLoad(element, callback) {
+	  var $this = $(element);
+
+    $this.bind('load.imageready', function () {
+       callback.apply(element, arguments);
+       $this.unbind('load.imageready');
+     });
+	}
+
+}(jQuery));