jQuery Mobile - Quick Guide

jQuery Mobile - Overview

JQuery Mobile is a user interface framework, which is built on jQuery Core and used for developing responsive websites or applications that are accessible on mobile, tablet, and desktop devices. It uses the features of both jQuery and jQuery UI to provide API features for mobile web applications.

It was developed by the jQuery project team in the year 2010 and written in JavaScript.

Why Use jQuery Mobile?

It creates web applications that it will work the same way on the mobile, tablet, and desktop devices.
It is compatible with other frameworks such as PhoneGap, Whitelight, etc.
It provides a set of touch-friendly form inputs and UI widgets.
The progressive enhancement brings a unique functionality to all mobile, tablet, and desktop platforms and adds efficient page loads and wider device support.

Features of jQuery Mobile

It is built on jQuery Core and "write less, do more" UI framework.
It is an open source framework, and cross-platform as well as cross-browser compatible.
It is written in JavaScript and uses features of both jQuery and jQuery UI for building mobile-friendly sites.
It integrates HTML5, CCS3, jQuery and jQuery UI into one framework for creating pages with minimal scripting.
It includes Ajax navigation system that uses animated page transitions.

Advantages of jQuery Mobile

It is easy to learn and develop applications if you have knowledge of HTML5, CSS3 features.
It is cross-platform and cross-browser compatible so you don't have to worry about writing different code for each device resolution.
You can create the custom theme using ThemeRoller without writing the line of code. It supports all HTML5 browsers.
It uses HTML5 along with JavaScript for easy development of web applications.
It is built in a way that allows the same code to automatically scale from the mobile screen to desktop screen.

Disadvantages of jQuery Mobile

There are limited options for CSS themes, so sites can look similar which are built by these themes.
Applications which are developed using jQuery Mobile are slower on mobiles.
It becomes more time consuming when you combine jQuery mobile with other mobile frameworks.
Difficult to provide complete customized visual design.
All the features in a device cannot be accessed by JavaScript in a browser.

jQuery Mobile - Setup

In this chapter, we will discuss how to install and set up jQuery Mobile.

Download jQuery Mobile

When you open the link jquerymobile.com/, you will see there are two options to download jQuery mobile library.

Custom Download − Click this button to download a customized version of library.
Latest Stable − Click this button to get the stable and latest version of jQuery mobile library.

Custom Download with Download Builder

Using Download Builder, you can create a custom build including only the portions of the library that you need. When you download this new customized version of jQuery Mobile, you will see the following screen.

You can select the libraries according to your need and click the Build My Download button.

Stable download

Click the Stable button, which leads directly to a ZIP file containing the CSS and JQuery files, for the latest version of jQuery mobile library. Extract the ZIP file contents to a jQuery mobile directory.

This version contains all files including all dependencies, a large collection of demos, and even the library's unit test suite. This version is helpful to getting started.

Download jQuery Library from CDNs

A CDN (Content Delivery Network) is a network of servers designed to serve files to the users. If you use a CDN link in your webpage, it moves the responsibility of hosting files from your own servers to a series of external ones. This also offers an advantage that if a visitor to your webpage has already downloaded a copy of jQuery mobile from the same CDN, it won't have to be re-downloaded. You can include the following CDN files into the HTML document.

//The jQuery Mobile CSS theme file (optional, if you are overriding the default theme)
<link rel = "stylesheet" href = "https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.css">

//The jQuery core JavaScript file
<script src = "https://code.jquery.com/jquery-1.11.3.min.js"></script>

//The jQuery Mobile core JavaScript file
<script src = "https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.js"></script>

We are using the CDN versions of the library throughout this tutorial. We use AMPPS (AMPPS is a WAMP, MAMP and LAMP stack of Apache, MySQL, MongoDB, PHP, Perl & Python) server to execute all our examples.

Example

Following is a simple example of jQuery Mobile.

