JQuery Mobile

jQuery Mobile
Developer(s)The jQuery Team
Initial releaseOctober 16, 2010 (2010-10-16)[1]
Stable release
1.4.5 / October 31, 2014 (2014-10-31)
Preview release
1.5.0-rc1 / September 10, 2018 (2018-09-10)
Repository
Written inJavaScript
PlatformSee Mobile browser support
Size351 KB / 142 KB (minified) / 40 KB (minified, gzipped)
TypeMobile application framework
LicenseMIT[2]
Websitejquerymobile.com

jQuery Mobile is a touch-optimized web framework (also known as a mobile framework), specifically a JavaScript library, developed by the jQuery project team. The development focuses on creating a framework compatible with many smartphones and tablet computers,[3] made necessary by the growing but heterogeneous tablet and smartphone market.[4] The jQuery Mobile framework is consistent with other mobile app frameworks[5] and platforms such as PhoneGap, Worklight,[6] etc.

As of October 7, 2021 jQuery Mobile has been deprecated.[7]

Features

  • Compatible with all major desktop browsers as well as all major mobile platforms, including Android, iOS, Windows Phone, Blackberry, WebOS, Symbian.
  • Built on top of jQuery core so it has a minimal learning curve for people already familiar with jQuery syntax.
  • Theming framework that allows creation of custom themes.
  • Limited dependencies and lightweight to optimize speed.
  • The same underlying codebase will automatically scale to any screen.
  • HTML5-driven configuration for laying out pages with minimal scripting.
  • AJAX-powered navigation with animated page transitions that provides ability to create semantic URLs through pushState.
  • UI widgets that are touch-optimized and platform-agnostic.

(Source: from the jQuery Mobile website)[3]

Example usage

$('div').on('tap', function(event){
  alert('element tapped ');
});

$(document).ready(function(){
    $('.myList li').on('click touchstart', function() {
        $('.myDiv').slideDown('500');
    });
});

A basic example

What follows is a basic jQuery Mobile project utilizing HTML5 semantic elements. It is important to link to the jQuery and jQuery Mobile JavaScript libraries, and stylesheet (the files can be downloaded and hosted locally, but it is recommended to link to the files hosted on the jQuery CDN).

A screen of the project is defined by a section HTML5 element, and data-role of page. Note that data-role is an example of the HTML5 data attribute, in this case being defined by jQuery Mobile. A page may have header and footer elements with data-role of header and footer, respectively. In between, there may be an article element, with a role of main and a class of ui-content. Lastly, a nav element, with data-role of navbar may be present.

One HTML document can contain more than one section element, and thus more than one screenful of content. This way it is only necessary to load one file which includes multiple pages of content. One page can link to another page within the same file by referencing the page's id attribute (e.g. href="#second").

In the example below, two other data- attributes are used. The data-theme attribute tells the browser what theme to render. The data-add-back-btn attribute adds a back button to the page if set to true.

Lastly, icons can be added to elements via the data-icon attribute. jQuery Mobile has fifty commonly-used icons built in.

A brief explanation of the Data Attributes used in this example:

data-role – Specifies the role of the element, such as header, content, footer, etc.

data-theme – Specifies which design theme to use for elements within a container. Can be set to: a or b.

data-position – Specifies whether the element should be fixed, in which case it will render at the top (for header) or bottom (for footer).

data-transition – Specifies one of ten built-in animations to use when loading new pages.

data-icon – Specifies one of fifty built-in icons that can be added to an element. 

<!doctype html>
<html>
    <head>
		<meta charset="utf-8">
		<title>jQuery Mobile Example</title>
		<meta name="viewport" content="initial-scale=1, user-scalable=no, width=device-width">
		<link rel="stylesheet" href="https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.css">		
    </head>
 
    <body>
        <section data-role="page" id="first" data-theme="a">
            <header data-role="header" data-position="fixed">
                <h1>Page 1 Header</h1>
            </header>
 
            <article role="main" class="ui-content">
                <h2>Hello, world!</h2>
                <a href="#second" data-role="button" data-inline="true" data-transition="flow" data-icon="carat-r" data-iconpos="right">Go to Page 2</a>
            </article>
 
            <footer data-role="footer" data-position="fixed">
                <h4>Page 1 Footer</h4>
            </footer>
        </section>
 
        <section data-role="page" id="second" data-theme="b">
            <header data-role="header" data-position="fixed"  data-add-back-btn="true">
                <h1>Page 2 Header</h1>
            </header>
 
            <article role="main" class="ui-content">
                <h2>Example Page</h2>
            </article>
 
            <footer data-role="footer" data-position="fixed">
                <h4>Page 2 Footer</h4>
            </footer>
        </section>
		<script src="https://code.jquery.com/jquery-1.11.1.min.js"></script>
		<script src="https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.js"></script>
    </body>
