deckrb 0.1.0

data/deck/test/settings.js

@@ -0,0 +1,3 @@
+// SETTINGS, VARS, UTILITY FUNCTIONS
+jasmine.getFixtures().fixturesPath = 'fixtures';
+var defaults = $.deck.defaults;

data/deck/test/spec.core.js

@@ -0,0 +1,434 @@
+// Go tests, go
+describe('Deck JS', function() {
+	describe('standard html structure', function() {
+		beforeEach(function() {
+			loadFixtures('standard.html');
+			if (Modernizr.history) {
+				history.replaceState({}, "", "#")
+			}
+			else {
+				window.location.hash = '#';
+			}
+		});
+
+		describe('init(selector)', function() {
+			it('should create slides', function() {
+				$.deck('.slide');
+				expect($.deck('getSlides').length).toEqual($('.slide').length);
+			});
+		});
+
+		describe('init([selectors])', function() {
+			it('should create slides', function() {
+				$.deck([
+					'.slide1',
+					'.slide2',
+					'.slide3',
+					'.slide4',
+					'.slide5'
+				]);
+				expect($.deck('getSlides').length).toEqual($('.slide').length);
+			});
+		});
+
+		describe('navigation functions', function() {
+			beforeEach(function() {
+				$.deck('.slide');
+			});
+
+			describe('go(i)', function() {
+				it('should go to the i slide (0 based index)', function() {
+					$.deck('go', 3);
+					expect($.deck('getSlide')).toHaveClass('slide4');
+				});
+
+				it('should go to the slide with specified id', function() {
+					$.deck('go', 'custom-id');
+					expect($.deck('getSlide')).toHaveId('custom-id');
+				});
+
+				it('should go nowhere if i is out of bounds', function() {
+					$.deck('go', 5);
+					expect($.deck('getSlide')).toHaveClass('slide1');
+				});
+				
+				it('should go nowhere if id does not exist', function() {
+					$.deck('go', 'i-dont-exist');
+					expect($.deck('getSlide')).toHaveClass('slide1');
+				});
+			});
+
+			describe('next()', function() {
+				it('should go to the next slide', function() {
+					$.deck('next');
+					expect($.deck('getSlide')).toHaveClass('slide2');
+				});
+
+				it('should go nowhere if on the last slide', function() {
+					$.deck('go', 4);
+					$.deck('next');
+					expect($.deck('getSlide')).toHaveClass('slide5');
+				});
+			});
+
+			describe('prev()', function() {
+				it('should go to the previous slide', function() {
+					$.deck('go', 2);
+					$.deck('prev');
+					expect($.deck('getSlide')).toHaveClass('slide2');
+				});
+
+				it('should go nowhere if on the first slide', function() {
+					$.deck('prev');
+					expect($.deck('getSlide')).toHaveClass('slide1');
+				});
+			});
+		});
+
+		describe('getters', function() {
+			beforeEach(function() {
+				$.deck('.slide');
+			});
+
+			describe('getSlide()', function() {
+				it('should get the current slide', function() {
+					expect($.deck('getSlide')).toHaveClass('slide1');
+					$.deck('go', 2);
+					expect($.deck('getSlide')).toHaveClass('slide3');
+				});
+			});
+
+			describe('getSlide(i)', function() {
+				it('should get slide number i (0 based index)', function() {
+					expect($.deck('getSlide', 1)).toHaveClass('slide2');
+					expect($.deck('getSlide', 3)).toHaveClass('slide4');
+				});
+
+				it('should return null if i is NaN', function() {
+					expect($.deck('getSlide', 'barfoo')).toBeNull();
+				});
+
+				it('should return null if i is out of bounds', function() {
+					expect($.deck('getSlide', 6)).toBeNull();
+				});
+			});
+
+			describe('getSlides()', function() {
+				it('should return an array of jQuery objects for each slide', function() {
+					var expectation = [],
+					slides = $.deck('getSlides');
+					$('.slide').each(function() {
+						expectation.push($(this));
+					});
+					expect(slides).toEqual(expectation);
+				});
+			});
+			
+			describe('getContainer()', function() {
+				it('should return a jQuery object with the container element(s)', function() {
+					expect($.deck('getContainer')).toBe(defaults.selectors.container);
+				});
+			});
+			
+			describe('getOptions()', function() {
+				it('should return the current options object', function() {
+					expect($.deck('getOptions')).toEqual(defaults);
+				});
+			});
+		});
+
+		describe('container states', function() {
+			beforeEach(function() {
+				$.deck('.slide');
+			});
+
+			it('should start at state 0', function() {
+				expect($(defaults.selectors.container)).toHaveClass(defaults.classes.onPrefix + '0');
+			});
+
+			it('should change states with the slide number', function() {
+				$.deck('next');
+				expect($(defaults.selectors.container)).toHaveClass(defaults.classes.onPrefix + '1');
+				$.deck('go', 3);
+				expect($(defaults.selectors.container)).toHaveClass(defaults.classes.onPrefix + '3');
+				$.deck('prev');
+				expect($(defaults.selectors.container)).toHaveClass(defaults.classes.onPrefix + '2');
+			});
+		});
+
+		describe('options object', function() {
+			var $d = $(document);
+
+			beforeEach(function() {
+				$.deck('.alt-slide', {
+					classes: {
+						after: 'alt-after',
+						before: 'alt-before',
+						current: 'alt-current',
+						onPrefix: 'alt-on-',
+						next: 'alt-next',
+						previous: 'alt-prev'
+					},
+
+					selectors: {
+						container: '.alt-container'
+					},
+
+					keys: {
+						next: 87,
+						previous: 69
+					}
+				});
+			});
+
+			describe('classes', function() {
+				it('should use the specified after class', function() {
+					expect($('.alt-slide3, .alt-slide4, .alt-slide5')).toHaveClass('alt-after');
+				});
+
+				it('should use the specified before class', function() {
+					$.deck('go', 4);
+					expect($('.alt-slide1, .alt-slide2, .alt-slide3')).toHaveClass('alt-before');
+				});
+
+				it('should use the specified container class', function() {
+					$.deck('go', 2);
+					expect($('.alt-container')).toHaveClass('alt-on-2');
+				});
+
+				it('should use the specified current class', function() {
+					expect($.deck('getSlide')).toHaveClass('alt-current');
+				});
+
+				it('should use the specified next class', function() {
+					expect($('.alt-slide2')).toHaveClass('alt-next');
+				});
+
+				it('should use the specified previous class', function() {
+					$.deck('next');
+					expect($('.alt-slide1')).toHaveClass('alt-prev');
+				});
+			});
+
+			describe('key bindings', function() {
+				var e;
+
+				beforeEach(function() {
+					e = jQuery.Event('keydown.deck');
+				});
+
+				it('should go to the next slide using the specified key', function() {
+					e.which = 87; // 'w'
+					$d.trigger(e);
+					expect($.deck('getSlide')).toHaveClass('alt-slide2');
+				});
+
+				it('should go to the previous slide using the specified key', function() {
+					$.deck('next');
+					e.which = 69; // 'e'
+					$d.trigger(e);
+					expect($.deck('getSlide')).toHaveClass('alt-slide1');
+				});
+				
+				it('should not trigger events that originate within editable elements', function() {
+					e = jQuery.Event('keydown');
+					e.which = 87;
+					$('.alt-slide1 input').trigger(e);
+					expect($.deck('getSlide')).toHaveClass('alt-slide1');
+				});
+			});
+		});
+
+		describe('events', function() {
+			var $d = $(document);
+
+			beforeEach(function() {
+				spyOnEvent($d, 'deck.init');
+				spyOnEvent($d, 'deck.beforeInit');
+				$.deck('.slide');
+				$.deck('go', 1);
+				spyOnEvent($d, 'deck.change');
+			});
+
+			describe('deck.change', function() {
+				it('should fire on go(i)', function() {
+					$.deck('go', 3);
+					expect('deck.change').toHaveBeenTriggeredOn($d);
+				});
+
+				it('should fire on next()', function() {
+					$.deck('next');
+					expect('deck.change').toHaveBeenTriggeredOn($d);
+				});
+
+				it('should fire on prev()', function() {
+					$.deck('prev');
+					expect('deck.change').toHaveBeenTriggeredOn($d);
+				});
+
+				it('should pass parameters with from and to indices', function() {
+					var f = function(e, from, to) {
+						expect(from).toEqual(1);
+						expect(to).toEqual(3);
+					};
+					
+					$d.bind('deck.change', f);
+					$.deck('go', 3);
+					$d.unbind('deck.change', f);
+				});
+				
+				it('should not change slides if default prevented', function() {
+					$d.bind('deck.change', false);
+					$.deck('go', 3);
+					expect($.deck('getSlide')).toEqual($.deck('getSlide', 1));
+					$d.unbind('deck.change', false);
+				});
+			});
+			
+			describe('deck.init', function() {
+				it('should fire on deck initialization', function() {
+					expect('deck.init').toHaveBeenTriggeredOn($d);
+				});
+				
+				it('should have already populated the slides array', function() {
+					var f = function() {
+						expect($.deck('getSlides').length).toBeGreaterThan(0);
+					};
+					
+					$d.bind('deck.init', f);
+					$.deck('.slide');
+					$d.unbind('deck.init', f);
+				});
+			});
+			
+			describe('deck.beforeInit', function() {
+				it('should fire on deck initialization', function() {
+					expect('deck.beforeInit').toHaveBeenTriggeredOn($d);
+				});
+				
+				it('should have not populated the slides array', function() {
+					var f = function() {
+						expect($.deck('getSlides').length).toEqual(0);
+					};
+					
+					$d.bind('deck.beforeInit', f);
+					$.deck('.slide');
+					$d.unbind('deck.beforeInit', f);
+				});
+			});
+		});
+	});
+	
+	describe('complex html structure', function() {
+		beforeEach(function() {
+			loadFixtures('complex.html');
+			if (Modernizr.history) {
+				history.replaceState({}, "", "#")
+			}
+			$.deck([
+				'.slide1',
+				'.slide2',
+				'.slide3',
+				'.slide4',
+				'.slide5',
+				'.slide6',
+				'.slide7',
+				'.slide8',
+				'.slide9',
+				'.slide10',
+			]);
+			$.deck('go', 2);
+		});
+		
+		describe('compound state classes', function() {
+			it('should apply current class', function() {
+				$('.slide3').each(function(i, el) {
+					expect($(el)).toHaveClass(defaults.classes.current);
+				});
+			});
+			
+			it('should apply previous class', function() {
+				$('.slide2').each(function(i, el) {
+					expect($(el)).toHaveClass(defaults.classes.previous);
+				});
+			});
+			
+			it('should apply next class', function() {
+				$('.slide4').each(function(i, el) {
+					expect($(el)).toHaveClass(defaults.classes.next);
+				});
+			});
+			
+			it('should apply before class', function() {
+				$('.slide1').each(function(i, el) {
+					expect($(el)).toHaveClass(defaults.classes.before);
+				});
+			});
+			
+			it('should apply after class', function() {
+				$('.slide5, .slide6, .slide7, .slide8, .slide9, .slide10').each(function(i, el) {
+					expect($(el)).toHaveClass(defaults.classes.after);
+				});
+			});
+			
+			it('should apply child-current class', function() {
+				expect($('.slide2').not('.slide10')).toHaveClass(defaults.classes.childCurrent);
+			});
+		});
+		
+		it('should remove old state classes', function() {
+			$.deck('go', 4);
+			expect($('.slide3').not('.slide5')).not.toHaveClass(defaults.classes.current);
+			expect($('.slide2').not('.slide4')).not.toHaveClass(defaults.classes.previous);
+			expect($('.slide4').not('.slide6')).not.toHaveClass(defaults.classes.next);
+		});
+	});
+
+	describe('iframes', function() {
+		beforeEach(function() {
+			loadFixtures('iframes.html');
+			if (Modernizr.history) {
+				history.replaceState({}, "", "#")
+			}
+			$.deck([
+				'.slide1',
+				'.slide2',
+				'.slide3',
+				'.slide4',
+				'.slide5',
+				'.slide6',
+				'.slide7',
+				'.slide8',
+				'.slide9',
+				'.slide10',
+			]);
+
+		});
+
+		it('should remove/restore iframe sources when leaving/entering a slide', function() {
+			$.deck('go', 4);
+        	expect($.deck('getSlide').find('iframe').attr('src')).toEqual('fixtures/iframe_simple.html');
+        	$.deck('next');
+        	expect($('.slide5').find('iframe').attr('src')).toEqual('');
+            $.deck('prev');
+            expect($('.slide5').find('iframe').attr('src')).toEqual('fixtures/iframe_simple.html');
+        });
+
+		it('should not store blank iframe sources', function() {
+		  $.deck('go', 6);
+		  $.deck('next');
+		  expect($.deck('getSlide').find('iframe').data('src')).toBeUndefined();
+		});
+	});
+	
+	describe('empty deck', function() {
+		beforeEach(function() {
+			loadFixtures('empty.html');
+			$.deck('.slide');
+		});
+		
+		describe('getSlide()', function() {
+			it('should not error on init', $.noop);
+		});
+	});
+});

