jinda_engine 0.6.0

data/lib/generators/jinda_engine/templates/app/assets/javascripts/jquery.mobile.splitview.js

@@ -0,0 +1,695 @@
+// TODO: fix all the position: absolute issues caused by getScreenHeight and newResetActivePageHeight. these two need fixin.
+// TODO: need to check for tablets performance - using overflow: auto instead of position:fixed. these will probably need fixin as well.
+
+// TODO: reinstate replaceBackBtn - to include the case where people actually really want the back btn
+(function($,window,undefined){
+  $( window.document ).bind('mobileinit', function(){
+    $.mobile = $.extend( {}, {
+      menuWidth: '25%',
+      menuMinWidth: '250px',
+      menuBtnSide: 'left',
+    }, $.mobile );
+
+    //some class for css to detect touchscreens
+    if($.support.touch){
+      $('html').addClass('touch');
+    }
+    var $query = $.mobile.media('screen and (min-width: 480px)') && ($.mobile.media('(-webkit-max-device-pixel-ratio: 3.0)') || $.mobile.media('(max--moz-device-pixel-ratio: 3.0)'));
+    $.support.splitview = ($query || ($.mobile.browser.ie && $(this).width() >= 480)) && $.mobile.ajaxEnabled;
+    if ($.support.splitview) {
+      $('html').addClass('splitview');
+      //on window.ready() execution:
+      $(function() {
+        // TODO: cleanup if all is ok
+        // $.mobile.linkBindingEnabled = false;
+        // $(document).unbind('.toolbar');
+        // $('.ui-page').off('.toolbar');
+        $('div:jqmData(role="panel")').addClass('ui-mobile-viewport ui-panel');
+        var firstPageMain=$('div:jqmData(id="main") > div:jqmData(role="page"):first');
+        if( !$.mobile.hashListeningEnabled || !$.mobile.path.stripHash( location.hash ) ){
+          var $container=$('div:jqmData(id="main")');
+          $.mobile.firstPage = firstPageMain;
+          $.mobile.pageContainer = $container;
+          $(window).trigger('pagecontainercreate');
+          $.mobile.changePage(firstPageMain, {transition:'none', changeHash:false, pageContainer:$container});
+          $.mobile.activePage=undefined;
+        } //no need to trigger a hashchange here cause the other page is handled by core.
+
+        // setup the layout for splitview and jquerymobile will handle first page init
+        $(window).trigger('orientationchange');
+        setTimeout(function(){
+          $.mobile.firstPage = firstPageMain;
+        }, 100)
+      }); //end window.ready()
+
+//----------------------------------------------------------------------------------
+//Main event bindings: click, form submits, hashchange and orientationchange/resize(popover)
+//----------------------------------------------------------------------------------
+      //existing base tag?
+      var $window = $( window ),
+          $html = $( 'html' ),
+          $head = $( 'head' ),
+          $base = $head.children( "base" ),
+          $activeClickedLink = null,
+          //tuck away the original document URL minus any fragment.
+          documentUrl = $.mobile.path.parseUrl( location.href ),
+
+          //if the document has an embedded base tag, documentBase is set to its
+          //initial value. If a base tag does not exist, then we default to the documentUrl.
+          documentBase = $base.length ? $.mobile.path.parseUrl( $.mobile.path.makeUrlAbsolute( $base.attr( "href" ), documentUrl.href ) ) : documentUrl,
+          getScreenHeight = $.mobile.getScreenHeight;
+
+      //remove active classes after page transition or error
+      function removeActiveLinkClass( forceRemoval ) {
+        if ( !!$activeClickedLink && ( !$activeClickedLink.closest( "." + $.mobile.activePageClass ).length || forceRemoval ) ) {
+          $activeClickedLink.removeClass( $.mobile.activeBtnClass );
+        }
+        $activeClickedLink = null;
+      }
+
+      function findClosestLink(ele)
+      {
+        while (ele){
+          if ( ( typeof ele.nodeName === "string") && ele.nodeName.toLowerCase() == "a"){
+            break;
+          }
+          ele = ele.parentNode;
+        }
+        return ele;
+      }
+
+      // The base URL for any given element depends on the page it resides in.
+      function getClosestBaseUrl( ele )
+      {
+        // Find the closest page and extract out its url.
+        var url = $( ele ).closest( ".ui-page" ).jqmData( "url" ),
+          base = documentBase.hrefNoHash;
+
+        if ( !url || !$.mobile.path.isPath( url ) ) {
+          url = base;
+        }
+
+        return $.mobile.path.makeUrlAbsolute( url, base);
+      }
+
+      function ResetActivePageHeight(container){
+        var aPage;
+            // aPagePadT = parseFloat( aPage.css( "padding-top" ) ),
+            // aPagePadB = parseFloat( aPage.css( "padding-bottom" ) ),
+            // aPageBorderT = parseFloat( aPage.css( "border-top-width" ) ),
+            // aPageBorderB = parseFloat( aPage.css( "border-bottom-width" ) );
+
+        if(container !== null && typeof container !== 'undefined') {
+          aPage = container.find("." + $.mobile.activePageClass);
+        } else {
+          aPage = $( "." + $.mobile.activePageClass );
+        }
+
+        aPage.each(function(i, page){
+          page = $(page)
+          var pagePadT = parseFloat( page.css( "padding-top" )),
+              pagePadB = parseFloat( page.css( "padding-bottom" )),
+              pageBorderT = parseFloat( page.css( "border-top-width" )),
+              pageBorderB = parseFloat( page.css( "border-bottom-width" ));
+          page.css( "min-height", getScreenHeight() - pagePadT - pagePadB - pageBorderT - pageBorderB );
+        })
+      }
+
+      //override _registerInternalEvents to bind to new methods below
+      $.mobile._registerInternalEvents = function(){
+        //DONE: bind form submit with this plugin
+        $( document ).delegate("form", "submit", function(event){
+          var $this = $( this );
+
+          if( !$.mobile.ajaxEnabled ||
+              $this.is( ":jqmData(ajax='false')" ) ||
+              !$this.jqmHijackable().length ){
+            return;
+          }
+
+          var type = $this.attr("method"),
+              target = $this.attr("target"),
+              url = $this.attr( "action" );
+
+          // If the form has a data-panel attribute, load the page in that panel instead.
+          var $targetPanel = null;
+          var $targetPanelId = $this.jqmData("panel");
+          if ($targetPanelId === undefined) {
+              $targetPanel = $this.parents('div:jqmData(role="panel")');
+          } else {
+              $targetPanel = $('div:jqmData(id="' + $targetPanelId + '")');
+          }
+          var $targetPanelActivePage=$targetPanel.children('div.'+$.mobile.activePageClass);
+
+          // If no action is specified, browsers default to using the
+          // URL of the document containing the form. Since we dynamically
+          // pull in pages from external documents, the form should submit
+          // to the URL for the source document of the page containing
+          // the form.
+          if ( !url ) {
+            // Get the @data-url for the page containing the form.
+            url = getClosestBaseUrl( $this );
+            if ( url === documentBase.hrefNoHash ) {
+              // The url we got back matches the document base,
+              // which means the page must be an internal/embedded page,
+              // so default to using the actual document url as a browser
+              // would.
+              url = documentUrl.hrefNoSearch;
+            }
+          }
+
+          url = $.mobile.path.makeUrlAbsolute(  url, getClosestBaseUrl($this) );
+
+          //external submits use regular HTTP
+          if( ( $.mobile.path.isExternal( url ) && !path.isPermittedCrossDomainRequest( documentUrl, url ) ) || target ) {
+            return;
+          }
+
+          //temporarily put this here- eventually shud just set it immediately instead of an interim var.
+          $.mobile.activePage=$targetPanelActivePage;
+          // $.mobile.pageContainer=$targetPanel;
+          $.mobile.changePage(
+              url,
+              {
+                type:       type && type.length && type.toLowerCase() || "get",
+                data:       $this.serialize(),
+                transition: $this.jqmData("transition"),
+                reverse:  $this.jqmData("direction") === "reverse",
+                reloadPage: true,
+                pageContainer:$targetPanel
+              }
+          );
+          event.preventDefault();
+        });
+
+        //add active state on vclick
+
+        $( document ).bind( "vclick", function( event ) {
+          if ( event.which > 1 || !$.mobile.linkBindingEnabled ) {
+            return;
+          }
+
+          var link = findClosestLink( event.target );
+
+          if ( !$( link ).jqmHijackable().length ) {
+            return;
+          }
+
+          if ( link ) {
+            if ( $.mobile.path.parseUrl( link.getAttribute( "href" ) || "#" ).hash !== "#" ) {
+              removeActiveLinkClass( true );
+              $activeClickedLink = $( link ).closest( ".ui-btn" ).not( ".ui-disabled" )
+              $activeClickedLink.addClass( $.mobile.activeBtnClass );
+              // $( "." + $.mobile.activePageClass + " .ui-btn" ).not( link ).blur();
+            }
+          }
+        });
+
+        //DONE: link click event binding for changePage
+        //click routing - direct to HTTP or Ajax, accordingly
+        $(document).bind( "click", function(event) {
+          if ( !$.mobile.linkBindingEnabled ) {
+            return;
+          }
+
+          var link = findClosestLink(event.target),
+              $link = $( link ),
+              httpCleanup;
+
+          if (!link || event.which > 1 || !$link.jqmHijackable().length ){
+            return;
+          }
+
+          httpCleanup = function() {
+            window.setTimeout(function() { removeActiveLinkClass( true ); })
+          }
+
+          //if there's a data-rel=back attr, go back in history
+          if( $link.is( ":jqmData(rel='back')" ) ) {
+            $.mobile.back();
+            return false;
+          }
+
+          var baseUrl = getClosestBaseUrl( $link ),
+
+              //get href, if defined, otherwise fall to null #
+              href = $.mobile.path.makeUrlAbsolute( $link.attr( "href" ) || "#", baseUrl );
+
+
+
+          //if ajax is disabled, exit early
+          if( !$.mobile.ajaxEnabled && !$.mobile.path.isEmbeddedPage( href ) ) {
+            httpCleanup();
+            //use default click handling
+            return;
+          }
+
+          // XXX_jblas: Ideally links to application pages should be specified as
+          //            an url to the application document with a hash that is either
+          //            the site relative path or id to the page. But some of the
+          //            internal code that dynamically generates sub-pages for nested
+          //            lists and select dialogs, just write a hash in the link they
+          //            create. This means the actual URL path is based on whatever
+          //            the current value of the base tag is at the time this code
+          //            is called. For now we are just assuming that any url with a
+          //            hash in it is an application page reference.
+          if ( href.search( "#" ) !== -1 ) {
+            href = href.replace( /[^#]*#/, "" );
+            if ( !href ) {
+              //link was an empty hash meant purely
+              //for interaction, so we ignore it.
+              event.preventDefault();
+              return;
+            } else if ( $.mobile.path.isPath( href ) ) {
+              //we have apath so make it the href we want to load.
+              href = $.mobile.path.makeUrlAbsolute( href, baseUrl );
+            } else {
+              //we have a simple id so use the documentUrl as its base.
+              href = $.mobile.path.makeUrlAbsolute( "#" + href, documentUrl.hrefNoHash );
+            }
+          }
+
+          // Should we handle this link, or let the browser deal with it?
+          var useDefaultUrlHandling = $link.is( "[rel='external']" ) || $link.is( ":jqmData(ajax='false')" ) || $link.is( "[target]" ),
+              // Some embedded browsers, like the web view in Phone Gap, allow cross-domain XHR
+              // requests if the document doing the request was loaded via the file:// protocol.
+              // This is usually to allow the application to "phone home" and fetch app specific
+              // data. We normally let the browser handle external/cross-domain urls, but if the
+              // allowCrossDomainPages option is true, we will allow cross-domain http/https
+              // requests to go through our page loading logic.
+              //isCrossDomainPageLoad = ( $.mobile.allowCrossDomainPages && documentUrl.protocol === "file:" && href.search( /^https?:/ ) != -1 ),
+
+              //check for protocol or rel and its not an embedded page
+              //TODO overlap in logic from isExternal, rel=external check should be
+              //     moved into more comprehensive isExternalLink
+              isExternal = useDefaultUrlHandling || ( $.mobile.path.isExternal( href ) && !$.mobile.path.isPermittedCrossDomainRequest( documentUrl, href ) ),
+
+              isRefresh=$link.jqmData('refresh'),
+              $targetPanel=$link.jqmData('panel'),
+              $targetContainer=$('div:jqmData(id="'+$targetPanel+'")'),
+              $targetPanelActivePage=$targetContainer.children('div.'+$.mobile.activePageClass),
+              $currPanel=$link.parents('div:jqmData(role="panel")'),
+              //not sure we need this. if you want the container of the element that triggered this event, $currPanel
+              $currContainer=$.mobile.pageContainer,
+              $currPanelActivePage=$currPanel.children('div.'+$.mobile.activePageClass),
+              url=$.mobile.path.stripHash($link.attr("href")),
+              from = null;
+
+          //still need this hack apparently:
+          $('.ui-btn.'+$.mobile.activeBtnClass).removeClass($.mobile.activeBtnClass);
+          $activeClickedLink = $link.closest( ".ui-btn" ).addClass($.mobile.activeBtnClass);
+
+          if( isExternal ) {
+            httpCleanup();
+            //use default click handling
+            return;
+          }
+
+          //use ajax
+          var transitionVal = $link.jqmData( "transition" ),
+              reverseVal = $link.jqmData("direction") === "reverse" ||
+                        // deprecated - remove by 1.0
+                        $link.jqmData( "back" ),
+              //this may need to be more specific as we use data-rel more
+              role = $link.attr( "data-" + $.mobile.ns + "rel" ) || undefined,
+              hash = $currPanel.jqmData('hash');
+
+          //if link refers to an already active panel, stop default action and return
+          if ($targetPanelActivePage.attr('data-url') == url || $currPanelActivePage.attr('data-url') == url) {
+            if (isRefresh) { //then changePage below because it's a pageRefresh request
+              $.mobile.changePage(href, {fromPage:from, transition:'fade', reverse:reverseVal, changeHash:false, pageContainer:$targetContainer, reloadPage:isRefresh, role:role, link:$link});
+            }
+            else { //else preventDefault and return
+              event.preventDefault();
+              return;
+            }
+          }
+          //if link refers to a page on another panel, changePage on that panel
+          else if ($targetPanel && $targetPanel!=$link.parents('div:jqmData(role="panel")')) {
+            var from=$targetPanelActivePage;
+            $.mobile.pageContainer=$targetContainer;
+            $.mobile.changePage(href, {fromPage:from, transition:transitionVal, reverse:reverseVal, pageContainer:$targetContainer, role:role, link:$link});
+          }
+          //if link refers to a page inside the same panel, changePage on that panel
+          else {
+            var from=$currPanelActivePage;
+            $.mobile.pageContainer=$currPanel;
+            var hashChange= (hash == 'false' || hash == 'crumbs')? false : true;
+            $.mobile.changePage(href, {fromPage:from, transition:transitionVal, reverse:reverseVal, changeHash:hashChange, pageContainer:$currPanel, role: role, link: $link});
+            //active page must always point to the active page in main - for history purposes.
+            $.mobile.activePage=$('div:jqmData(id="main") > div.'+$.mobile.activePageClass);
+          }
+          event.preventDefault();
+          event.stopPropagation();
+        });
+
+        //prefetch pages when anchors with data-prefetch are encountered
+        //TODO: insert pageContainer in here!
+        $( document ).delegate( ".ui-page", "pageshow.prefetch", function(){
+          var urls = [],
+              $thisPageContainer = $(this).parents('div:jqmData(role="panel")');
+          $( this ).find( "a:jqmData(prefetch)" ).each(function(){
+            var url = $( this ).attr( "href" ),
+                panel = $(this).jqmData('panel'),
+                container = panel.length? $('div:jqmData(id="'+panel+'")') : $thisPageContainer;
+            if ( url && $.inArray( url, urls ) === -1 ) {
+              urls.push( url );
+              $.mobile.loadPage( url, {pageContainer: container} );
+            }
+          });
+        });
+
+        //DONE: bind hashchange with this plugin
+        //hashchanges are defined only for the main panel - other panels should not support hashchanges to avoid ambiguity
+        $.mobile._handleHashChange = function( hash ) {
+          var to = $.mobile.path.stripHash( hash ),
+              transition = $.mobile.urlHistory.stack.length === 0 ? "none" : undefined,
+              navEvent = new $.Event( "navigate" ),
+              $mainPanel=$('div:jqmData(id="main")'),
+              $mainPanelFirstPage=$mainPanel.children('div:jqmData(role="page"):first'),
+              $mainPanelActivePage=$mainPanel.children('div.ui-page-active'),
+              $menuPanel=$('div:jqmData(id="menu")'),
+              $menuPanelFirstPage=$menuPanel.children('div:jqmData(role="page"):first'),
+              $menuPanelActivePage=$menuPanel.children('div.ui-page-active'),
+              //FIX: temp var for dialogHashKey
+              dialogHashKey = "&ui-state=dialog",
+
+              // default options for the changPage calls made after examining the current state
+              // of the page and the hash
+              changePageOptions = {
+                transition: transition,
+                changeHash: false,
+                fromHashChange: true,
+                pageContainer: $mainPanel
+              };
+
+          if ( 0 === $.mobile.urlHistory.stack.length ) {
+            $.mobile.urlHistory.initialDst = to;
+          }
+
+          // We should probably fire the "navigate" event from those places that make calls to _handleHashChange,
+          // and have _handleHashChange hook into the "navigate" event instead of triggering it here
+          $.mobile.pageContainer.trigger( navEvent );
+          if ( navEvent.isDefaultPrevented() ) {
+            return;
+          }
+
+          if( !$.mobile.hashListeningEnabled || $.mobile.urlHistory.ignoreNextHashChange ){
+            $.mobile.urlHistory.ignoreNextHashChange = false;
+            return;
+          }
+
+          // special case for dialogs
+          if( $.mobile.urlHistory.stack.length > 1 && to.indexOf( dialogHashKey ) > -1 && $.mobile.urlHistory.initialDst !== to ) {
+
+            // If current active page is not a dialog skip the dialog and continue
+            // in the same direction
+            if(!$.mobile.activePage.is( ".ui-dialog" )) {
+              //determine if we're heading forward or backward and continue accordingly past
+              //the current dialog
+              $.mobile.urlHistory.directHashChange({
+                currentUrl: to,
+                isBack: function() { window.history.back(); },
+                isForward: function() { window.history.forward(); }
+              });
+
+              // prevent changepage
+              return;
+            } else {
+              // var setTo = function() { to = $.mobile.urlHistory.getActive().pageUrl; };
+              // if the current active page is a dialog and we're navigating
+              // to a dialog use the dialog objected saved in the stack
+              // urlHistory.directHashChange({ currentUrl: to, isBack: setTo, isForward: setTo });
+              urlHistory.directHashChange({
+                currentUrl: to,
+
+                // regardless of the direction of the history change
+                // do the following
+                either: function( isBack ) {
+                  var active = $.mobile.urlHistory.getActive();
+
+                  to = active.pageUrl;
+
+                  // make sure to set the role, transition and reversal
+                  // as most of this is lost by the domCache cleaning
+                  $.extend( changePageOptions, {
+                    role: active.role,
+                    transition:  active.transition,
+                    reverse: isBack
+                  });
+                }
+              });
+            }
+          }
+
+          //if to is defined, load it
+          if ( to ){
+            to = ( typeof to === "string" && !$.mobile.path.isPath( to ) ) ? ( $.mobile.path.makeUrlAbsolute( '#' + to, documentBase ) ) : to;
+            //if this is initial deep-linked page setup, then changePage sidemenu as well
+            if (!$('div.ui-page-active').length) {
+              $menuPanelFirstPage='#'+$menuPanelFirstPage.attr('id');
+              $.mobile.changePage($menuPanelFirstPage, {transition:'none', reverse:true, changeHash:false, fromHashChange:false, pageContainer:$menuPanel});
+              $.mobile.activePage=undefined;
+            }
+            $.mobile.activePage=$mainPanelActivePage.length? $mainPanelActivePage : undefined;
+            $.mobile.changePage(to, changePageOptions );
+          } else {
+          //there's no hash, go to the first page in the main panel.
+            $.mobile.activePage=$mainPanelActivePage? $mainPanelActivePage : undefined;
+            $.mobile.changePage( $mainPanelFirstPage, changePageOptions );
+          }
+        };
+
+        //hashchange event handler
+        $(window).bind( "hashchange", function( e, triggered ) {
+          $.mobile._handleHashChange( location.hash );
+        });
+
+        //set page min-heights to be device specific
+        $( document ).bind( "pageshow.resetPageHeight", function(e){
+          var container = $(e.target).parents('div:jqmData(role="panel")');
+          ResetActivePageHeight(container);
+        });
+        $( window ).bind( "throttledresize.resetPageHeight", ResetActivePageHeight() );
+
+      }; //end _registerInternalEvents
+
+      //DONE: bind orientationchange and resize - the popover
+      _orientationHandler = function(event){
+        var $menu=$('div:jqmData(id="menu")'),
+            $main=$('div:jqmData(id="main")'),
+            $mainHeader=$main.find('div.'+$.mobile.activePageClass+'> div:jqmData(role="header")'),
+            $window=$(window);
+
+        function popoverBtn(header) {
+          if(!header.children('.popover-btn').length){
+            if(header.children('a.ui-btn-'+$.mobile.menuBtnSide).length){
+              header.children('a.ui-btn-'+$.mobile.menuBtnSide).replaceWith('<a class="popover-btn">Menu</a>');
+              header.children('a.popover-btn').addClass('ui-btn-'+$.mobile.menuBtnSide).buttonMarkup();
+            }
+            else{
+              header.prepend('<a class="popover-btn">Menu</a>');
+              header.children('a.popover-btn').addClass('ui-btn-'+$.mobile.menuBtnSide).buttonMarkup()
+            }
+          }
+        }
+
+        function replaceBackBtn(header) {
+          if($.mobile.urlHistory.stack.length > 1 && !header.children('a:jqmData(rel="back")').length && header.jqmData('backbtn')!=false){
+            header.prepend("<a href='#' class='ui-btn-left' data-"+ $.mobile.ns +"rel='back' data-"+ $.mobile.ns +"icon='arrow-l'>Back</a>" );
+            header.children('a:jqmData(rel="back")').buttonMarkup();
+          }
+        };
+
+        function popover(){
+          $menu.addClass('panel-popover')
+               .removeClass('ui-panel-left')
+               .css({'width':$.mobile.menuWidth, 'min-width':$.mobile.menuMinWidth, 'display':'', 'overflow-x':'visible'})
+               .css($.mobile.menuBtnSide, '10px');
+          if(!$menu.children('.popover_triangle').length){
+            $menu.prepend('<div class="popover_triangle" style="'+$.mobile.menuBtnSide+':7px"></div>');
+          }
+          $menu.children('div:jqmData(role="page")').css('min-height', '100%');
+          $main.removeClass('ui-panel-right')
+               .css('width', '');
+          popoverBtn($mainHeader);
+
+          $main.undelegate('div:jqmData(role="page")', 'pagebeforeshow.splitview');
+          $main.delegate('div:jqmData(role="page")','pagebeforeshow.popover', function(){
+            var $thisHeader=$(this).children('div:jqmData(role="header")');
+            popoverBtn($thisHeader);
+          });
+          $( document ).unbind('pageshow.resetPageHeight');
+          // TODO: unbind resetActivePageHeight for popover pages
+
+        };
+
+        function splitView(){
+          $menu.removeClass('panel-popover')
+               .addClass('ui-panel-left')
+               .css({'width':$.mobile.menuWidth, 'min-width':$.mobile.menuMinWidth, 'display':''});
+          $menu.children('.popover_triangle').remove();
+          $main.addClass('ui-panel-right')
+               .width(function(){
+                 return $(window).width()-$('div:jqmData(id="menu")').width();
+               });
+          $mainHeader.children('.popover-btn').remove();
+
+          // replaceBackBtn($mainHeader);
+
+          $main.undelegate('div:jqmData(role="page")', 'pagebeforeshow.popover');
+          $main.delegate('div:jqmData(role="page")', 'pagebeforeshow.splitview', function(){
+            var $thisHeader=$(this).children('div:jqmData(role="header")');
+            $thisHeader.children('.popover-btn').remove();
+            // replaceBackBtn($thisHeader);
+          });
+
+        }
+
+        if(event.orientation){
+          if(event.orientation == 'portrait'){
+            popover();
+          }
+          else if(event.orientation == 'landscape') {
+            splitView();
+          }
+        }
+        else if($window.width() < 1280 && $window.width() > 480){
+          popover();
+        }
+        else if($window.width() > 1280){
+          splitView();
+        }
+      };
+
+      $(window).bind('orientationchange', _orientationHandler);
+      $(window).bind('throttledresize', _orientationHandler);
+
+      //popover button click handler - from http://www.cagintranet.com/archive/create-an-ipad-like-dropdown-popover/
+      $(document).on('click', '.popover-btn', function(e){
+        e.preventDefault();
+        $('.panel-popover').fadeToggle('fast');
+        if ($('.popover-btn').hasClass($.mobile.activeBtnClass)) {
+            $('.popover-btn').removeClass($.mobile.activeBtnClass);
+        } else {
+            $('.popover-btn').addClass($.mobile.activeBtnClass);
+        }
+      });
+
+      $(document).on('click', 'body', function(event) {
+        if (!$(event.target).closest('.panel-popover').length && !$(event.target).closest('.popover-btn').length) {
+            $(".panel-popover").stop(true, true).hide();
+            $('.popover-btn').removeClass($.mobile.activeBtnClass);
+        };
+      });
+
+
+//----------------------------------------------------------------------------------
+//Other event bindings: scrollview, crumbs, data-context and content height adjustments
+//----------------------------------------------------------------------------------
+
+      // TODO:cleanup if all is ok
+      // DONE: pageshow binding for scrollview - now using IScroll4! hell yeah!
+      // $('div:jqmData(role="page")').live('pagebeforeshow.scroll', function(event, ui){
+      //   if ($.support.touch && !$.support.touchOverflow) {
+
+      //     var $page = $(this),
+      //         $scrollArea = $page.find('div:jqmData(role="content")');
+      //         $scrAreaChildren = $scrollArea.children();
+
+      //     if ($scrAreaChildren.length > 1) {
+      //       $scrAreaChildren = $scrollArea.wrapInner("<div class='scrollable vertical'></div>").children();
+      //     }
+      //     $scrollArea.css({ 'width':'auto',
+      //                       'height':'auto',
+      //                       'overflow':'hidden'});
+      //     //TODO: if too many pages are in the DOM that have iscroll on, this might slow down the browser significantly,
+      //     //in which case we'll need to destroy() the iscroll as the page hides.
+      //     $scrollArea.iscroll();
+      //   }
+      // });
+
+      //data-hash 'crumbs' handler
+      //now that data-backbtn is no longer defaulting to true, lets set crumbs to create itself even when backbtn is not available
+      $(document).on("pagebeforeshow.crumbs", 'div:jqmData(role="page")', function(event, data){
+        var $this = $(this);
+        if($this.jqmData('hash') == 'crumbs' || $this.parents('div:jqmData(role="panel")').data('hash') == 'crumbs'){
+          if($this.jqmData('hash')!=false && $this.find('.ui-crumbs').length < 1){
+            var $header=$this.find('div:jqmData(role="header")');
+              backBtn = $this.find('a:jqmData(rel="back")');
+
+            if(data.prevPage.jqmData('url') == $this.jqmData('url')){  //if it's a page refresh
+              var prevCrumb = data.prevPage.find('.ui-crumbs');
+              crumbify(backBtn, prevCrumb.attr('href'), prevCrumb.find('.ui-btn-text').html());
+            }
+            else if($.mobile.urlHistory.stack.length > 0) {
+              var text = data.prevPage.find('div:jqmData(role="header") .ui-title').html();
+              crumbify(backBtn, '#'+data.prevPage.jqmData('url'), text);
+            }
+            else if(backBtn.length && $.mobile.urlHistory.stack.length <= 1) {
+              backBtn.remove();
+            }
+          }
+        }
+
+          function crumbify(button, href, text){
+            if(!button.length) {
+              $this.find('div:jqmData(role="header")').prepend('<a class="ui-crumbs ui-btn-left" data-icon="arrow-l"></a>');
+              button=$header.children('.ui-crumbs').buttonMarkup();
+            }
+            button.removeAttr('data-rel')
+                  .jqmData('direction','reverse')
+                  .addClass('ui-crumbs')
+                  .attr('href',href);
+            button.find('.ui-btn-text').html(text);
+          }
+      });
+
+      //data-context handler - a page with a link that has a data-context attribute will load that page after this page loads
+      //this still needs work - pageTransitionQueue messes everything up.
+      $(document).on('pagechange.context', 'div:jqmData(role="panel")', function(){
+        var $this=$(this),
+            $currPanelActivePage = $this.children('.' + $.mobile.activePageClass),
+            panelContextSelector = $this.jqmData('context'),
+            pageContextSelector = $currPanelActivePage.jqmData('context'),
+            contextSelector= pageContextSelector ? pageContextSelector : panelContextSelector;
+        //if you pass a hash into data-context, you need to specify panel, url and a boolean value for refresh
+        if($.type(contextSelector) === 'object') {
+          var $targetContainer=$('div:jqmData(id="'+contextSelector.panel+'")'),
+              $targetPanelActivePage=$targetContainer.children('div.'+$.mobile.activePageClass),
+              isRefresh = contextSelector.refresh === undefined ? false : contextSelector.refresh;
+          if(($targetPanelActivePage.jqmData('url') == contextSelector.url && contextSelector.refresh)||(!contextSelector.refresh && $targetPanelActivePage.jqmData('url') != contextSelector.url)){
+              $.mobile.changePage(contextSelector.url, options={transition:'fade', changeHash:false, pageContainer:$targetContainer, reloadPage:isRefresh});
+          }
+        }
+        else if(contextSelector && $currPanelActivePage.find(contextSelector).length){
+          $currPanelActivePage.find(contextSelector).trigger('click');
+        }
+      });
+
+      //TODO: cleanup if all is ok
+      // this measures the height of header and footer and sets content to the appropriate height so
+      // that no content is concealed behind header and footer
+      // $('div:jqmData(role="page")').live('pageshow.contentHeight', function(){
+      //   var $this=$(this),
+      //       $header=$this.children(':jqmData(role="header")'),
+      //       $footer=$this.children(':jqmData(role="footer")'),
+      //       thisHeaderHeight=$header.css('display') == 'none' ? 0 : $header.outerHeight(),
+      //       thisFooterHeight=$footer.css('display') == 'none' ? 0 : $footer.outerHeight();
+      //   // $this.children(':jqmData(role="content")').css({'top':thisHeaderHeight, 'bottom':thisFooterHeight});
+      // })
+
+      //this allows panels to change their widths upon changepage - useful for pages that need a different width than the ones provided.
+      // $('div:jqmData(role="page")').live('')
+    }
+    else {
+      //removes all panels so the page behaves like a single panel jqm
+      $(function(){
+        $('div:jqmData(role="panel")').each(function(){
+          var $this = $(this);
+          $this.replaceWith($this.html());
+        })
+      });
+    }
+  });
+})(jQuery,window);