</html>

Theming

jQuery Mobile provides a theming framework that allows developers to customize color schemes and certain CSS aspects of UI features. Developers can use the jQuery Mobile ThemeRoller[8] application to customize these appearances and create branded experiences. After developing a theme in the ThemeRoller application, programmers can download a custom CSS file and include it in their project to use their custom theme.[9]

Each theme can contain up to 26 unique color "swatches," each of which consists of a header bar, content body, and button states. Combining different swatches allows developers to create a wider range of visual effects than they would be able to with just one swatch per theme. Switching between different swatches within a theme is as simple as adding an attribute called "data-theme" to HTML elements.

The default jQuery Mobile theme comes with two different color swatches, named "a" and "b". Here is an example of how to create a toolbar with the "b" swatch: 

<div data-role="header" data-theme="b"> 
	<h1>Page Title</h1> 
</div>

(Source: from the jQuery Mobile website)[3]

There are already a handful of open source style themes that are developed and supported by third-party organizations. One such open source style theme is the Metro style theme that was developed and released by Microsoft Open Technologies, Inc.[10] The Metro style theme is meant to mimic the UI of the Metro (design language) that Microsoft uses in its mobile operating systems.

Mobile browser support

Platform Version Native Phone Gap Opera Mobile Opera Mini Fennec Ozone Net front
0.9 8.5, 8.65 9.5 10 4.0 5.0 1.0 1.1* 0.9 4.0
iOS v2.2.1 A A
v3.1.3, v3.2 A A A
v4-7.0 A A A
Symbian S60 v3.1, v3.2 A A A A A C C
v5.0 C C C A C A
Symbian UIQ v3.0, v3.1 C
8.65 		C
v3.2 C C
Symbian Platform v.3.0 A
BlackBerry OS v4.5 C C C
v4.6, v4.7 C C C B
v5.0 B A C A
v6.0 A A A
Android v1.5, v1.6 A A
v2.1 A A
v2.2 A A A* C* A*
Windows Mobile v6.1 C C C C B C B C
v6.5.1 C C C A A C A
v7.0 A A C A
webOS 1.4.1 A A
bada 1.0 A
Maemo 5.0 B B C B*
MeeGo 1.1* A* A* A*

Key:

  • A - High Quality. A browser that’s capable of, at minimum, utilizing media queries (a requirement for jQuery Mobile). These browsers will be actively tested against, but may not receive the full capabilities of jQuery Mobile.
  • B - Medium Quality. A capable browser that doesn’t have enough market share to warrant day-to-day testing. Bug fixes will still be applied to help these browsers.
  • C - Low Quality. A browser that is not capable of utilizing media queries. They will not be provided any jQuery Mobile scripting or CSS (falling back to plain HTML and simple CSS).
  • * - Upcoming browser. This browser is not yet released but is in alpha/beta testing.

(Source: from the jQuery Mobile website)[3]

See also

References

  1. ^ jQuery Foundation - jquerymobile.com (2010-10-16). "jQuery Mobile Alpha 1 Released". blog.jquerymobile.com. Retrieved 2014-05-22.
  2. ^ jQuery Foundation - jquery.org (2012-09-10). "jQuery Licensing Changes". Blog.jquery.com. Retrieved 2013-10-09.
  3. ^ a b c d "Mobile Graded Browser Support".
  4. ^ "The Global Rise of the Smartphone". Archived from the original on 2018-06-17. Retrieved 2011-04-27.
  5. ^ "Resons why jQuery Mobile Is Suitable For Mobile Web App Development".
  6. ^ "IBM Worklight - United States". Worklight.com. Retrieved 2013-10-09.
  7. ^ "jQuery maintainers continue modernization initiative with deprecation of jQuery Mobile". jQuery Blog. Retrieved 6 December 2022.
  8. ^ "ThemeRoller".
  9. ^ "JQuery Mobile Theming Overview".
  10. ^ "More news from MS Open Tech: announcing the open source Metro style theme for jQuery Mobile". Archived from the original on 2014-08-16.

Further reading