You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
523 lines
16 KiB
523 lines
16 KiB
/* ******************************
|
|
Module - Simple Tab Navigation
|
|
Author: Jack Lukic
|
|
Notes: First Commit Aug 15, 2012
|
|
|
|
History based tab navigation
|
|
****************************** */
|
|
|
|
;(function ($, window, document, undefined) {
|
|
|
|
$.fn.tabNavigation = function(parameters) {
|
|
|
|
var
|
|
settings = $.extend(true, {}, $.fn.tabNavigation.settings, parameters),
|
|
|
|
$tabNavigation = $(this),
|
|
$tabs = $(settings.context).find(settings.selector.tabs),
|
|
|
|
firstLoad = true,
|
|
cache = {},
|
|
recursionDepth = 0,
|
|
|
|
activeTabPath,
|
|
parameterArray,
|
|
historyEvent,
|
|
|
|
className = settings.className,
|
|
metadata = settings.metadata,
|
|
namespace = settings.namespace,
|
|
errors = settings.errors,
|
|
|
|
instance = $tabNavigation.data('module'),
|
|
|
|
query = arguments[0],
|
|
methodInvoked = (instance !== undefined && typeof query == 'string'),
|
|
passedArguments = [].slice.call(arguments, 1),
|
|
|
|
module,
|
|
invokedResponse
|
|
;
|
|
|
|
module = {
|
|
|
|
initialize: function() {
|
|
module.debug('Initializing Tabs', $tabNavigation);
|
|
// attach history events
|
|
if(settings.history && settings.path !== false) {
|
|
if( $.address !== undefined ) {
|
|
module.verbose('Address library found adding state change event');
|
|
$.address
|
|
.state(settings.path)
|
|
.change(module.event.history.change)
|
|
;
|
|
}
|
|
else {
|
|
module.error(errors.state);
|
|
}
|
|
}
|
|
// attach events if navigation wasn't set to window
|
|
if( !$.isWindow( $tabNavigation.get(0) ) ) {
|
|
$tabNavigation
|
|
.on('click.' + namespace, module.event.click)
|
|
;
|
|
}
|
|
$tabNavigation
|
|
.data('module', module)
|
|
;
|
|
},
|
|
|
|
destroy: function() {
|
|
module.debug('Destroying tabs', $tabNavigation);
|
|
$tabNavigation
|
|
.off('.' + namespace)
|
|
;
|
|
},
|
|
|
|
event: {
|
|
click: function() {
|
|
module.debug('Navigation clicked');
|
|
var
|
|
tabPath = $(this).data(metadata.tab)
|
|
;
|
|
if(tabPath !== undefined) {
|
|
if(tabPath !== activeTabPath) {
|
|
if(settings.history) {
|
|
$.address.value(tabPath);
|
|
}
|
|
else {
|
|
module.change(tabPath);
|
|
}
|
|
}
|
|
}
|
|
else {
|
|
module.debug('No tab specified');
|
|
}
|
|
},
|
|
history: {
|
|
change: function(event) {
|
|
var
|
|
tabPath = event.pathNames.join('/') || module.get.initialPath(),
|
|
pageTitle = settings.templates.determineTitle(tabPath) || false
|
|
;
|
|
module.debug('History change event', tabPath, event);
|
|
historyEvent = event;
|
|
if(tabPath !== undefined) {
|
|
module.change(tabPath);
|
|
}
|
|
if(pageTitle) {
|
|
$.address.title(pageTitle);
|
|
}
|
|
}
|
|
}
|
|
},
|
|
|
|
refresh: function() {
|
|
if(activeTabPath) {
|
|
module.debug('Refreshing tab', activeTabPath);
|
|
module.change(activeTabPath);
|
|
}
|
|
},
|
|
|
|
cache: {
|
|
read: function(tabPath) {
|
|
return (tabPath !== undefined)
|
|
? cache[tabPath]
|
|
: cache
|
|
;
|
|
},
|
|
add: function(tabPath, content) {
|
|
tabPath = tabPath || activeTabPath;
|
|
module.debug('Adding cached content for', tabPath);
|
|
cache[tabPath] = content;
|
|
},
|
|
remove: function(tabPath) {
|
|
tabPath = tabPath || activeTabPath;
|
|
module.debug('Removing cached content for', tabPath);
|
|
delete cache[tabPath];
|
|
}
|
|
},
|
|
|
|
change: function(tabPath) {
|
|
var
|
|
pathArray = module.get.defaultPathArray(tabPath)
|
|
;
|
|
module.deactivate.all();
|
|
$.each(pathArray, function(index, tab) {
|
|
var
|
|
currentPathArray = pathArray.slice(0, index + 1),
|
|
currentPath = module.utils.arrayToPath(currentPathArray),
|
|
|
|
isLastTab = (module.utils.last(pathArray) == currentPath),
|
|
isTab = module.is.tab(currentPath),
|
|
isParam = !(isTab),
|
|
|
|
pushStateAvailable = (window.history && window.history.pushState),
|
|
shouldIgnoreLoad = (pushStateAvailable && settings.ignoreFirstLoad && firstLoad),
|
|
remoteContent = $.isPlainObject(settings.apiSettings),
|
|
|
|
$tab = module.get.tabElement(currentPath)
|
|
;
|
|
module.verbose('Looking for tab', tab);
|
|
if(isParam) {
|
|
module.verbose('Tab is not found, assuming it is a parameter', tab);
|
|
return true;
|
|
}
|
|
else if(isTab) {
|
|
// scope up
|
|
module.verbose('Tab was found', tab);
|
|
activeTabPath = currentPath;
|
|
parameterArray = module.utils.filterArray(pathArray, currentPathArray);
|
|
if(isLastTab && remoteContent) {
|
|
if(!shouldIgnoreLoad) {
|
|
module.activate.navigation(currentPath);
|
|
module.content.fetch(currentPath, settings.onTabLoad);
|
|
}
|
|
else {
|
|
module.debug('Ignoring remote content on first tab load', currentPath);
|
|
firstLoad = false;
|
|
cache[tabPath] = $tab.html();
|
|
module.activate.all(currentPath);
|
|
$.proxy(settings.onTabInit, $tab)(currentPath, parameterArray, historyEvent);
|
|
}
|
|
}
|
|
else {
|
|
module.debug('Opened tab', currentPath);
|
|
module.activate.all(currentPath);
|
|
$.proxy(settings.onTabLoad, $tab)(currentPath, parameterArray, historyEvent);
|
|
}
|
|
|
|
}
|
|
});
|
|
},
|
|
|
|
content: {
|
|
|
|
fetch: function(tabPath) {
|
|
var
|
|
$tab = module.get.tabElement(tabPath),
|
|
cachedContent = cache[tabPath] || false,
|
|
apiSettings = {
|
|
dataType : 'html',
|
|
stateContext : $tab,
|
|
success : function(response) {
|
|
cache[tabPath] = response;
|
|
module.content.update(tabPath, response);
|
|
if(tabPath == activeTabPath) {
|
|
module.debug('Content loaded', tabPath);
|
|
module.activate.tab(tabPath);
|
|
}
|
|
else {
|
|
module.debug('Content loaded in background', tabPath);
|
|
}
|
|
$.proxy(settings.onTabInit, $tab)(tabPath, parameterArray, historyEvent);
|
|
},
|
|
urlData: { tab: tabPath }
|
|
},
|
|
request = $tab.data(metadata.promise) || false,
|
|
existingRequest = ( request && request.state() === 'pending' )
|
|
;
|
|
if(settings.cache && cachedContent) {
|
|
module.debug('Showing existing content', tabPath);
|
|
// module.content.update(tabPath, cachedContent);
|
|
module.activate.tab(tabPath);
|
|
$.proxy(settings.onTabLoad, $tab)(tabPath, parameterArray, historyEvent);
|
|
}
|
|
else if(existingRequest) {
|
|
module.debug('Content is already loading', tabPath);
|
|
$tab
|
|
.addClass(className.loading)
|
|
;
|
|
}
|
|
else if($.api !== undefined) {
|
|
module.debug('Retrieving content', tabPath);
|
|
$.api( $.extend(true, {}, settings.apiSettings, apiSettings) );
|
|
}
|
|
else {
|
|
module.error(errors.api);
|
|
}
|
|
},
|
|
|
|
update: function(tabPath, html) {
|
|
module.debug('Updating html for', tabPath);
|
|
var
|
|
$tab = module.get.tabElement(tabPath)
|
|
;
|
|
$tab
|
|
.html(html)
|
|
;
|
|
}
|
|
},
|
|
|
|
activate: {
|
|
all: function(tabPath) {
|
|
module.activate.tab(tabPath);
|
|
module.activate.navigation(tabPath);
|
|
},
|
|
tab: function(tabPath) {
|
|
var
|
|
$tab = module.get.tabElement(tabPath)
|
|
;
|
|
module.verbose('Showing tab content for', $tab);
|
|
$tab.addClass(className.active);
|
|
},
|
|
navigation: function(tabPath) {
|
|
var
|
|
$nav = module.get.navElement(tabPath)
|
|
;
|
|
module.verbose('Activating tab navigation for', $nav);
|
|
$nav.addClass(className.active);
|
|
}
|
|
},
|
|
|
|
deactivate: {
|
|
all: function() {
|
|
module.deactivate.navigation();
|
|
module.deactivate.tabs();
|
|
},
|
|
navigation: function() {
|
|
$tabNavigation
|
|
.removeClass(className.active)
|
|
;
|
|
},
|
|
tabs: function() {
|
|
$tabs
|
|
.removeClass(className.active + ' ' + className.loading)
|
|
;
|
|
}
|
|
},
|
|
|
|
is: {
|
|
tab: function(tabName) {
|
|
return ( module.get.tabElement(tabName).size() > 0 );
|
|
}
|
|
},
|
|
|
|
get: {
|
|
initialPath: function() {
|
|
return $tabNavigation.eq(0).data(metadata.tab) || $tabs.eq(0).data(metadata.tab);
|
|
},
|
|
// adds default tabs to tab path
|
|
defaultPathArray: function(tabPath) {
|
|
return module.utils.pathToArray( module.get.defaultPath(tabPath) );
|
|
},
|
|
defaultPath: function(tabPath) {
|
|
var
|
|
$defaultNav = $tabNavigation.filter('[data-' + metadata.tab + '^="' + tabPath + '/"]').eq(0),
|
|
defaultTab = $defaultNav.data(metadata.tab) || false
|
|
;
|
|
if( defaultTab ) {
|
|
module.debug('Found default tab', defaultTab);
|
|
if(recursionDepth < settings.maxDepth) {
|
|
recursionDepth++;
|
|
return module.get.defaultPath(defaultTab);
|
|
}
|
|
module.error(errors.recursion);
|
|
}
|
|
recursionDepth = 0;
|
|
return tabPath;
|
|
},
|
|
navElement: function(tabPath) {
|
|
tabPath = tabPath || activeTabPath;
|
|
return $tabNavigation.filter('[data-' + metadata.tab + '="' + tabPath + '"]');
|
|
},
|
|
tabElement: function(tabPath) {
|
|
var
|
|
$fullPathTab,
|
|
$simplePathTab,
|
|
tabPathArray,
|
|
lastTab
|
|
;
|
|
tabPath = tabPath || activeTabPath;
|
|
tabPathArray = module.utils.pathToArray(tabPath);
|
|
lastTab = module.utils.last(tabPathArray);
|
|
$fullPathTab = $tabs.filter('[data-' + metadata.tab + '="' + lastTab + '"]');
|
|
$simplePathTab = $tabs.filter('[data-' + metadata.tab + '="' + tabPath + '"]');
|
|
return ($fullPathTab.size() > 0)
|
|
? $fullPathTab
|
|
: $simplePathTab
|
|
;
|
|
},
|
|
tab: function() {
|
|
return activeTabPath;
|
|
}
|
|
},
|
|
|
|
utils: {
|
|
filterArray: function(keepArray, removeArray) {
|
|
return $.grep(keepArray, function(keepValue) {
|
|
return ( $.inArray(keepValue, removeArray) == -1);
|
|
});
|
|
},
|
|
last: function(array) {
|
|
return $.isArray(array)
|
|
? array[ array.length - 1]
|
|
: false
|
|
;
|
|
},
|
|
pathToArray: function(pathName) {
|
|
if(pathName === undefined) {
|
|
pathName = activeTabPath;
|
|
}
|
|
return typeof pathName == 'string'
|
|
? pathName.split('/')
|
|
: [pathName]
|
|
;
|
|
},
|
|
arrayToPath: function(pathArray) {
|
|
return $.isArray(pathArray)
|
|
? pathArray.join('/')
|
|
: false
|
|
;
|
|
}
|
|
},
|
|
|
|
/* standard module */
|
|
setting: function(name, value) {
|
|
if(value === undefined) {
|
|
return settings[name];
|
|
}
|
|
settings[name] = value;
|
|
},
|
|
verbose: function() {
|
|
if(settings.verbose) {
|
|
module.debug.apply(this, arguments);
|
|
}
|
|
},
|
|
debug: function() {
|
|
var
|
|
output = [],
|
|
message = settings.moduleName + ': ' + arguments[0],
|
|
variables = [].slice.call( arguments, 1 ),
|
|
log = console.info || console.log || function(){}
|
|
;
|
|
log = Function.prototype.bind.call(log, console);
|
|
if(settings.debug) {
|
|
output.push(message);
|
|
log.apply(console, output.concat(variables) );
|
|
}
|
|
},
|
|
error: function() {
|
|
var
|
|
output = [],
|
|
errorMessage = settings.moduleName + ': ' + arguments[0],
|
|
variables = [].slice.call( arguments, 1 ),
|
|
log = console.warn || console.log || function(){}
|
|
;
|
|
log = Function.prototype.bind.call(log, console);
|
|
if(settings.debug) {
|
|
output.push(errorMessage);
|
|
output.concat(variables);
|
|
log.apply(console, output.concat(variables));
|
|
}
|
|
},
|
|
invoke: function(query, context, passedArguments) {
|
|
var
|
|
maxDepth,
|
|
found
|
|
;
|
|
passedArguments = passedArguments || [].slice.call( arguments, 2 );
|
|
if(typeof query == 'string' && instance !== undefined) {
|
|
query = query.split('.');
|
|
maxDepth = query.length - 1;
|
|
$.each(query, function(depth, value) {
|
|
if( $.isPlainObject( instance[value] ) && (depth != maxDepth) ) {
|
|
instance = instance[value];
|
|
return true;
|
|
}
|
|
else if( instance[value] !== undefined ) {
|
|
found = instance[value];
|
|
return true;
|
|
}
|
|
module.error(settings.errors.method);
|
|
return false;
|
|
});
|
|
}
|
|
if ( $.isFunction( found ) ) {
|
|
return found.apply(context, passedArguments);
|
|
}
|
|
// return retrieved variable or chain
|
|
return found;
|
|
}
|
|
};
|
|
|
|
// check for invoking internal method
|
|
if(methodInvoked) {
|
|
invokedResponse = module.invoke(query, this, passedArguments);
|
|
}
|
|
// otherwise initialize
|
|
else {
|
|
module.initialize();
|
|
}
|
|
|
|
return (invokedResponse !== undefined)
|
|
? invokedResponse
|
|
: this
|
|
;
|
|
|
|
};
|
|
|
|
// shortcut for tabbed content with no defined navigation
|
|
$.tabNavigation = function(settings) {
|
|
$(window).tabNavigation(settings);
|
|
};
|
|
|
|
$.fn.tabNavigation.settings = {
|
|
|
|
moduleName : 'Tab Module',
|
|
verbose : false,
|
|
debug : true,
|
|
namespace : 'tab',
|
|
|
|
// only called first time a tab's content is loaded (when remote source)
|
|
onTabInit : function(tabPath, parameterArray, historyEvent) {},
|
|
// called on every load
|
|
onTabLoad : function(tabPath, parameterArray, historyEvent) {},
|
|
|
|
templates: {
|
|
determineTitle: function(tabArray) {}
|
|
},
|
|
|
|
history : false,
|
|
path : false,
|
|
|
|
context : 'body',
|
|
|
|
// max depth a tab can be nested
|
|
maxDepth : 25,
|
|
// dont load content on first load
|
|
ignoreFirstLoad : true,
|
|
// load tab content new every tab click
|
|
alwaysRefresh : false,
|
|
// cache the content requests to pull locally
|
|
cache : true,
|
|
// settings for api call
|
|
apiSettings : false,
|
|
|
|
errors: {
|
|
api : 'You attempted to load content without API module',
|
|
noContent : 'The tab you specified is missing a content url.',
|
|
method : 'The method you called is not defined',
|
|
state : 'The state library has not been initialized',
|
|
missingTab : 'Missing tab: ',
|
|
recursion : 'Max recursive depth reached'
|
|
},
|
|
|
|
metadata : {
|
|
tab : 'tab',
|
|
loaded : 'loaded',
|
|
promise: 'promise'
|
|
},
|
|
|
|
className : {
|
|
loading : 'loading',
|
|
active : 'active'
|
|
},
|
|
|
|
selector : {
|
|
tabs : '.tab'
|
|
}
|
|
|
|
};
|
|
|
|
})( jQuery, window , document );
|