Mobile enabled web apps with ASP.NET MVC 3 and jQuery Mobile

In my previous blog posts, I have demonstrated a simple web app using ASP.NET MVC 3 and EF Code First. In this post, I will be focus on making this application for mobile devices. A single web site will be used for both mobile browsers and desktop browsers. If users are accessing the web app from mobile browsers, users will be redirect to mobile specific pages and will get normal pages if users are accessing from desktop browsers. In this demo app, the mobile specific pages are maintained in an ASP.NET MVC Area named Mobile and mobile users will be redirect to MVC Area Mobile.

Let’s add a new area named Mobile to the ASP.NET MVC app. For adding Area, right click the ASP.NET MVC project and  select Area from Add option. Our mobile specific pages using jQuery Mobile will be maintained in the Mobile Area.

 

ASP.NET MVC Global filter for redirecting mobile visitors to Mobile area

Let’s add an ASP.NET MVC Global filter for redirecting mobile visitors to Mobile area. The below Global filter is taken from the sample app http://aspnetmobilesamples.codeplex.com/ created by the ASP.NET team. The below filer will redirect the Mobile visitors to an ASP.NET MVC Area Mobile.

 

  1. public class RedirectMobileDevicesToMobileAreaAttribute :AuthorizeAttribute
  2.     {
  3.         protected override boolAuthorizeCore(System.Web.HttpContextBase httpContext)
  4.         {
  5.             // Only redirect on the first request in a session
  6.             if (!httpContext.Session.IsNewSession)
  7.                 return true;
  8.             // Don’t redirect non-mobile browsers
  9.             if (!httpContext.Request.Browser.IsMobileDevice)
  10.                 return true;
  11.             // Don’t redirect requests for the Mobile area
  12.             if (Regex.IsMatch(httpContext.Request.Url.PathAndQuery,”/Mobile($|/)”))
  13.                 return true;
  14.             return false;
  15.         }
  16.         protected override voidHandleUnauthorizedRequest(AuthorizationContext filterContext)
  17.         {
  18.             var redirectionRouteValues = GetRedirectionRouteValues(filterContext.RequestContext);
  19.             filterContext.Result = newRedirectToRouteResult(redirectionRouteValues);
  20.         }
  21.         // Override this method if you want to customize the controller/action/parameters to which
  22.         // mobile users would be redirected. This lets you redirect users to the mobile equivalent
  23.         // of whatever resource they originally requested.
  24.         protected virtual RouteValueDictionaryGetRedirectionRouteValues(RequestContext requestContext)
  25.         {
  26.             return new RouteValueDictionary(new { area = “Mobile”, controller = “Home”, action = “Index” });
  27.         }
  28.     }

Let’s add the global filer RedirectMobileDevicesToMobileAreaAttribute to the global filter collection in the Application_Start() of Global.asax.cs file

 

  1. GlobalFilters.Filters.Add(newRedirectMobileDevicesToMobileAreaAttribute(), 1);

Now your mobile visitors will be redirect to the Mobile area. But the browser detection logic in the RedirectMobileDevicesToMobileAreaAttribute filter will not be working in some modern browsers and some conditions. But the good news is that ASP.NET’s browser detection feature is extensible and will be greatly working with the open source framework 51Degrees.mobi. 51Degrees.mobi is a Browser Capabilities Provider that will be working with ASP.NET’s Request.Browser and will provide more accurate and detailed information. For more details visit the documentation page at http://51degrees.codeplex.com/documentation.

Let’s add a reference to 51Degrees.mobi library using NuGet

Nuget_51Mobi

We can easily add the 51Degrees.mobi from NuGet and this will update the web.config for necessary configuartions.

Mobile Web App using jQuery Mobile Framework

jQuery Mobile Framework is built on top of jQuery that provides top-of-the-line JavaScript in a unified User Interface that works across the most-used smartphone web browsers and tablet form factors. It provides an easy way to develop user interfaces for mobile web apps. The current version of the framework is jQuery Mobile Alpha 3.
We need to include the following files to use jQuery Mobile.

  • The jQuery Mobile CSS file (jquery.mobile-1.0a3.min.css)
  • The jQuery library (jquery-1.5.min.js)
  • The jQuery Mobile library (jquery.mobile-1.0a3.min.js)

Let’s add the required jQuery files directly from jQuery CDN . You can download the files and host them on your own server.

jQuery Mobile page structure

The basic jQuery Mobile page structure is given below

<!DOCTYPE html>
<html>
<head>
<title>Page Title</title>
<link rel=”stylesheet” href=”http://code.jquery.com/mobile/1.0a3/jquery.mobile-1.0a1.min.css” />
<script src=”http://code.jquery.com/jquery-1.5.min.js”></script>
<script src=”http://code.jquery.com/mobile/1.0a3/jquery.mobile-1.0a3.min.js”></script>
</head>
<body>

<div data-role=”page”>

<div data-role=”header”>
<h1>Page Title</h1>
</div>

<div data-role=”content”>
<p>Page content goes here.</p>
</div>

<div data-role=”footer”>
<h4>Page Footer</h4>
</div>
</div>

</body>
</html>

The data- attributes are the new feature of HTML5 so that jQuery Mobile will be working on browsers that supporting HTML 5. You can get a detailed browser support details from http://jquerymobile.com/gbs/ . In the Head section we have included the Core jQuery javascript file and jQuery Mobile Library and the core CSS Library for the UI Element Styling. These jQuery files are minified versions and will improve the performance of page load on Mobile Devices.