data/deck/test/spec.goto.js

@@ -0,0 +1,119 @@
+describe('Deck JS Quick Go-To', function() {
+	var $d = $(document);
+	
+	beforeEach(function() {
+		loadFixtures('standard.html');
+		if (Modernizr.history) {
+			history.replaceState({}, "", "#")
+		}
+		else {
+			window.location.hash = '#';
+		}
+		$.deck('.slide');
+	});
+	
+	describe('showGoTo()', function() {
+		it('should show the go-to helper', function() {
+			expect($(defaults.selectors.container)).not.toHaveClass(defaults.classes.goto);
+			$.deck('showGoTo');
+			expect($(defaults.selectors.container)).toHaveClass(defaults.classes.goto);
+		});
+		
+		it('should focus the go-to input', function() {
+			$.deck('showGoTo');
+			expect($(defaults.selectors.gotoInput)[0]).toEqual(document.activeElement);
+		});
+	});
+	
+	describe('hideGoTo()', function() {
+		beforeEach(function() {
+			$.deck('showGoTo');
+			$.deck('hideGoTo');
+		});
+		
+		it('should hide the go-to helper', function() {
+			expect($(defaults.selectors.container)).not.toHaveClass(defaults.classes.goto);
+		});
+		
+		it('should blur the go-to input', function() {
+			expect($(defaults.selectors.gotoInput)[0]).not.toEqual(document.activeElement);
+		});
+	});
+	
+	describe('toggleGoTo()', function() {
+		it('should toggle the go-to helper on and off', function() {
+			expect($(defaults.selectors.container)).not.toHaveClass(defaults.classes.goto);
+			$.deck('toggleGoTo');
+			expect($(defaults.selectors.container)).toHaveClass(defaults.classes.goto);
+			$.deck('toggleGoTo');
+			expect($(defaults.selectors.container)).not.toHaveClass(defaults.classes.goto);
+		});
+	});
+	
+	describe('Go-To submit', function() {
+		beforeEach(function() {
+			$.deck('showGoTo');
+		});
+		
+		it('should hide the go-to helper', function() {
+			$(defaults.selectors.gotoInput).val('3');
+			$(defaults.selectors.gotoForm).submit();
+			expect($(defaults.selectors.container)).not.toHaveClass(defaults.classes.goto);
+		});
+		
+		it('should go to the slide number entered', function() {
+			$(defaults.selectors.gotoInput).val('3');
+			$(defaults.selectors.gotoForm).submit();
+			expect($.deck('getSlide')).toEqual($.deck('getSlide'), 2);
+		});
+		
+		it('should go to the slide id entered', function() {
+			$(defaults.selectors.gotoInput).val('custom-id');
+			$(defaults.selectors.gotoForm).submit();
+			expect($.deck('getSlide')).toEqual($.deck('getSlide'), 1);
+		});
+		
+		it('should go nowhere if the number is negative', function() {
+			$(defaults.selectors.gotoInput).val('-2');
+			$(defaults.selectors.gotoForm).submit();
+			expect($.deck('getSlide')).toEqual($.deck('getSlide'), 0);
+		});
+		
+		it('should go nowhere if the number is greater than the number of slides', function() {
+			$(defaults.selectors.gotoInput).val('9');
+			$(defaults.selectors.gotoForm).submit();
+			expect($.deck('getSlide')).toEqual($.deck('getSlide'), 0);
+		});
+		
+		it('should go nowhere if the id does not exist', function() {
+			$(defaults.selectors.gotoInput).val('do-not-exist');
+			$(defaults.selectors.gotoForm).submit();
+			expect($.deck('getSlide')).toEqual($.deck('getSlide'), 0);
+		});
+	});
+	
+	describe('Datalist population', function() {
+		it('should fill in options with all the slide ids', function() {
+			var $dataOptions = $(defaults.selectors.gotoDatalist).find('option');
+			expect($dataOptions.length).toEqual(5);
+			expect($dataOptions.eq(0).attr('value')).toEqual('slide-0');
+			expect($dataOptions.eq(1).attr('value')).toEqual('custom-id');
+		});
+	});
+	
+	describe('key bindings', function() {
+		var e;
+
+		beforeEach(function() {
+			e = jQuery.Event('keydown.deckgoto');
+		});
+		
+		it('should toggle the go-to helper if the specified key is pressed', function() {
+			e.which = 71; // g
+			$d.trigger(e);
+			expect($(defaults.selectors.container)).toHaveClass(defaults.classes.goto);
+			$d.trigger(e);
+			expect($(defaults.selectors.container)).not.toHaveClass(defaults.classes.goto);
+		});
+	});
+});