rails_stackview 1.0.0 → 1.0.1

data/vendor/assets/javascripts/stackview/jquery.stackview.infinite.js

@@ -0,0 +1,46 @@
+/*
+   Stack View infinite scroll module:
+
+   This module uses the scroll position of a stack to determine when
+   to fire the base methods of next_page and prev_page.
+*/
+(function($, undefined) {
+	var $d = $(document),
+	    infinite;
+	
+	/* Extend defaults */
+	$.extend(StackView.defaults, {
+		infiniteScrollDistance: 100
+	});
+	
+	infinite = function(event) {
+		var $stack = $(event.target),
+		    stack = $stack.data('stackviewObject'),
+		    opts = stack.options,
+		    $itemList, $items, opts, lastItemTop, triggerPoint, scrollCheck;
+
+		$itemList = $stack.find(opts.selectors.item_list);
+		$items = $stack.find(opts.selectors.item);
+
+		lastItemTop = $items.length ? $items.last().position().top : 0;
+		lastItemTop += $itemList.scrollTop();
+		triggerPoint = lastItemTop - $stack.height() - opts.infiniteScrollDistance;
+		
+		scrollCheck = function() {
+			if (opts.search_type === 'loc_sort_order' &&
+			    $itemList.scrollTop() <= opts.infiniteScrollDistance) {
+				$itemList.unbind('scroll.stackview');
+				$stack.stackView('prev_page');
+			}
+			else if ($itemList.scrollTop() >= triggerPoint) {
+				$itemList.unbind('scroll.stackview');
+				$stack.stackView('next_page');
+			}
+		};
+		
+		$itemList.bind('scroll.stackview', scrollCheck);
+		scrollCheck();
+	};
+	
+	$d.delegate('.stackview', 'stackview.pageload', infinite);
+})(jQuery);

data/vendor/assets/javascripts/stackview/jquery.stackview.ministack.js

@@ -0,0 +1,33 @@
+(function($, undefined) {
+	var $d = $(document),
+	    StackView = window.StackView;
+
+	$.extend(true, StackView.defaults, {
+		classes: {
+			ministack: 'stackview-mini'
+		},
+
+		ministack: {
+			breakpoint: 220,
+			max_height_percentage: 100,
+			min_height_percentage: 80,
+			page_multiple: .08
+		}
+	});
+
+	$d.delegate('.stackview', 'stackview.init', function(event) {
+		var $stack = $(event.target),
+		    stack = $stack.data('stackviewObject');
+
+		if ($stack.width() <= stack.options.ministack.breakpoint) {
+			$stack.addClass(stack.options.classes.ministack);
+			$.each([
+				'max_height_percentage',
+				'min_height_percentage',
+				'page_multiple'
+			], function(i, el) {
+				stack.options.book[el] = stack.options.ministack[el];
+			});
+		}
+	});
+})(jQuery);

data/vendor/assets/javascripts/stackview/jquery.stackview.navigation.js