<!DOCTYPE html>
<html>
   <head>
      <meta name = "viewport" content = "width = device-width, initial-scale = 1">
      <link rel = "stylesheet" href = "https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.css">
      <script src = "https://code.jquery.com/jquery-1.11.3.min.js"></script>
      <script src = "https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.js"></script>
   </head>

   
      
   <body>
      <div data-role = "page" id = "pageone">
         <div data-role = "header">
            <h1>Header Text</h1>
         </div>

         <div data-role = "main" class = "ui-content">
            <h2>Welcome to TutorialsPoint</h2>
         </div>

         <div data-role = "footer">
            <h1>Footer Text</h1>
         </div>
      </div>
   </body>
</html>

Details of the above code are −

This code is specified inside the head element.

<meta name = "viewport" content = "width = device-width, initial-scale = 1">

The viewport is used to specify (by the browser) to display the page zoom level and dimension.
content = "width = device-width" is used to set the pixel width of the page or screen device.
initial-scale = 1 sets the initial zoom level, when the page is loaded for the first time.

Include the following CDNs

<link rel = "stylesheet" href = "https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.css">
<script src = "https://code.jquery.com/jquery-1.11.3.min.js"></script>
<script src = "https://code.jquery.com/mobile/1.4.5/jquery.mobile-1.4.5.min.js"></script>

Content inside the <body> tag is a page displayed in the browser.

<div data-role = "page">
   ...
</div>

data-role = "header" creates the header at the top of the page.
data-role = "main" is used to define the content of the page.
data-role = "footer" creates the footer at the bottom of the page.
class = "ui-content" includes padding and margin inside the page content.

Output

Let's carry out the following steps to see how the above code works −

Save the above html code as simple_example.html file in your server root folder.
Open this HTML file as http://localhost/simple_example.html and the following output will be displayed.

jQuery Mobile - Pages

The user can interact with jQuery Mobile pages, which groups the content into logical views and page views. Page view can be animated using page transitions. Multiple pages can be created using HTML document and therefore, there is no need of requesting the content from the server.

Following table demonstrates the types of pages in detail.

Sr.No.	Type & Description
1	Single Page A single page is created in HTML document using a standard way of writing a template.
2	Multi-Page Template Multiple pages can be included in the single HTML document, which loads together by adding multiple divs with data-role = "page".
3	Dialogs Page Modal dialogs open content in an interactive overlay above the page.

Conventions, not requirements

The data-role attribute elements such as the header, footer, page, and content are used to provide the basic format and structure of a page.
For single page documents, the page wrapper was required for auto-initialization is set as optional.
The structural element can be excluded for a webpage with custom layout.
To manage pages, the page wrapper is injected by the framework when it is not included by the markup.

Prefetching pages

Including the attribute data-prefetch, we can prefetch pages into the DOM in the single page templates. For more information click here.

DOM Cache

When the browser memory gets full in DOM, then it slow downs the mobile browser or might crash due to loading of multiple pages. There is a simple method to keep the DOM tidy −

When a page is loaded via ajax, then it indicates to remove the page from DOM when you redirect to another page.
The previous page which you have visited can be retrived from the cache when you revisit it.
Instead of removing the pages, you can tell jQuery mobile to keep it in DOM by using the following line −

$.mobile.page.prototype.options.domCache = true;

Set the domCache option as true on the page plugin to keep all the pages in the DOM, which was visited previously.

pageContainerElement.page({ domCache: true });

jQuery Mobile - Icons

jQuery Mobile provides a set of built-in icons, which can be used with buttons, listview buttons which will make the buttons more attractive.

Following table lists down some of the icons used in the jQuery Mobile framework.

Sr.No.	Icon Area & Description
1	Icon Set It sets the icon in the button.
2	Positioning Icons It specifies the position of the icon in the button.
3	Icon-only It displays only an icon in the button.
4	Icon shadow It adds an icon shadow in your button.
5	Removing Circle It removes the grey circle around the icon.
6	Black or White Icons It changes the color of icons to black or white.
7	Combining alt and nodisc It combines the alt and nodisc classes to the icon.

