gumby 0.0.1

data/vendor/assets/javascripts/ui/gumby.skiplink.js

@@ -0,0 +1,145 @@
+/**
+* Gumby SkipLink
+*/
+!function() {
+
+	'use strict';
+
+	function SkipLink($el) {
+		this.$el = $el;
+		this.targetPos = 0;
+		this.duration = 0;
+		this.offset = false;
+		this.easing = '';
+		this.update = false;
+
+		// set up module based on attributes
+		this.setup();
+
+		var scope = this;
+
+		// skip to target element on click or trigger of gumby.skipTo event
+		this.$el.on(Gumby.click+' gumby.skip', function(e) {
+
+			e.stopImmediatePropagation();
+			e.preventDefault();
+
+			// calculate target on each click if update var set to true
+			if(scope.update) {
+				scope.calculateTarget(scope.skipTo);
+
+			// skip straight to target
+			} else {
+				scope.skipTo();
+			}
+		}).on('gumby.initialize', function() {
+			scope.setup();
+		});
+	}
+
+	// set up module based on attributes
+	SkipLink.prototype.setup = function() {
+		this.duration = Number(Gumby.selectAttr.apply(this.$el, ['duration'])) || 200;
+		this.offset = Gumby.selectAttr.apply(this.$el, ['offset']) || false;
+		this.easing = Gumby.selectAttr.apply(this.$el, ['easing']) || 'swing';
+		this.update = Gumby.selectAttr.apply(this.$el, ['update']) ? true : false;
+
+		this.calculateTarget();
+	};
+
+	// calculate target px point to skip to
+	SkipLink.prototype.calculateTarget = function(cb) {
+
+		var scope = this,
+			target = Gumby.selectAttr.apply(this.$el, ['goto']),
+			$target;
+
+		// 'top' specified so target is 0px
+		if(target == 'top') {
+			this.targetPos = 0;
+
+		// px point specified
+		} else if($.isNumeric(target)) {
+			this.targetPos = Number(target);
+		} else {
+
+			// check for element with target as selector
+			$target = $(target);
+
+			// target does not exist, we need a target
+			if(!$target) {
+				return false;
+			}
+
+			this.targetPos = $target.offset().top;
+		}
+
+		if(cb) {
+			cb.apply(this);
+		}
+	};
+
+	// animate body, html scrollTop value to target px point
+	SkipLink.prototype.skipTo = function() {
+		var scope = this;
+
+		// slide to position of target
+		$('html,body').animate({
+			'scrollTop' : this.calculateOffset()
+		}, this.duration, this.easing).promise().done(function() {
+			scope.$el.trigger('gumby.onComplete');
+		});
+	};
+
+	// calculate offset with current target point
+	SkipLink.prototype.calculateOffset = function() {
+		// no offset so return target here
+		if(!this.offset) {
+			return this.targetPos;
+		}
+
+		// negative / positive
+		var op = this.offset.substr(0, 1),
+			off = Number(this.offset.substr(1, this.offset.length));
+
+		// subtract offset from target position
+		if(op === '-') {
+			return this.targetPos - off;
+		// add offset to target position
+		} else if(op === '+') {
+			return this.targetPos + off;
+		}
+	};
+
+	// add initialisation
+	Gumby.addInitalisation('skiplinks', function(all) {
+		$('.skiplink > a, .skip').each(function() {
+			var $this = $(this);
+
+			// this element has already been initialized
+			// and we're only initializing new modules
+			if($this.data('isSkipLink') && !all) {
+				return true;
+
+			// this element has already been initialized
+			// and we need to reinitialize it
+			} else if($this.data('isSkipLink') && all) {
+				$this.trigger('gumby.initialize');
+				return true;
+			}
+
+			// mark element as initialized
+			$this.data('isSkipLink', true);
+			new SkipLink($this);
+		});
+	});
+
+	// register UI module
+	Gumby.UIModule({
+		module: 'skiplink',
+		events: ['onComplete', 'skip'],
+		init: function() {
+			Gumby.initialize('skiplinks');
+		}
+	});
+}();