@@ -0,0 +1,71 @@
+/*
+   Stack View navigation module
+
+   Adds clickable navigation to scroll through the stack, as well as
+   a # of items indicator.
+*/
+(function($, undefined) {
+	var $d = $(document),
+	    StackView = window.StackView;
+	
+	$.extend(true, StackView.defaults, {
+		transitionDuration: 500,
+		transitionEasing: 'easeOutQuad',
+		navigationPercent: 80,
+		selectors: {
+			downstream: '.downstream',
+			upstream: '.upstream',
+			num_items: '.num-found span'
+		}
+	});
+	
+	$d.delegate('.stackview', 'stackview.init', function(event) {
+		var $stack = $(event.target),
+		    stack = $stack.data('stackviewObject'),
+		    $items = $stack.find(stack.options.selectors.item_list),
+		    delta = $stack.height() * stack.options.navigationPercent / 100;
+		
+		stack.num_found_delta = 0;
+		$stack.prepend(tmpl(StackView.templates.navigation, {
+			empty: stack.options.search_type === 'loc_sort_order'
+		}));
+		
+		$stack
+			.delegate(stack.options.selectors.downstream, 'click', function() {
+				$items.animate({
+					scrollTop: '+=' +  delta
+				}, stack.options.transitionDuration, stack.options.transitionEasing);
+				return false;
+			})
+			.delegate(stack.options.selectors.upstream, 'click', function() {
+				$items.animate({
+					scrollTop: '-=' +  delta
+				}, stack.options.transitionDuration, stack.options.transitionEasing);
+				return false;
+			});
+			
+	}).delegate('.stackview', 'stackview.pageload', function(event, data) {
+		var $stack = $(event.target),
+		    stack = $stack.data('stackviewObject'),
+		    num_found = data.num_found ? parseInt(data.num_found, 10) : data.length,
+		    num;
+
+		stack.num_found = num_found;
+		num = num_found + stack.num_found_delta;
+		$stack.find(stack.options.selectors.num_items).text(num);
+		
+	}).delegate(
+		'.stackview',
+		'stackview.itemadded stackview.itemremoved',
+		function(event) {
+			var $stack = $(event.target),
+			    stack = $stack.data('stackviewObject'),
+			    $items = $stack.find(stack.options.selectors.item),
+			    num;
+
+			stack.num_found_delta += (event.namespace === 'itemadded' ? 1 : -1);
+			num = stack.num_found + stack.num_found_delta;
+			$stack.find(stack.options.selectors.num_items).text(num);
+		}
+	);
+})(jQuery);

data/vendor/assets/javascripts/stackview/jquery.stackview.stackcache.js

@@ -0,0 +1,74 @@
+window.stackCache = (function(window, undefined){
+  
+  var cache = {},
+    
+    // "Borrowed" from Modernizr
+    use_localStorage = window.JSON && (function(){
+      try {
+        return ( 'localStorage' in window ) && window.localStorage !== null;
+      } catch(e) {
+        return false;
+      }
+    })();
+  
+  // Expose these methods.
+  return {
+    set: set,
+    get: get,
+    remove: remove
+  };
+  
+  // Set a key-value pair with optional TTL.
+  function set( key, value, ttl ) {
+    var expires = ttl && new Date( +new Date() + ttl * 1000 ),
+      obj = {
+        expires: +expires,
+        value: value
+      };
+    
+    if ( use_localStorage ) {
+      try {
+        localStorage[ key ] = JSON.stringify( obj );
+      } catch(e) {
+        return e;
+      }
+    } else {
+      cache[ key ] = obj;
+    }
+  };
+  
+  // Get a value if it exists and hasn't expired.
+  function get( key ) {
+    var obj,
+      val;
+    
+    if ( use_localStorage ) {
+      obj = localStorage[ key ];
+      if ( obj ) {
+        obj = JSON.parse( obj );
+      }
+    } else {
+      obj = cache[ key ];
+    }
+    
+    if ( obj ) {
+      if ( obj.expires && obj.expires < +new Date() ) {
+        remove( key );
+      } else {
+        val = obj.value;
+      }
+    }
+    
+    return val;
+  };
+  
+  // Remove a key-value pair.
+  function remove( key ) {
+    if ( use_localStorage ) {
+      localStorage.removeItem( key );
+    } else {
+      delete cache[ key ];
+    }
+  };
+  
+})(window);

data/vendor/assets/javascripts/stackview/jquery.stackview.templates.js