jQuery Mobile - Transitions

It allows to change property values which occurs over specified duration and alters behavior of an element from one state to another state by applying different styles for each state.

Following table lists down some of the page transitions used in the jQuery Mobile framework −

Sr.No.	Transition & Description	For Pages	For Dialogs
1	fade You can make elements fade in and out of visibility.	Fade Page	Fade Dialog
2	flip Flip the elements from back to front to the next page.	Flip Page	Flip Dialog
3	pop You can create a popup window.	Pop Page	Pop Dialog
4	flow Display the next page by keeping current page away.	Flow Page	Flow Dialog
5	slide You can slide the page from right to left.	Slide Page	Slide Dialog
6	slidefade Slides the page from right to left and fades in the next page.	Slidefade Page	Slidefade Dialog
7	slideup Slides the page from bottom to up.	Slideup Page	Slideup Dialog
8	slidedown Slides the page from top to bottom.	Slidedown Page	Slidedown Dialog
9	turn You can turn to the next page.	Turn Page	Turn Dialog
10	none You cannot use any transition effect by using this attribute.	None Page	None Dialog

Setting Transition and Global Configuration

By default, pages will have fade transition in the framework. You can use custom transitions by adding the data-transition attribute to the link. You can use different default transition effects for the page using defaultPageTransition option globally. For dialogs, you can make use of defaultDialogTransition option.

Fallback Transition

All transitions support 3D transformations except the fade transition. The devices which do not support 3D transformation, they will have to make use of fade transition. Some browsers do not support 3D transformations for each transition type, so you can use the fade as default transition fallback.

Max Scroll for Transitions

The transitions are set to none when you are scrolling from or to a page and the scroll position will be three times the height of the device screen. Sometimes, you may get slow in responding or the browser may crash when you click any navigation element; so to avoid this we are using the scroll position for transition by using getMaxScrollForTransition function.

Max Width for Transitions

You can disable the transition when the window width is higher than the pixel width. You can configure the max width for transitions using the $.mobile.maxTransitionWidth global option, which is set to false by default. It takes values such as pixel width or false value, and the transition will be set to none if it is not a false value when the window is higher than the specified value.

Same Page Transition

You can add the transitions to the current page using the allowSamePageTransition option of page container widget's change() method.

Creating Custom Transitions

You can create the custom transitions in the page using the $.mobile.transitionHandlers option that expands the selection of transitions on the website or application.

jQuery Mobile - Layouts

Grid systems are used to create page layouts through a series of rows and columns that house your content.

Below table demonstrates the types of grids in detail.

Sr.No.	Type & Description
1	Grid jQuery mobile grid system creates page layouts through a series of rows and columns.
2	Buttons in grids Collection of button in grid format in jQuery mobile.
3	Custom responsive grid The basic grid style can be easily extended to the custom responsive layout using media queries in CSS.

jQuery Mobile - Widgets

A widget is a small gadget or control of your jQuery mobile application. Widgets can be very handy as they allow you to put your favorite applications on your home screen in order to quickly access them.

Following table demonstrates the types of Widgets in detail.

