Extracted the error message logic into a new, reusable $.mobile.showMessage() function which can be used to display any message to the user. In addition to specifying a custom message, options such as delayTime, fadeTime, and wrapperClass can be specified. NOTE: the delayTime remains 800ms for page loading error messages for the sake of continuity, but the default delayTime has been increased to 2500ms, which seems more appropriate for messages of any length.

dgeb · dgeb · commit a6de24b15ac8 · 2011-06-28T12:16:28.000-04:00
diff --git a/js/jquery.mobile.navigation.js b/js/jquery.mobile.navigation.js
@@ -700,16 +700,8 @@
 
 				// Remove loading message.
 				if ( settings.showLoadMsg ) {
-					$.mobile.hidePageLoadingMsg();
-
 					//show error message
-					$( "<div class='ui-loader ui-overlay-shadow ui-body-e ui-corner-all'><h1>"+ $.mobile.pageLoadErrorMessage +"</h1></div>" )
-						.css({ "display": "block", "opacity": 0.96, "top": $window.scrollTop() + 100 })
-						.appendTo( settings.pageContainer )
-						.delay( 800 )
-						.fadeOut( 400, function() {
-							$( this ).remove();
-						});
+					$.mobile.showMessage( $.mobile.pageLoadErrorMessage, { pageContainer: settings.pageContainer, delayTime: 800 } );
 				}
 
 				deferred.reject( absUrl, options );
@@ -728,6 +720,28 @@
 		pageContainer: undefined
 	};
 
+	// Show a custom message to the user (will be shown in the active page unless specified otherwise in options)
+	$.mobile.showMessage = function( message, options ) {
+		$.mobile.hidePageLoadingMsg();
+
+		var showMessageOptions = $.extend( {}, $.mobile.showMessage.defaults, options );
+		$( "<div class='ui-loader ui-overlay-shadow ui-corner-all "+ showMessageOptions.wrapperClass +"'><h1>"+ message +"</h1></div>" )
+			.css({ "display": "block", "opacity": 0.96, "top": $window.scrollTop() + 100 })
+			.appendTo( showMessageOptions.pageContainer == undefined ? $.mobile.activePage : showMessageOptions.pageContainer )
+			.delay( showMessageOptions.delayTime )
+			.fadeOut( showMessageOptions.fadeTime, function() {
+			$( this ).remove();
+		});
+	};
+
+	// Default options for showMessage()
+	$.mobile.showMessage.defaults = {
+		delayTime: 2500,
+		fadeTime: 400,
+		wrapperClass: 'ui-body-e',
+		pageContainer: undefined
+	};
+
 	// Show a specific page in the page container.
 	$.mobile.changePage = function( toPage, options ) {
 		// XXX: REMOVE_BEFORE_SHIPPING_1.0