@@ -0,0 +1,31 @@
+(function(undefined) {
+	StackView.templates = {
+		scaffold: '\
+			<div class="ribbon"><%= ribbon %></div>\
+			<ul class="stack-items" />',
+		
+		navigation: '\
+			<div class="stack-navigation<%= empty ? " empty" : ""%>">\
+				<div class="upstream">Up</div>\
+				<div class="num-found">\
+					<span></span><br />items\
+				</div>\
+				<div class="downstream">Down</div>\
+			</div>',
+		
+		book: '\
+			<li class="stack-item stack-book heat<%= heat %>" style="width:<%= book_height %>; height:<%= book_thickness %>;">\
+				<a href="<%= link %>" target="_newtab">\
+					<span class="spine-text">\
+						<span class="spine-title"><%= title %></span>\
+						<span class="spine-author"><%= author %></span>\
+					</span>\
+					<span class="spine-year"><%= year %></span>\
+					<span class="stack-pages" />\
+					<span class="stack-cover" />\
+				</a>\
+			</li>',
+		
+		placeholder: '<li class="stackview-placeholder"></li>'
+	}
+})();

data/vendor/assets/javascripts/stackview/microtemplating.js

@@ -0,0 +1,40 @@
+/*!
+ Simple JavaScript Templating originally by John Resig:
+ http://ejohn.org/blog/javascript-micro-templating/
+ Modified by Rick Strahl:
+ http://west-wind.com/weblog/posts/2008/Oct/13/Client-Templating-with-jQuery
+ MIT Licensed
+*/
+(function() {
+	var cache = {};
+
+	this.tmpl = function tmpl(str, data) {
+		// Figure out if we're getting a template, or if we need to
+		// load the template - and be sure to cache the result.
+		var fn = !/\W/.test(str) ?
+			cache[str] = cache[str] || tmpl(document.getElementById(str).innerHTML) :
+
+			// Generate a reusable function that will serve as a template
+			// generator (and which will be cached).
+			new Function("obj",
+				"var p=[],print=function(){p.push.apply(p,arguments);};" +
+
+				// Introduce the data as local variables using with(){}
+				"with(obj){p.push('" +
+
+				// Convert the template into pure JavaScript
+				str
+					.replace(/[\r\t\n]/g, " ")
+					.replace(/'(?=[^%]*%>)/g,"\t")
+					.split("'").join("\\'")
+					.split("\t").join("'")
+					.replace(/^[\r\t\n ]+/, '')
+					.replace(/<%=(.+?)%>/g, "',$1,'")
+					.split("<%").join("');")
+					.split("%>").join("p.push('")
+				+ "');}return p.join('');");
+
+ 		// Provide some basic currying to the user
+		return data ? fn(data) : fn;
+	};
+})();

data/vendor/assets/javascripts/stackview/types/book.js

@@ -0,0 +1,184 @@
+(function($, window, undefined) {
+	/*
+	   Extend StackView defaults to include options for this item type.
+
+	   max_height_percentage
+	      Books with the maximum height will render as this percentage
+	      width in the stack.
+
+	   max_height
+		    The maximum height in centimeters that an item will render as,
+		    regardless of the true height of the item.
+
+		 max_pages
+		    The maximum number of pages that a book will render as,
+		    regardless of the true number of pages.
+
+		 min_height_percentage
+		    Books with the minimum height will render as this percentage
+		    width in the stack.
+
+		 min_height
+		    The minimum height in centimeters that an item will render as,
+		    regardless of the true height of the item.
+
+		 min_pages
+		    The minimum number of pages that a book will render as,
+		    regardless of the true number of pages.
+
+		 page_multiple
+		    A number that when multiplied by the number of pages in a book
+		    gives us the total pixel height to be rendered.
+
+		 selectors.book
+		    Item selector specific to the book type.
+	*/
+	$.extend(true, window.StackView.defaults, {
+		book: {
+			max_height_percentage: 100,
+			max_height: 39,
+			max_pages: 540,
+			min_height_percentage: 59,
+			min_height: 20,
+			min_pages: 200,
+			page_multiple: 0.20
+		},
+
+		selectors: {
+			book: '.stack-book'
+		}
+	});
+
+	/*
+	   #translate(number, number, number, number, number) - Private
+	
+	   Takes a value (the first argument) and two ranges of numbers. Translates
+	   this value from the first range to the second range.  E.g.:
+	
+	   translate(0, 0, 10, 50, 100) returns 50.
+	   translate(10, 0, 10, 50, 100) returns 100.
+	   translate(5, 0, 10, 50, 100) returns 75.
+	
+	   http://stackoverflow.com/questions/1969240/mapping-a-range-of-values-to-another
+	*/
+	var translate = function(value, start_min, start_max, end_min, end_max) {
+		var start_range = start_max - start_min,
+		    end_range = end_max - end_min,
+		    scale = (value - start_min) / (start_range);
+		
+		return end_min + scale * end_range;
+	};
+
+	/*
+	   #get_height(StackView, object) - Private
+	
+	   Takes a StackView options object and a book object. Returns a
+	   normalized book height percentage, taking into account the minimum
+	   height, maximum height, height multiple, and translating them onto
+	   the percentage range specified in the stack options.
+	*/
+	var get_height = function(options, book) {
+		var height = parseInt(book.measurement_height_numeric, 10),
+		    min = options.book.min_height,
+		    max = options.book.max_height;
+		
+		if (isNaN(height)) {
+			height = min;
+		}
+		height = Math.min(Math.max(height, min), max);
+		height = translate(
+			height,
+			options.book.min_height,
+			options.book.max_height,
+			options.book.min_height_percentage,
+			options.book.max_height_percentage
+		);
+		return height + '%';
+	};
+
+	/*
+	   #get_thickness(StackView, object) - Private
+	
+	   Takes a StackView instance and a book object. Returns a normalized
+	   book thickness using the number of book pages, taking into account
+	   the minimum pages, maximum pages, and pages multiple.
+	*/
+	var get_thickness = function(options, book) {
+		var thickness = parseInt(book.measurement_page_numeric, 10),
+		    min = options.book.min_pages,
+		    max = options.book.max_pages,
+		    multiple = options.book.page_multiple;
+		
+		if (isNaN(thickness)) {
+			thickness = min;
+		}
+		thickness = Math.min(Math.max(thickness, min), max) * multiple;
+		return thickness + 'px';
+	};
+
+	/*
+	   #normalize_link(object) - Private
+	
+	   Takes an item and returns the item's link, taking into account
+	   workarounds that may come from inconsistent data structure.
+	*/
+	var normalize_link = function(item) {
+		//workaround for link construction from LibraryCloud
+		return item.title_link_friendly ?
+			'../shelflife/book/' + item.title_link_friendly + '/' + item.id :
+			item.link;
+	};
+
+	/*
+	   #get_author(object) - Private
+	
+	   Takes an item and returns the item's author, taking the first
+	   author if an array of authors is defined.
+	*/
+	var get_author = function(item) {
+		var author = item.creator && item.creator.length ? item.creator[0] : '';
+		
+		if(/^([^,]*)/.test(author)) {
+			author = author.match(/^[^,]*/);
+		}
+		
+		return author;
+	};
+
+
+	/*
+	   Book type definition.
+	*/
+	window.StackView.register_type({
+		name: 'book',
+
+		match: function(item) {
+			return (item.format && item.format === 'book') || !item.format;
+		},
+
+		adapter: function(item, options) {
+			return {
+				heat: window.StackView.utils.get_heat(item.shelfrank),
+				book_height: get_height(options, item),
+				book_thickness: get_thickness(options, item),
+				link: normalize_link(item),
+				title: item.title,
+				author: get_author(item),
+				year: item.pub_date
+			};
+		},
+
+		template: '\
+			<li class="stack-item stack-book heat<%= heat %>" style="width:<%= book_height %>; height:<%= book_thickness %>;">\
+				<a href="<%= link %>" target="_blank">\
+					<span class="spine-text">\
+						<span class="spine-title"><%= title %></span>\
+						<span class="spine-author"><%= author %></span>\
+					</span>\
+					<span class="spine-year"><%= year %></span>\
+					<span class="stack-pages" />\
+					<span class="stack-cover" />\
+				</a>\
+			</li>'
+	});
+})(jQuery, window);