Sr.No.	Type & Description
1	Buttons It specifies clickable button that includes content like text or images.
2	Checkbox Checkboxes are used when more than one option is required to be selected.
3	Radiobox Radio buttons are used when out of many options, just one option is required to be selected.
4	Datepicker It is focused on the input to open an interactive calendar in a small overlay.
5	Collapsible Collapsible allows you to expand or collapse the content whenever clicked on it. It is very helpful for mobile device, which presents a brief content.
6	Controlgroup Controlgroups provide a set of buttons to specify a single block that looks like a navigation component.
7	Filterable By using the data-filter = "true" attribute, you can filter the children of any element.
8	Flipswitch Flip Switch allows you to turn off/on or true/false the switch by clicking on it for boolean style input.
9	Listview The purpose of listview component is to render complex and customized content in lists.
10	Loader The jQuery Mobile provides different ways of loading states to an element.
11	Navbar The navbar widget is a set of buttons which links you to other web pages or sections.
12	Panels Panels are used to display the DOM components in the box.
13	Popups Popup is a user interface that appears within a small window to display text, images, and other content.
14	Rangeslider Rangeslider widget provides you with a pair of handles allowing you to select a numeric value range.
15	Selectmenu A select menu provides various options in the form of dropdown list, from where a user can select one or more options.
16	Slider Slider allows you to choose a value by sliding the handle of the slider.
17	Table jQuery Mobile uses the table to represent the data in terms of rows and columns, i.e. displays the data in a tabular format.
18	Tabs The tabs widget is jQuery ui tabs widget's extension, which accepts all the methods and options.
19	Textinput The <input> tag is used to declare an input element, a control that allows the user to input data.
20	Toolbar The jQuery mobile toolbar widget allows you to create headers and footers.

jQuery Mobile - Events

jQuery Mobile allows to create dynamic web pages. By using events, you can set up event-driven process on the elements, which are triggered by the user's interaction such as mouse click, mouse hover on an element, key press on the keyboard, etc.

Following table lists some of the events for the mobile devices, which are supported by jQuery Mobile.

Sr.No.	Event & Description
1	jQuery Mobile Events It responds to user interaction when the user clicks on a certain page or hovers the mouse over an element, etc.
2	jQuery Touch Events It provides touch events when the user touches the screen.
3	jQuery Scroll Events It fires the scroll events when the user scrolls up and down.
4	jQuery Orientation Event It triggers the orientation event when the user rotates the device vertically or horizontally.
5	jQuery Page Events It provides the page events when the user hides, creates, loads, or unloads the pages.

jQuery Mobile - Forms

Creation of forms is easy and very flexible, which are built with a combination of standardized form elements and buttons.

Following table demonstrates the types of form in detail.

Sr.No.	Type & Description
1	Form Basic jQuery Mobile provides powerful, easy, and versatile layout system for Forms, which combines form styles, input button, and slider support.
2	Form Inputs The <input> tag is a control that allows the user to input data.
3	Form Select In form of option, a dropdown list is provided for select menu.
4	Form Sliders Slider allows you to choose a value by sliding the handle of the slider.
5	Refreshing and auto initialization of form elements Refresh method is used to update the new state of form control by itself and updates the form control with JavaScript.

jQuery Mobile - Themes

It sets different types of theme on the buttons, navbars, blocks, links and so on. You can set the theme using data-theme attribute.

Following table describes the use of the theme functionality in different areas which is supported by jQuery Mobile.

Sr.No.	Functionality & Description
1	Themes It provides two different types of themes such as theme "a" and theme "b" to customize the look of the application.
2	Theming Header and Footer in Dialogs Sets the theme for header and footer in the dialog box.
3	Theming Buttons, Icons and Popups Specifies the theme for buttons, icons and popups.
4	Theming Buttons in Header and Footer Displays the theme for buttons in the header and footer.
5	Theming Navigation Bars Applies the theme for navigation bars in header or footer.
6	Theming Panels You can apply the theme for panel.
7	Theming Collapsible Button and Split Buttons Displays the theme for collapsible and split buttons.
8	Theming Lists and Collapsible Lists Displays the theme for lists and collapsible lists.
9	Collapsible Forms You can apply the theme for forms.

jQuery Mobile - CSS Classes

jQuery CSS Classes

You can use different types of CSS classes to style the elements as described in the below sections.

Global Classes

The following classes can be used as global classes on jQuery Mobile widgets −

Sr.No.	Class & Description
1	ui-corner-all It displays the elements with rounded corners.
2	ui-shadow It displays the shadow for the elements.
3	ui-overlay-shadow It displays the overlay shadow for the elements.
4	ui-mini It displays the smaller elements.

Button Classes

The following table lists button classes that are used with anchor or button elements −