The jQuery Mobile pages are identified with an element with the data-role=”page” attribute inside the <body> tag.
<div data-role=”page”>
</div>
Within the “page” container, any valid HTML markup can be used, but for typical pages in jQuery Mobile, the immediate children of a “page” are div element with data-roles of “header”, “content”, and “footer”.

<div data-role=”page”>
<div data-role=”header”>…</div>
<div data-role=”content”>…</div>
<div data-role=”footer”>…</div>
</div>
The div data-role=”content” holds the main content of the HTML page and will be used for making user interaction elements. The div data-role=”header” is header part of the page and div data-role=”footer” is the footer part of the page.

Creating Mobile specific pages in the Mobile Area
Let’s create Layout page for our Mobile area

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4.     <title>@ViewBag.Title</title>
  5.     <link rel=”stylesheet”href=”http://code.jquery.com/mobile/1.0a3/jquery.mobile-1.0a3.min.css”/&gt;
  6.     <script src=”http://code.jquery.com/jquery-1.5.min.js”></script&gt;
  7.     <script src=”http://code.jquery.com/mobile/1.0a3/jquery.mobile-1.0a3.min.js”></script&gt;
  8. </head>
  9.    <body>
  10. @RenderBody()
  11. </body>
  12. </html>

In the Layout page, I have given reference to jQuery Mobile JavaScript files and the CSS file.
Let’s add an Index view page

Index.chtml

  1. @{
  2.     ViewBag.Title = “Index”;
  3. }
  4. <div data-role=”page”>
  5. <div data-role=”header”>
  6.      <h1>Expense Tracker Mobile</h1>
  7. </div>
  8. <div data-role=”content”>
  9. <ul data-role=”listview”>
  10.     <li>@Html.Partial(“_LogOnPartial”)</li>
  11.      <li>@Html.ActionLink(“Home”, “Index”, “Home”)</li>
  12.      <li>@Html.ActionLink(“Category”, “Index”,”Category”)</li>
  13.      <li>@Html.ActionLink(“Expense”, “Index”, “Expense”)</li>
  14. </ul>
  15. </div>
  16. <div data-role=”footer”>
  17.     Shiju Varghese | <ahref=”http://weblogs.asp.net/shijuvarghese”>Blog
  18.     </a> | <a href=”http://twitter.com/shijucv”>Twitter</a&gt;
  19.   </div>
  20. </div>

 

In the Index page, we have used data-role “listview” for showing our content as List View

Let’s create a data entry screen

create.cshtml

  1. @model MyFinance.Domain.Category
  2. @{
  3.     ViewBag.Title = “Create Category”;
  4. }
  5.   <div data-role=”page”>
  6. <div data-role=”header”>
  7.      <h1>Create Category</h1>
  8.         @Html.ActionLink(“Home”, “Index”,”Home”,null, new { @class =”ui-btn-right” })
  9.   </div>
  10.   <div data-role=”content”>
  11.     @using (Html.BeginForm(“Create”,”Category”,FormMethod.Post))
  12.     {
  13.       <div data-role=”fieldcontain”>
  14.        @Html.LabelFor(model => model.Name)
  15.        @Html.EditorFor(model => model.Name)
  16.        <div>
  17.           @Html.ValidationMessageFor(m => m.Name)
  18.        </div>
  19.         </div>
  20.         <div data-role=”fieldcontain”>
  21.         @Html.LabelFor(model => model.Description)
  22.         @Html.EditorFor(model => model.Description)
  23.         </div>
  24.         <div class=”ui-body ui-body-b”>
  25.         <button type=”submit” data-role=”button” data-theme=”b”>Save</button>
  26.       </div>
  27.     }
  28. </div>
  29. </div>

 

In jQuery Mobile, the form elements should be placed inside the data-role=”fieldcontain”

The below screen shots show the pages rendered in mobile browser

Index Page

Index

Create Page

create_category

Source Code


You can download the source code from http://efmvc.codeplex.com

Summary

We have created a single  web app for desktop browsers and mobile browsers. If a user access the site from desktop browsers, users will get normal web pages and get mobile specific pages if users access from mobile browsers. If users are accessing the website from mobile devices, we will redirect to a ASP.NET MVC area Mobile. For redirecting to the Mobile area, we have used a Global filer for the redirection logic and used open source framework 51Degrees.mobi for the better support for mobile browser detection. In the Mobile area, we have created the pages using jQuery Mobile and users will get mobile friendly web pages. We can create great mobile web apps using ASP.NET MVC  and jQuery Mobile Framework.

 

Reference : http://weblogs.asp.net/shijuvarghese/archive/2011/02/25/mobile-enabled-web-apps-with-asp-net-mvc-3-and-jquery-mobile.aspx

Advertisements

2 thoughts on “Mobile enabled web apps with ASP.NET MVC 3 and jQuery Mobile

  1. Hi,

    I had worked on jQuery mobile. And I also worked on Asp.net MVC 1.0 (before 2 years ago).

    Now I want to combine both, This is not hard at all, But I have a huge problem with model layer.

    I have a webservice, I don’t require to build my Model layer. I am thinking that from the controller if I can directly call the webservice function and webservice will process the rest of the logic (that I don’t care).

    I’d like to use MVC 2, but can I have model free MVC project?
    I know viewData, that can be used to pass a value from controller to view, But will it be enough? I am wondering how can I pass Array or complex object?

Leave a Reply

Please log in using one of these methods to post your comment:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s