data/vendor/assets/javascripts/ui/gumby.tabs.js

@@ -0,0 +1,71 @@
+/**
+* Gumby Tabs
+*/
+!function() {
+
+	'use strict';
+
+	function Tabs($el) {
+
+		this.$el = $el;
+		this.$nav = this.$el.find('ul.tab-nav > li');
+		this.$content = this.$el.find('.tab-content');
+
+		var scope = this;
+
+		// listen for click event on tab nav and custom gumby set event
+		this.$nav.children('a').on(Gumby.click, function(e) {
+			e.stopImmediatePropagation();
+			e.preventDefault();
+			scope.click($(this));
+		});
+
+		// listen for gumby.set value for dynamically set tabs
+		this.$el.on('gumby.set', function(e, index) {
+			scope.set(e, index);
+		});
+	}
+
+	// handle tab nav click event
+	Tabs.prototype.click = function($this) {
+		// index of item to activate
+		var index = $this.parent().index();
+
+		// deactivate other tab navigation and content
+		this.$nav.add(this.$content).removeClass('active');
+
+		// activate this tab nav link and content
+		this.$nav.eq(index).add(this.$content.eq(index)).addClass('active');
+
+		// trigger gumby.change event and pass current active tab index
+		this.$el.trigger('gumby.onChange', index);
+	};
+
+	// set specific tab
+	Tabs.prototype.set = function(e, index) {
+		this.$nav.eq(index).find('a').trigger(Gumby.click);
+	};
+
+	// add initialisation
+	Gumby.addInitalisation('tabs', function() {
+		$('.tabs').each(function() {
+			var $this = $(this);
+			// this element has already been initialized
+			if($this.data('isTabs')) {
+				return true;
+			}
+			// mark element as initialized
+			$this.data('isTabs', true);
+			new Tabs($this);
+		});
+	});
+
+	// register UI module
+	Gumby.UIModule({
+		module: 'tabs',
+		events: ['onChange', 'set'],
+		init: function() {
+			Gumby.initialize('tabs');
+		}
+	});
+}();

data/vendor/assets/javascripts/ui/gumby.toggleswitch.js