Sr.No.	Class & Description
1	ui-btn It specifies that the element will be styled as button.
2	ui-btn-inline It shows the button as inline element which saves the space as needed for the label.
3	ui-btn-icon-top It places the icon above the text.
4	ui-btn-icon-right It places the icon right of the text.
5	ui-btn-icon-bottom It places the icon below the text.
6	ui-btn-icon-left It places the icon left of the text.
7	ui-btn-icon-notext It shows the only icon.
8	ui-btn-a\|b It displays the color of the button ("a" will be the default background color i.e. gray and "b" will change the background color to black).

Icon Classes

The following table lists icon classes that are used with anchor or button elements −

Sr.No.	Class & Description
1	ui-icon-action It shows the action icon.
2	ui-icon-alert It display the exclamation mark inside a triangle.
3	ui-icon-arrow-d-l It specifies down with left arrow.
4	ui-icon-arrow-d-r It specifies down with right arrow.
5	ui-icon-arrow-u-l It specifies up with left arrow.
6	ui-icon-arrow-u-r It specifies up with right arrow.
7	ui-icon-arrow-l It specifies the left arrow.
8	ui-icon-arrow-r It specifies the right arrow.
9	ui-icon-arrow-u It specifies the up arrow.
10	ui-icon-arrow-d It specifies the down arrow.
11	ui-icon-bars It shows the 3 horizontal bars one above the other.
12	ui-icon-bullets It shows the 3 horizontal bullets one above the other.
13	ui-icon-carat-d It displays the carat to down.
14	ui-icon-carat-l It displays the carat to left.
15	ui-icon-carat-r It displays the carat to right.
16	ui-icon-carat-u It displays the carat to up.
17	ui-icon-check It shows the checkmark icon.
18	ui-icon-comment It specifies the comment or message.
19	ui-icon-forbidden It displays the forbidden icon.
20	ui-icon-forward It specifies the forward icon.
21	ui-icon-navigation It specifies the navigation icon.
22	ui-icon-recycle It displays the recycle icon.
23	ui-icon-refresh It shows the refresh icon.
24	ui-icon-tag It indicates the tag icon.
25	ui-icon-video It indicates the video or camera icon.

Theme Classes

It provides two different types of themes such as theme "a" and theme "b" to customize the look of the application. You can create your own theme classes by appending swatch letter (a-z). Following table lists theme classes which are specified from letter a to z.

Sr.No.	Class & Description
1	ui-bar-(a-z) It displays the color for bar including headers, footers, and other bars in the page.
2	ui-body-(a-z) It displays the color for content block including listview, popups, sliders, panels, loaders, etc.
3	ui-btn-(a-z) It displays the color for button.
4	ui-group-theme-(a-z) It displays the color for controlgroups, listviews, and collapsible sets.
5	ui-overlay-(a-z) It displays the background color for popup, dialog, and page containers.
6	ui-page-theme-(a-z) It displays the color for pages.

Grid Classes

Following table lists grid classes that are used with equal width, no border, background, margin or padding.

Sr.No.	Grid Class	Columns	Column Widths	Corresponds To
1	ui-grid-solo	1	100%	ui-block-a
2	ui-grid-a	2	50%/50%	ui-block-a\|b
3	ui-grid-b	3	33%/33%/33%	ui-block-a\|b\|c
4	ui-grid-c	4	25%/25%/25%/25%	ui-block-a\|b\|c\|d
5	ui-grid-d	5	20%/20%/20%/20%/20%	ui-block-a\|b\|c\|d\|e

jQuery Mobile - Data Attributes

Button

It specifies a clickable button that includes content like text or images using the class ui-btn. It is deprecated in version 1.4. Use the ui-btn attribute instead of using data-role = "button" attribute.

Following table lists the button elements used with data attribute.

