Helpers: Add getFocusElement() and safelyBlur()

Author: Gabriel Schulhof

js/helpers.js

@@ -200,6 +200,42 @@ define( [ "jquery", "./ns", "jquery-ui/jquery.ui.core" ], function( jQuery ) {
 			}
 		},
 
+		// IE9 sometimes throws an exception when one attempts to access document.activeElement
+		getFocusElement: function( theDocument ) {
+			try {
+				return theDocument.activeElement;
+			} catch( anException ) {}
+		},
+
+		// Able to handle an element, a window, or a document
+		// Given a window or a document, it will safely blur its active element
+		// Given an element, it will safely blur it
+		safelyBlur: function( entity ) {
+			var theElement, theDocument, theWindow;
+
+			// document and window retrieval inspired by the widget factory
+			if ( entity.style ) {
+				theElement = entity;
+				theDocument = element.ownerDocument;
+				theWindow = ehtDocument.defaultView || theDocument.parentWindow;
+			} else {
+				if ( entity.document ) {
+					theWindow = entity;
+					theDocument = entity.document;
+					theElement = $.mobile.getFocusElement( theDocument );
+				} else {
+					theDocument = entity;
+					theWindow = theDocument.defaultView || theDocument.parentWindow;
+					theElement = $.mobile.getFocusElement( theDocument );
+				}
+			}
+
+			if ( theElement && theElement !== theWindow &&
+					theElement.nodeName.toLowerCase() !== "body" ) {
+				$.event.trigger( "blur", undefined, theElement );
+			}
+		},
+
 		loading: function() {
 			// If this is the first call to this function, instantiate a loader widget
 			var loader = this.loading._widget || $( $.mobile.loader.prototype.defaultHtml ).loader(),

js/widgets/pagecontainer.js

@@ -5,6 +5,7 @@
 define( [
 	"jquery",
 	"../core",
+	"../helpers",
 	"../navigation/path",
 	"../navigation/base",
 	"../events/navigate",
@@ -936,7 +937,7 @@ define( [
 		transition: function( toPage, triggerData, settings ) {
 			var fromPage, url, pageUrl, fileUrl, active, activeIsInitialPage, historyDir,
 				pageTitle, isDialog, alreadyThere, newPageTitle, params, cssTransitionDeferred,
-				beforeTransition, focusElement;
+				beforeTransition;
 
 			// If we are in the midst of a transition, queue the current request.
 			// We'll call changePage() once we're done with the current transition
@@ -1032,19 +1033,8 @@ define( [
 				historyDir = settings.direction === "back" ? -1 : 1;
 			}
 
-			// We blur the focussed element to cause the virtual keyboard to disappear, but we must
-			// wrap the retrieval of the focussed element in a try/catch block since IE9 throws
-			// "Unspecified error" if document.activeElement is undefined when we are in an IFrame.
-			try {
-				focusElement = this.document[ 0 ].activeElement;
-			}
-			catch( e ) {}
-
-			if ( focusElement &&
-					focusElement !== this.window[ 0 ] &&
-					focusElement.nodeName.toLowerCase() !== "body" ) {
-				$( focusElement ).blur();
-			}
+			// We blur the focused element to cause the virtual keyboard to disappear
+			$.mobile.safelyBlur( this.document[ 0 ] );
 
 			// Record whether we are at a place in history where a dialog used to be -
 			// if so, do not add a new history entry and do not change the hash either

js/widgets/popup.js

@@ -16,6 +16,7 @@ define( [
 	"../links",
 	"../widget",
 	"../support",
+	"../helpers",
 	"../events/navigate",
 	"../navigation/path",
 	"../navigation/history",
@@ -26,17 +27,6 @@ define( [
 //>>excludeEnd("jqmBuildExclude");
 (function( $, undefined ) {
 
-// IE9 sometimes throws an exception when one attempts to access document.activeElement
-function getFocusElement( document ) {
-	var focusElement;
-
-	try {
-		focusElement = document.activeElement;
-	} catch( e ) {}
-
-	return focusElement;
-}
-
 function fitSegmentInsideSegment( windowSize, segmentSize, offset, desired ) {
 	var returnValue = desired;
 
@@ -309,9 +299,10 @@ $.widget( "mobile.popup", {
 		if ( targetElement !== ui.container[ 0 ] ) {
 			target = $( targetElement );
 			if ( !$.contains( ui.container[ 0 ], targetElement ) ) {
-				$( getFocusElement( this.document[ 0 ] ) ).one( "focus", $.proxy( function() {
-					this._safelyBlur( targetElement );
-				}, this ) );
+				$( $.mobile.getFocusElement( this.document[ 0 ] ) ).one( "focus",
+					$.proxy( function() {
+						$.mobile.safelyBlur( targetElement );
+					}, this ) );
 				ui.focusElement.focus();
 				theEvent.preventDefault();
 				theEvent.stopImmediatePropagation();
@@ -642,25 +633,18 @@ $.widget( "mobile.popup", {
 		}
 	},
 
-	_safelyBlur: function( currentElement ){
-		if ( currentElement !== this.window[ 0 ] &&
-			currentElement.nodeName.toLowerCase() !== "body" ) {
-				$( currentElement ).blur();
-		}
-	},
-
 	_openPrerequisitesComplete: function() {
 		var id = this.element.attr( "id" ),
 			firstFocus = this._ui.container.find( ":focusable" ).first(),
-			focusElement = getFocusElement( this.document[ 0 ] );
+			focusElement = $.mobile.getFocusElement( this.document[ 0 ] );
 
 		this._ui.container.addClass( "ui-popup-active" );
 		this._isOpen = true;
 		this._resizeScreen();
 
 		// Check to see if currElement is not a child of the container.  If it's not, blur
 		if ( focusElement && !$.contains( this._ui.container[ 0 ], focusElement ) ) {
-			this._safelyBlur( focusElement );
+			$.mobile.safelyBlur( focusElement );
 		}
 		if ( firstFocus.length > 0 ) {
 			this._ui.focusElement = firstFocus;