@@ -0,0 +1,203 @@
+/**
+* Gumby Toggles/Switches
+*/
+!function() {
+
+	'use strict';
+
+	// Toggle constructor
+	function Toggle($el) {
+		this.$el = $($el);
+		this.targets = [];
+		this.on = '';
+
+		if(this.$el.length) {
+			this.init();
+		}
+	}
+
+	// Switch constructor
+	function Switch($el) {
+		this.$el = $($el);
+		this.targets = [];
+		this.on = '';
+
+		if(this.$el.length) {
+			this.init();
+		}
+	}
+
+	// intialise toggles, switches will inherit method
+	Toggle.prototype.init = function() {
+		var scope = this;
+
+		// set up module based on attributes
+		this.setup();
+
+		// bind to specified event and trigger
+		this.$el.on(this.on, function(e) {
+			// stop propagation
+			e.stopImmediatePropagation();
+
+			// only disable default if <a>
+			if($(this).prop('tagName') === 'A') {
+				e.preventDefault();
+			}
+
+			scope.trigger(scope.triggered);
+
+		// listen for gumby.trigger to dynamically trigger toggle/switch
+		}).on('gumby.trigger', function() {
+			scope.trigger(scope.triggered);
+		// re-initialize module
+		}).on('gumby.initialize', function() {
+			scope.setup();
+		});
+	};
+
+	// set up module based on attributes
+	Toggle.prototype.setup = function() {
+		this.targets = this.parseTargets();
+		this.on = Gumby.selectAttr.apply(this.$el, ['on']) || Gumby.click;
+		this.className = Gumby.selectAttr.apply(this.$el, ['classname']) || 'active';
+	};
+
+	// parse data-for attribute, switches will inherit method
+	Toggle.prototype.parseTargets = function() {
+		var targetStr = Gumby.selectAttr.apply(this.$el, ['trigger']),
+			secondaryTargets = 0,
+			targets = [];
+
+		// no targets so return false
+		if(!targetStr) {
+			return false;
+		}
+
+		secondaryTargets = targetStr.indexOf('|');
+
+		// no secondary targets specified so return single target
+		if(secondaryTargets === -1) {
+			return [$(targetStr)];
+		}
+
+		// return array of both targets, split and return 0, 1
+		targets = targetStr.split('|');
+		return targets.length > 1 ? [$(targets[0]), $(targets[1])] : [$(targets[0])];
+	};
+
+	// call triggered event and pass target data
+	Toggle.prototype.triggered = function() {
+		// trigger gumby.onTrigger event and pass array of target status data
+		this.$el.trigger('gumby.onTrigger', [this.$el.hasClass(this.className)]);
+	};
+
+	// Switch object inherits from Toggle
+	Switch.prototype = new Toggle();
+
+	// Toggle specific trigger method
+	Toggle.prototype.trigger = function(cb) {
+		// no targets just toggle active class on toggle
+		if(!this.targets) {
+			this.$el.toggleClass(this.className);
+
+		// combine single target with toggle and toggle active class
+		} else if(this.targets.length == 1) {
+			this.$el.add(this.targets[0]).toggleClass(this.className);
+
+		// if two targets check active state of first
+		// always combine toggle and first target
+		} else if(this.targets.length > 1) {
+			if(this.targets[0].hasClass(this.className)) {
+				this.$el.add(this.targets[0]).removeClass(this.className);
+				this.targets[1].addClass(this.className);
+			} else {
+				this.targets[1].removeClass(this.className);
+				this.$el.add(this.targets[0]).addClass(this.className);
+			}
+		}
+
+		// call event handler here, applying scope of object Switch/Toggle
+		if(cb && typeof cb === 'function') {
+			cb.apply(this);
+		}
+	};
+
+	// Switch specific trigger method
+	Switch.prototype.trigger = function(cb) {
+		// no targets just add active class to switch
+		if(!this.targets) {
+			this.$el.addClass(this.className);
+
+		// combine single target with switch and add active class
+		} else if(this.targets.length == 1) {
+			this.$el.add(this.targets[0]).addClass(this.className);
+
+		// if two targets check active state of first
+		// always combine switch and first target
+		} else if(this.targets.length > 1) {
+			this.$el.add(this.targets[0]).addClass(this.className);
+			this.targets[1].removeClass(this.className);
+		}
+
+		// call event handler here, applying scope of object Switch/Toggle
+		if(cb && typeof cb === 'function') {
+			cb.apply(this);
+		}
+	};
+
+	// add toggle initialisation
+	Gumby.addInitalisation('toggles', function(all) {
+		$('.toggle').each(function() {
+			var $this = $(this);
+
+			// this element has already been initialized
+			// and we're only initializing new modules
+			if($this.data('isToggle') && !all) {
+				return true;
+
+			// this element has already been initialized
+			// and we need to reinitialize it
+			} else if($this.data('isToggle') && all) {
+				$this.trigger('gumby.initialize');
+			}
+
+			// mark element as initialized
+			$this.data('isToggle', true);
+			new Toggle($this);
+		});
+	});
+
+	// add switches initialisation
+	Gumby.addInitalisation('switches', function(all) {
+		$('.switch').each(function() {
+			var $this = $(this);
+
+			// this element has already been initialized
+			// and we're only initializing new modules
+			if($this.data('isSwitch') && !all) {
+				return true;
+
+			// this element has already been initialized
+			// and we need to reinitialize it
+			} else if($this.data('isSwitch') && all) {
+				$this.trigger('gumby.initialize');
+				return true;
+			}
+
+			// mark element as initialized
+			$this.data('isSwitch', true);
+			new Switch($this);
+		});
+	});
+
+	// register UI module
+	Gumby.UIModule({
+		module: 'toggleswitch',
+		events: ['trigger', 'onTrigger'],
+		init: function() {
+			// Run initialize methods
+			Gumby.initialize('switches');
+			Gumby.initialize('toggles');
+		}
+	});
+}();