Sr.No.	Data-attribute & Description	Value
1	data-corners It defines whether the button should contain rounded corners or not.	true \| false
2	data-icon It defines the icon of the button.	Default is no icon
3	data-iconpos It defines the position of the icon.	left \| right \| top \| bottom
4	data-iconshadow It defines whether the icon of the button should contain shadow or not.	true \| false
5	data-inline It defines whether the button should be inline or not.	true \| false
6	data-mini It defines whether the button should display in smaller size or regular size.	true \| false
7	data-shadow It defines whether the button should contain shadow or not.	true \| false
8	data-theme It displays the theme color for the button.	letter (a-z)

Checkbox

Following table lists the checkbox elements used with type = "checkbox".

Sr.No.	Data-attribute & Description	Value
1	data-mini It defines whether the checkbox should display in smaller size or regular size.	true \| false
2	data-role It stops styling of checkboxes as buttons.	none
3	data-theme It displays the theme color for the checkbox.	letter (a-z)

Sr.No.

Data-attribute & Description

Value

data-mini

It defines whether the checkbox should display in smaller size or regular size.

true | false

data-role

It stops styling of checkboxes as buttons.

none

data-theme

It displays the theme color for the checkbox.

letter (a-z)

Collapsible

Following table lists collapsible elements used with data-role = "collapsible" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-collapsed It indicates whether the content should be closed or expanded.	true \| false
2	data-collapsed-cue-text It displays feedback for users with screen reader software.	Default is collapsing content
3	data-collapsed-icon It defines the icon of collapsible button.	Default icon is "plus"
4	data-content-theme It displays the theme color for the collapsible content.	letter (a-z)
5	data-expanded-cue-text It displays feedback for users with screen reader software.	Default is expanding content
6	data-expanded-icon It displays the collapsible button when you expand the content.	Default icon is "minus"
7	data-iconpos It defines the position of the icon.	left \| right \| top \| bottom
8	data-inset It defines whether the collapsible button should display with rounded corners and margin or not.	true \| false
9	data-mini It defines whether the collapsible buttons should display in smaller size or regular size.	true \| false
10	data-theme It displays the theme color for the collapsible button.	letter (a-z)

Collapsible Set

Following table lists the collapsible set elements used with the data-role = "collapsibleset" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-collapsed-icon It defines the icon of collapsible button.	Default icon is "plus"
2	data-content-theme It displays the theme color for the collapsible content.	letter (a-z)
3	data-expanded-icon It displays the collapsible button when you expand the content.	Default icon is "minus"
4	data-iconpos It defines the position of the icon.	left \| right \| top \| bottom
5	data-inset It defines whether the collapsible button should display with rounded corners and margin or not.	true \| false
6	data-mini It defines whether the collapsible buttons should display in smaller size or regular size.	true \| false
7	data-theme It displays the theme color for the collapsible button.	letter (a-z)

Controlgroup

Following table lists Controlgroup elements used with data-role = "controlgroup" attribute −

Sr.No.	Data-attribute & Description	Value
1	data-exclude-invisible It defines whether to exclude invisible children in the assignment of rounded corners.	true \| false
2	data-mini It defines whether the group should display in smaller size or regular size.	true \| false
3	data-theme It displays the theme color for the controlgroup.	letter (a-z)
4	data-type It indicates whether the group should display in horizontal or vertical format.	horizontal \| vertical

Dialog

Following table lists dialog elements used with data-dialog="true" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-close-btn It defines the position of the close button.	left \| right \| none
2	data-close-btn-text It defines the text for the close button.	text
3	data-corners It defines whether dialog should display with rounded corners or not.	true \| false
4	data-dom-cache It indicates whether DOM cache must clear or not for individual pages.	true \| false
5	data-overlay-theme It defines the overlay color of the dialog page.	letter (a-z)
6	data-theme It defines the theme color of the dialog page.	letter (a-z)
7	data-title It defines the title of the dialog page.	text

Enhancement

Following table lists enhancement elements used with data-enhance="false" or data-ajax = "false" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-enhance You can style the page by setting this attribute to "true". You cannot style the page if it is set to "false".	true \| false
2	data-ajax It indicates whether pages must load from Ajax or not.	true \| false

