/********************************************************************** * * XXX add copyright and licence info... * **********************************************************************/ //var DEBUG = DEBUG != null ? DEBUG : true // number of pages to display in ribbon... // NOTE: it is best to keep this odd-ish, so as to give the user the // impession of pages continuing off-screen... var PAGES_IN_RIBBON = 4.0 // if true, expand a page to fit the whole view in single page mode... // NOTE: if .no-resize is set on a page then this will not have effect // on the that page... var FIT_PAGE_TO_VIEW = true // if false, this will force all pages to be fit to screen size in full // page view... // XXX make this default and remove the option... // XXX will produce a bad transition on togglePageView to TN and back // after no-resize sized pages... // ...the most probable reason is that we waste too much time between // setting different values to elements... // need to keep wrights as tight as possible... var USE_REAL_PAGE_SIZES = true //var USE_REAL_PAGE_SIZES = false // default page alignment in full view... // supported values: // - 'center' // - 'left' // - 'right' // NOTE: page local align values take priority over this. // NOTE: this has no effect on thumbnail view. // NOTE: this has no effect if FIT_PAGE_TO_VIEW is true and a page has // no-resize class set. // also, USE_REAL_PAGE_SIZES if set to false will make this have // no effect. var FULL_PAGE_ALIGN = 'center' // if true will make page resizes after window resize animated... var ANIMATE_WINDOW_RESIZE = true // if false will disable page dragging in single page mode... var DRAG_FULL_PAGE = true // if true this will make each page flip update the hash url... // if false, only direct linking will update the url. // NOTE: this can slow down navigation... var UPDATE_HASH_URL_POSITION = false // if true this will enable history for local page navigation regardless // of weather UPDATE_HASH_URL_POSITION state. // NOTE: UPDATE_HASH_URL_POSITION implicitly enables full browser history // based navigation. // NOTE: this, if enabled, can slow down navigation... // NOTE: partial history navigation over links will still work. var FULL_HISTORY_ENABLED = false /*********************************************************** modes ***/ // toggles .dragging CSS class on the viewer while dragging is in // progress. // NOTE: this is used mostly for styling and drag assisting... var togglePageDragging = createCSSClassToggler('.viewer', 'dragging') // toggles the editor mode, used for inline magazine editor... var toggleEditorMode = createCSSClassToggler('.viewer', 'editor-mode noSwipe') // this is here only for speed, helps with dragging... // DO NOT USE DIRECTLY! var _PAGE_VIEW // toggle between the two main modes: // - single page mode (.page-view-mode) // - thumbnail/ribbon mode var togglePageView = createCSSClassToggler( '.viewer', 'page-view-mode', null, // post-change callback... function(action){ if(action == 'on'){ fitNPages(1, !FIT_PAGE_TO_VIEW) _PAGE_VIEW = true } else { fitNPages(PAGES_IN_RIBBON) _PAGE_VIEW = false } }) // this will simply update the current view... function updateView(){ return togglePageView(togglePageView('?')) } /********************************************************* helpers ***/ function isPageResizable(page){ if(page == null){ page = $('.current.page') } if(!USE_REAL_PAGE_SIZES){ return false } var mag = $('.magazine') var set = page.parents('.page-set').first() var article = page.parents('.article').first() // first check the page... return (page.hasClass('no-resize') ? false // then the page-set... : set.hasClass('no-resize') ? false // then the article... : article.hasClass('no-resize') ? false // then the magazine... : mag.hasClass('no-resize') ? false // now for default... : true) } // this will get the current active alignment... // NOTE: align can be set for: // - page // - article // - magazine // - app (via. FULL_PAGE_ALIGN) // NOTE: the more local setting takes priority over the more general. function getPageAlign(page){ if(page == null){ page = $('.current.page') } var mag = $('.magazine') var set = page.parents('.page-set').first() var article = page.parents('.article').first() // first check the page... return (page.hasClass('page-align-center') ? 'center' : page.hasClass('page-align-left') ? 'left' : page.hasClass('page-align-right') ? 'right' // then the page-set... : set.hasClass('page-align-center') ? 'center' : set.hasClass('page-align-left') ? 'left' : set.hasClass('page-align-right') ? 'right' // then the article... : article.hasClass('page-align-center') ? 'center' : article.hasClass('page-align-left') ? 'left' : article.hasClass('page-align-right') ? 'right' // then the magazine... : mag.hasClass('page-align-center') ? 'center' : mag.hasClass('page-align-left') ? 'left' : mag.hasClass('page-align-right') ? 'right' // now for the app default... : FULL_PAGE_ALIGN) } // NOTE: this will only produce a title if a magazine is loaded and it // has a title, otherwise undefined is returned.... function getMagazineTitle(){ return ($('.magazine').attr('title') || $('.magazine').attr('name')) } function getPageScale(){ return getElementScale($('.scaler')) } // NOTE: if page is not given get the current page number... function getPageNumber(page){ if(page == null){ page = $('.current.page') } return $('.page').index(page) } // NOTE: negative values will yield results from the tail... function getPageAt(n){ var page = $('.page') if(n < 0){ n = page.length + n } return $(page[n]) } /************************************************** event handlers ***/ // #URL handler... var RELATIVE_URLS = [ 'back', 'forward', 'next', 'prev', 'nextArticle', 'prevArticle', 'nextBookmark', 'prevBookmark', 'bookmark', 'hideLayers' ] // NOTE: most of the handling actually happens in loadURLState... function hashChangeHandler(e){ e.preventDefault() var anchor = window.location.hash.split('#')[1] // skip empty #URL... if(anchor == ''){ return false } var r = loadURLState() var n = getPageNumber() // for relative #URLs remove them from hash... if(RELATIVE_URLS.indexOf(anchor) >= 0 && !UPDATE_HASH_URL_POSITION){ window.location.hash = '' } // if we are dealing with history actions the browser will // do the work for us... if(r == 'back'){ // we shift by 2 to compensate for the back/forward URL itself... window.history.go(-2) } else if(r == 'forward'){ window.history.go(2) } else if(r != n){ /* XXX this will put this into an endless loop... * ...mainly because it changes the #URL from within the handler if(!UPDATE_HASH_URL_POSITION){ // push current position... // NOTE: this will enable partial history navigation, but only // on actions envolving actual links... window.history.pushState(null, null, '#' + getPageNumber()) } */ setCurrentPage(r) } } // window resize event handler... function viewResizeHandler(){ if(ANIMATE_WINDOW_RESIZE){ updateView() } else { unanimated($('.scaler'), updateView, 30)() } } // swipe state handler // this handles single and double finger swipes and dragging // while draggign this triggers magazineDragging event on the viewer... // NOTE: this will trigger 'magazineDragging' event on the viewer on // each call while dragging... // XXX for some reason with finger count of 3 and greater, touchSwipe // dies on android... function swipeHandler(evt, phase, direction, distance, duration, fingers){ var pages = $('.page') var cur = $('.current.page') var n = pages.index(cur) var scale = getPageScale() var mag = $('.magazine') var pos = $('.navigator .bar .indicator') // XXX make this drag pages that are larger than view before dragging outside... if(phase=='move' // see if wee need to drag the page and allways drag the ribbon... && (DRAG_FULL_PAGE || !_PAGE_VIEW) && (direction=='left' || direction=='right')){ if(direction == 'left'){ mag.css({left: -cur.position()['left']/scale - distance/scale}) } else if(direction == 'right') { mag.css({left: -cur.position()['left']/scale + distance/scale}) } $('.viewer').trigger('magazineDragging') } else if(phase == 'start'){ // NOTE: this is used with the "unanimated" trick, we will make // dragging real-time... togglePageDragging('on') } else if(phase == 'cancel'){ togglePageDragging('off') setCurrentPage() } else if(phase =='end' ){ togglePageDragging('off') // see which page is closer to the middle of the screen and set it... // do this based on how much we dragged... var p = Math.ceil((distance/scale)/cur.width()) // prev page... if(direction == 'right'){ // 2 fingers moves to closest article... if(fingers == 2){ prevArticle() // 3+ fingers moves to bookmark... } else if(fingers >= 3){ prevBookmark() } else { setCurrentPage(Math.max(n-p, 0)) } // next page... } else if(direction == 'left'){ if(fingers == 2){ nextArticle() } else if(fingers >= 3){ nextBookmark() } else { setCurrentPage(Math.min(n+p, pages.length-1)) } } } } /********************************************************** layout ***/ // NOTE: if n is not given then it defaults to 1 // NOTE: if n > 1 and fit_to_content is not given it defaults to true // NOTE: if n is 1 then fit_to_content bool argument controls wether: // - the page will be stretched to viewer (false) // - or to content (true) function fitNPages(n, fit_to_content){ if(n == null){ n = 1 } if(n > 1 && fit_to_content == null){ fit_to_content = true } var view = $('.viewer') if(USE_REAL_PAGE_SIZES){ var page = $('.page:not(.no-resize)') } else { var page = $('.page') } var content = $('.content') var cur = $('.current.page') var W = view.width() var H = view.height() var cW = content.width() var cH = content.height() var rW = cW var scale = getPageScale() // to compensate for transitions, no data sampling should be beyound // this point, as we will start changing things next... if(fit_to_content){ if(USE_REAL_PAGE_SIZES){ page.width('auto') page.height('auto') } else { page.width(cW) page.height(cH) } if(W/H > (cW*n)/cH){ scale = H/cH } else { scale = W/(cW*n) } // resulting page width... var rW = cW } else { // need to calc width only... if(W/H > (cW*n)/cH){ scale = H/cH page.width(W/scale) page.height(cH) // need to calc height only... } else if(W/H > (cW*n)/cH){ scale = W/(cW*n) page.height(H/scale) page.width(cW) // set both width and height to defaults (content and page ratios match)... } else { scale = W/(cW*n) page.height(cH) page.width(cW) } // resulting page width... var rW = W/scale } if(USE_REAL_PAGE_SIZES){ $('.page.no-resize').width('auto') } // NOTE: we need to calculate the offset as the actual widths during // the animation are not correct... so just looking at .position() // will be counterproductive... if(!USE_REAL_PAGE_SIZES && fit_to_content){ var offset = rW * getPageNumber()-1 } else { // calculate the target offset... if(USE_REAL_PAGE_SIZES){ var rpages = $('.page:not(.no-resize), .current.page') } else { var rpages = page } var i = rpages.index(cur) var offset = rW * i-1 // now do the no-resize elements... if(USE_REAL_PAGE_SIZES){ var nrpages = $('.page.no-resize, .current.page') i = nrpages.index(cur) nrpages.splice(i) nrpages.each(function(_, e){ offset += $(e).children('.content').width() }) } } if(USE_REAL_PAGE_SIZES){ if(cur.hasClass('no-resize')){ var align = getPageAlign(cur) // center align if explicitly required or if we are in a ribbon... if(n > 1 || align == 'center'){ rW = cur.children('.content').width() // align left... } else if(align == 'left'){ rW = $('.viewer').width()/scale // align right... } else if(align == 'right'){ var v = $('.viewer') rW = (v.width()/scale/2 - (v.width()/scale-cur.width()))*2 } } } // do the scaling... setElementScale($('.scaler'), scale) // fix position... setCurrentPage(null, offset, rW) } /********************************************************* actions ***/ // NOTE: "width" is used ONLY to center the page. // NOTE: if n is not given it will be set to current page number // NOTE: if width is not given it will be set to current page width. // NOTE: n can be: // - page number // - page element // NOTE: this will fire a 'pageChanged(n)' event on the viewer each time // it is called... // NOTE: this now supports negative indexes to count pages from the end... function setCurrentPage(n, offset, width){ var page = $('.page') // setup n and cur... // no n is given, do the defaultdance if(n == null){ var cur = $('.current.page') // no current page... // try to land on the magazine cover... if(cur.length == 0){ cur = $('.magazine > .cover') } // try the first cover... if(cur.length == 0){ cur = $('.cover.page') } // try first page... if(cur.length == 0){ cur = page.first() } // no pages to work with... if(cur.length == 0){ return } n = page.index(cur) // n is a number... } else if(typeof(n) == typeof(1)) { // normalize n... if(n >= page.length){ n = page.length-1 } else if(-n > page.length){ n = 0 } var cur = getPageAt(n) // n is an element, likely... } else { var cur = $(n) n = $('.page').index(cur) //n = page.index(cur) } // default width... if(width == null){ width = cur.width() if(USE_REAL_PAGE_SIZES && togglePageView('?') == 'on'){ var align = getPageAlign(cur) var scale = getPageScale() if(align == 'center'){ width = cur.width() } else if(align == 'left'){ width = $('.viewer').width()/scale } else if(align == 'right'){ var v = $('.viewer') width = (v.width()/scale/2 - (v.width()/scale-cur.width()))*2 } } } $('.current.page').removeClass('current') cur.addClass('current') var mag = $('.magazine') mag.css({ // NOTE: this will be wrong during a transition, that's why we // can pass the pre-calculated offset as an argument... left: -(offset == null ? cur.position()['left']/getPageScale() : offset) }) // center the pages correctly... // NOTE: this is the main reason we need width, and we can get it // pre-calculated because of ongoing transitions make it // pointless to read it... $('.magazine').css({ 'margin-left': -width/2 }) $('.viewer').trigger('pageChanged', n) return cur } function goToMagazineCover(){ return setCurrentPage(0) } function goToMagazineEnd(){ return setCurrentPage(-1) } function goToArticleCover(){ // try and get the actual first cover... var cover = $('.current.page').parents('.article').find('.cover.page').first() if(cover.length == 0){ // no cover, get the first page... return setCurrentPage($('.current.page').parents('.article').find('.page').first()) } else { return setCurrentPage(cover) } } function nextPage(){ var pages = $('.page') var cur = $('.current.page') return setCurrentPage(Math.min(pages.index(cur)+1, pages.length-1)) } function prevPage(){ var pages = $('.page') var cur = $('.current.page') return setCurrentPage(Math.max(pages.index(cur)-1, 0)) } function nextArticle(){ var cur = $('.current.page').parents('.article') // we are at the magazine cover... if(cur.length == 0){ return setCurrentPage( $('.magazine .article .page:first-child').first()) } // just find the next one... var articles = $('.magazine .article') return setCurrentPage( $(articles[Math.min(articles.index(cur)+1, articles.length-1)]) .find('.page') .first()) } function prevArticle(){ var cur = $('.current.page').parents('.article') // we are at the magazine cover... if(cur.length == 0){ //return $('.current.page') return setCurrentPage() } // just find the prev one... var articles = $('.magazine .article') return setCurrentPage( $(articles[Math.max(articles.index(cur)-1, 0)]) .find('.page') .first()) } /******************************************************* bookmarks ***/ // setup bookmarking active zones in page... function setupBookmarkTouchZones(){ $('.bookmark-toggler').remove() var page = $('.page') page.each(function(i, e){ $('
') .prependTo($(e)) .addClass('bookmark-toggler') .attr({ title: 'Toggle bookmark (B)' }) .swipe({ click: function(){ toggleBookmark($(e)) } }) }) } // load bookmarks from list... function loadBookmarks(lst){ clearBookmarks() // setup/set bookmarks... $(lst).each(function(i, e){toggleBookmark(e)}) } // build bookmark list... function buildBookmarkList(){ var res = [] $('.magazine .page .bookmark').each(function(_, e){ res.push(getPageNumber($(e).parents('.page'))) }) return res } // NOTE: will trigger 'bookmarksCleared' event on the viewer function clearBookmarks(){ $('.magazine .page .bookmark').remove() $('.viewer').trigger('bookmarksCleared') } // NOTE: this will trigger events on the viewer: // - bookmarkAdded(n) // - bookmarkRemoved(n) function toggleBookmark(n){ if(n == null){ n = getPageNumber() } else if(typeof(n) != typeof(1)){ n = getPageNumber(n) } var res var cur = getPageAt(n) if(cur.children('.bookmark').length == 0){ var res = $('') .prependTo(cur) .addClass('bookmark justcreated') .attr({ title: 'Toggle bookmark (B)' }) $('.viewer').trigger('bookmarkAdded', n) setTimeout(function(){ res.removeClass('justcreated') }, 1000) } else { cur.children('.bookmark').remove() $('.viewer').trigger('bookmarkRemoved', n) } return res } function nextBookmark(){ var pages = $('.page') pages = $(pages.splice(getPageNumber()+1)) page = pages.children('.bookmark').first().parents('.page') if(page.length != 0){ return setCurrentPage(page) } } function prevBookmark(){ var pages = $('.page') pages.splice(getPageNumber()) page = pages.children('.bookmark').last().parents('.page') if(page.length != 0){ return setCurrentPage(page) } } /*********************************************************** state **** * * Local state consists of: * - current page * - bookmarks * * Two types of store are used for local state: * - #URL * stores current page number * is used for special URLs like #home, #next, etc. * - localStorage * stores current page (overriden by #URL if both are present) * stores bookmarks * * NOTE: localStorage is magazine specific. * * **********************************************************************/ // XXX make URLs magazine-specific... // ...for extrnal linking we'll need the magazine ID, or make each // magazine a seporate path... // the #URL should be of the form: // #