data/vendor/assets/javascripts/ui/jquery.validation.js

@@ -0,0 +1,138 @@
+/**
+* Gumby jQuery Validation Plugin
+*/
+!function($) {
+
+	'use strict';
+
+	function Validation($this, req) {
+
+		// input and holder .field
+		this.$this = $this;
+		this.$field = this.$this.parents('.field');
+
+		// supplied validation function with default length check
+		this.req = req || function() {
+			return !!this.$this.val().length;
+		};
+
+		// reference to this class
+		var scope = this;
+
+		// checkboxes and radio buttons use gumby.onChange event to validate
+		if(this.$this.is('[type=checkbox], [type=radio]')) {
+			this.$field = this.$this.parent('label');
+			this.$field.on('gumby.onChange', function() {
+				scope.validate();
+			});
+
+		// selects validate on change
+		} else if(this.$this.is('select')) {
+			this.$field = this.$this.parents('.picker');
+			this.$field.on('change', function() {
+				scope.validate();
+			});
+
+		// others (text input, textarea) use blur
+		} else {
+			this.$this.on('blur', function(e) {
+				// ignore tab
+				if(e.which !== 9) {
+					scope.validate();
+				}
+			});
+		}
+	}
+
+	// validate field
+	Validation.prototype.validate = function() {
+
+		var result = this.req(this.$this);
+
+		// failed
+		if(!result) {
+			this.$field.removeClass('success').addClass('danger');
+
+		// passed
+		} else {
+		//} else if(this.$field.hasClass('danger')) {
+			this.$field.removeClass('danger').addClass('success');
+		}
+
+		return result;
+	};
+
+	// jQuery plugin definition
+	$.fn.validation = function(options) {
+
+		var // extend params with defaults
+			settings = $.extend({
+		      		submit : false,
+		      		fail: false,
+		      		required : []
+		    }, options),
+		    // store validation objects
+			validations = [];
+
+		// init each form plugin is called on
+		return this.each(function() {
+
+			// no required fields so plugin is pointless
+			if(!settings.required.length) {
+				return false;
+			}
+
+			var $this = $(this),
+				reqLength = settings.required.length,
+				i;
+
+			// loop round each required field and instantiate new validation object
+			for(i = 0; i < reqLength; i++) {
+				validations.push(new Validation(
+					$this.find('[name="'+settings.required[i].name+'"]'),
+					settings.required[i].validate || false
+				));
+			}
+
+			// hijack submit event
+			$this.on('submit', function(e) {
+
+				// reference to whole form pass/fail
+				var failed = false;
+
+				// if no passed attribute found we should halt form submit
+				if(!$this.data('passed')) {
+					e.preventDefault();
+
+					// loop round validation objects and validate each
+					var reqLength = validations.length, i;
+					for(i = 0; i < reqLength; i++) {
+						if(!validations[i].validate()) {
+							failed = true;
+						}
+					}
+
+					// passed
+					if(!failed) {
+						// if submit method present call that otherwise submit form
+				  		if(settings.submit && typeof settings.submit === 'function') {
+				  			settings.submit($this.serializeArray());
+				  			return;
+				  		}
+
+				  		// store passed bool and re-submit
+				  		$this.data('passed', true).submit();
+
+				  	// failed
+					} else {
+						// call fail method if present
+						if(settings.fail && typeof settings.fail === 'function') {
+				  			settings.fail();
+				  			return;
+				  		}
+					}
+				}
+			});
+		});
+	};
+}(jQuery);