Sr.No.

Data-attribute & Description

Value

data-enhance

You can style the page by setting this attribute to "true". You cannot style the page if it is set to "false".

true | false

data-ajax

It indicates whether pages must load from Ajax or not.

true | false

Fixed Toolbar

Following table lists the toolbar elements used with data-position = "fixed" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-disable-page-zoom It defines whether the user is able to scale/zoom the page or not.	true \| false
2	data-fullscreen It defines toolbars must be positioned at the top and/or bottom.	true \| false
3	data-tap-toggle It indicates whether the user can toggle toolbar-visibility on taps or not.	true \| false
4	data-transition It shows a transition effect when you tap or click the element.	slide \| fade \| none
5	data-update-page-padding It updates the padding of page by using resize, transition and update layout events.	true \| false
6	data-visible-on-page-show It defines toolbar-visibility when the parent page is shown.	true \| false

Flip Toggle Switch

Following table lists the flip toggle elements used with data-role = "flipswitch" attribute −

Sr.No.	Data-attribute & Description	Value
1	data-mini It defines whether the switch should display in smaller size or regular size.	true \| false
2	data-on-text It defines the "on" text on the flip switch.	Default is "on"
3	data-off-text It defines the "off" text on the flip switch.	Default is "off"

Sr.No.

Data-attribute & Description

Value

data-mini

It defines whether the switch should display in smaller size or regular size.

true | false

data-on-text

It defines the "on" text on the flip switch.

Default is "on"

data-off-text

It defines the "off" text on the flip switch.

Default is "off"

Footer

The following table lists footer elements used with data-role="footer" attribute −

Sr.No.	Data-attribute & Description	Value
1	data-id It defines the unique ID.	text
2	data-position It defines whether the footer should be positioned at the bottom or inline with page content.	inline \| fixed
3	data-fullscreen It defines whether the footer should be positioned at the bottom and over the page content or not.	true \| false
4	data-theme It defines the theme color of the footer.	letter (a-z)

Header

Following table lists the header elements used with data-role = "header" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-id It defines the unique ID.	text
2	data-position It defines whether the header should be positioned at the bottom or inline with the page content.	inline \| fixed
3	data-fullscreen It defines whether the header should be positioned at the bottom and over the page content or not.	true \| false
4	data-theme It defines the theme color of the header.	letter (a-z)

Inputs

Following table lists the input elements used with type = "text|search|etc" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-clear-btn It defines whether the input element should contain clear button or not.	true \| false
2	data-clear-btn-text It defines the text for the clear button.	text
3	data-mini It defines whether input should display in smaller size or regular size.	true \| false
4	data-role It stops styling input or text areas as buttons.	none
5	data-theme It defines the theme color of the input element.	letter (a-z)

Link

Following table lists the link elements used with jQuery Mobile.

Sr.No.	Data-attribute & Description	Value
1	data-ajax It indicates whether the pages must be loaded through Ajax or not.	true \| false
2	data-direction It is used for reverse transition.	reverse
3	data-dom-cache It indicates whether jQuery DOM cache must be clear or not for pages.	true \| false
4	data-prefetch It is used to prefetch the pages into DOM.	true \| false
5	data-rel It specifies the behavior of the link.	back \| dialog \| external \| popup
6	data-transition It defines the transition from one page to another.	fade \| flip \| flow \| pop \| slide \| slidedown \| slidefade \| slideup \| turn \| none
7	data-position-to It defines the position of the popup boxes.	origin \| jQuery selector \| window

List

Following table shows the list elements used with data-role = "listview" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-autodividers It divides the list automatically.	true \| false
2	data-count-theme It defines the theme color of the count element.	letter (a-z)
3	data-divider-theme It defines the theme color for list divider.	letter (a-z)
4	data-filter It is used to filter the list values in the search box.	true \| false
5	data-filter-placeholder It defines some text inside the search box.	text
6	data-filter-theme It defines the theme color for search filter.	letter (a-z)
7	data-icon It provides the icon for the list.	Default is no icon
8	data-inset It defines whether list should display with rounded corners and margin or not.	true \| false
9	data-split-icon It defines the icon for split button.	The default icon is "arrow-r"
10	data-split-theme It defines the theme color for split button.	letter (a-z)
11	data-theme It defines the theme color for the list.	letter (a-z)

List Item

Following table shows list item elements used with data-role = "listview" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-filtertext It is used to filter the list values using the text in the search box.	text
2	data-icon It provides the icon for the list item.	Default is no icon
3	data-role It defines the divider for list items.	list-divider
4	data-theme It defines the theme color for the list item.	letter (a-z)

Navbar

Following table lists the navbar elements used with data-role = "navbar" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-icon It provides the icon for the list item.	Default is no icon
2	data-iconpos It defines the position for the icon.	left \| right \| top \| bottom \| notext

Sr.No.

Data-attribute & Description

Value

data-icon

It provides the icon for the list item.

Default is no icon

data-iconpos

It defines the position for the icon.

left | right | top | bottom | notext

Page

Following table lists the page elements used with data-role = "page" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-dom-cache It indicates whether DOM cache must clear or not for individual pages.	true \| false
2	data-overlay-theme It defines the overlay color of the dialog pages.	letter (a-z)
3	data-theme It defines theme color for the page.	letter (a-z)
4	data-title It provides the title for the page.	Default is no icon
5	data-url It is used to updating the URL.	url

Popup

Following table lists the popup elements used with data-role = "popup" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-corners It defines whether the popup should display with rounded corners and margin or not.	true \| false
2	data-dismissible It defines the whether popup should be close by clicking outside or not.	true \| false
3	data-history It defines the whether popup should display the history of item when opened.	true \| false
4	data-overlay-theme It defines the overlay color of the popup box.	letter (a-z)
5	data-shadow It displays the shadow for the popup box.	true \| false
6	data-theme It defines theme color for the popup box.	letter (a-z)
7	data-tolerance It defines the edges of the window.	30, 15, 30, 15

Radio Button

Following table lists the radio button elements used with type = "radio" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-mini It defines whether the button should display in smaller size or regular size.	true \| false
2	data-role It stops the styling of radio buttons as enhanced buttons.	none
3	data-theme It defines the theme color for the radio button.	letter (a-z)

Sr.No.

Data-attribute & Description

Value

data-mini

It defines whether the button should display in smaller size or regular size.

true | false

data-role

It stops the styling of radio buttons as enhanced buttons.

none

data-theme

It defines the theme color for the radio button.

letter (a-z)

Select

Following table lists the select elements used with jQuery Mobile.

Sr.No.	Data-attribute & Description	Value
1	data-icon It provides the icon for the select element.	Default is "arrow-d"
2	data-iconpos It defines the position of the icon.	left \| right \| top \| bottom
3	data-inline It defines whether the button should be inline or not.	true \| false
4	data-mini It defines whether select should display in smaller size or regular size.	true \| false
5	data-native-menu It use custom menu when it has been set to false.	true \| false
6	data-overlay-theme It defines the overlay color for the custom select menu.	letter (a-z)
7	data-placeholder It is used to set an option element of non-native select.	true \| false
8	data-role It stops the styling of select elements as buttons.	none
9	data-theme It displays the theme color for the select elements.	letter (a-z)

Slider

Following table lists the slider elements used with type = "range" attribute.

Sr.No.	Data-attribute & Description	Value
1	data-highlight It highlights the slider.	true \| false
2	data-mini It defines whether the slider should display in smaller size or regular size.	true \| false
3	data-role It stops the styling of slider controls as buttons.	none
4	data-theme It displays the theme color for the slider control.	letter (a-z)
5	data-track-theme It displays the theme color for the slider track.	letter (a-z)