Announcing jQuery Mobile 1.4.0 Alpha

Posted on by

The jQuery Mobile team is thrilled to announce the 1.4.0 Alpha release. For this release we focused on performance improvements and reviewing widgets. We also introduced a new default theme and SVG icons. Some of the new features that come with this release are a flip switch widget, a generic filter widget named “filterable”, popups with arrows, tooltips for sliders and we integrated the tabs widget from jQuery UI.

Key changes | Download & CDN


To improve performance we reduced DOM manipulation. Generation of inner markup for elements styled as butons has been completely removed. In many cases the framework just adds classes to the native element during enhancement and we even reduced the amount of classes that are added by the framework.

Theme inheritance

One of the biggest changes is the way theme inheritance works. In previous versions we used JavaScript to find the nearest parent element with a theme and added theme classes to all elements. This has been replaced by a pure CSS solution where the level of specificity of the selector determines what theme (swatch) is applied. In almost all cases the default for option theme has been removed and widgets get the same theme as their container or page via CSS.

New default theme

This was also a good time to switch to a new default theme with a flat, more modern, design. The number of swatches has been reduced from five to two; a light “A” swatch and a dark “B” swatch. We will update the ThemeRoller soon so you can create your own themes for 1.4.

SVG icons

Not only the theme is new. A big thank you to Glyphish for creating a complete new icon set for jQuery Mobile! These are vector-based SVG icons, but we included a fallback to external PNG icons on browsers that don’t support inline SVG. We are also going to provide additional stylesheets, each with different icon CSS (inline SVG, data-uri PNG, and external PNG) that can be used with the full Grunticon solution.

Please help us test

In the next few weeks we will work on updating the API documentation and the Demo Center, and creating an upgrade guide. While we work on it, this guide will be available as wiki page on the Github repo. Please help us by testing the Alpha version, giving us your feedback, and reporting issues.


We want to say thanks to everyone who contributed. Thank you Sven Franck for all your hard work on the new filterable widget and the table widget!

More than 1,500 commits, many issues fixed, countless improvements made. Here is jQuery Mobile 1.4 Alpha!

New features

  • Theming: The active and focus styles are now themeable
  • Links: Deprecated class ui-link. One style for links in body and bars (bar link colors were never themeable in ThemeRoller)
  • Controlgroup: Added option theme
  • Popup: New feature popup arrow
  • Slider: New feature slider tooltip
  • Touch events now have teardown methods
  • New option for taphold event $.special.event.tap.emitTapOnTaphold default = true;
  • New widget Toolbar: replaces page.sections (which is removed) and handles all header and footer bars
  • Fixed Toolbars are now an extension on the toolbar widget
  • Toolbars work outside of pages
  • True persistant Toolbars
  • Textinput: added option corners
  • Slider and Rangeslider: added option corners.
  • New set of vector-based icons from Glyphish with fallbacks via Grunticon
  • Base tag support
  • New flip switch widget
  • New filterable widget
  • Integrated UI tabs widget
  • Popup work outside of pages
  • Panel work outside of pages
  • Option wrapperClass to add custom classes to a generated wrapper
  • All widgets (excluding listview, tables, and selectmenu) have options that can be set after the widget has been instantiated
  • All widgets (excluding listview, tables, and selectmenu) have an option named “enhanced” that allows you to provide the markup the widget itself would generate, thus saving startup time
  • Table now also has a rebuild method that makes it possible to dynamically add columns


  • Theming: The theme swatch for pages does no longer default to “c” but “a”. Dialog overlays still default to “a”. The loader theme defaults to “a” instead of “e”. Headers and footers don’t have default “a” anymore but inherit the page theme. List dividers don’t default to “b” but inherit the list theme. Count bubbles in listviews don’t default to “c” anymore, but inherit from the LI/button/divider. Count bubbles in multiple selects always had theme “c” but now always inherit the theme from the button.
  • Button style: We now use the same padding and icon positioning rules for all elements that are styled as button and changed px values to em values.
  • Option mini: We don’t set specific padding values for ui-mini anymore, but only set a smaller font-size. Because we use em values now, the padding will still be adjusted. Instead of data-mini=”true” you can add class ui-mini to a container. Now it’s also very easy to use a media query to only apply the mini size at a certain screen width.
  • Icons: We use :after pseudo element for icons instead of adding a span with class ui-icon. The icon class (ui-icon-[iconname]) is added to the button.
  • data-add-back-btn now set on toolbar not page
  • Listview filter has been replaced by new generic filter widget (“filterable”)
  • Panel: Always scroll to top when opening a panel, unless it’s a fixed panel


  • No generating of inner button markup (.ui-btn-inner and .ui-btn-text) anymore. For linked listviews this means the anchor is now the button and no longer get class .ui-link-inherit.
  • Listviews: We no longer add the classes ui-li-has-arrow (list item) and ui-btn-icon-right (list button).
  • Button: Button elements are no longer wrapped in a div. Inputs type submit and reset used to get class ui-submit on the wrapper div. This has been changed to class ui-input-btn and also applies to input type button. The native input element no longer gets class ui-btn-hidden.
  • Form labels: Labels no longer get a class (they used to get the widget class).
  • Listview: Removed nested listview feature (deprecated in 1.3).
  • Dropped support for IE7 and BB5 (now C-grade)


  • Deprecated auto-enhancement of links in toolbars:
  • Deprecated class ui-disabled. Use class ui-state-disabled instead.
  • Deprecated class ui-btn-corner-all. One corner class: ui-corner-all (corner radii for buttons have selector .ui-btn.ui-corner-all).
  • Listviews thumbs and icons (small image left): The feature to auto-detect thumbs and icons has been deprecated to improve performance. If a list item (read-only) or button (linked) contains a thumb you have to add class ui-li-has-thumb to the LI. If it contains an icon you have to add ui-li-has-icon to the LI and don’t have to add class ui-li-icon to the image element anymore. Also, the framework doesn’t add class ui-li-thumb anymore in 1.4.
  • Theming inheritance: Deprecated getInheritedTheme(). Theme inheritance is done with CSS now.
  • Deprecated data-role=”field-contain”. Just add class “ui-field-contain”.
  • Icon shadow: Deprecated option iconshadow for buttons and select. You can use class ui-shadow-icon on a container or a button (same as ui-icon-alt and ui-icon-nodisc). Also work with listviews, controlgroups, checkbox/radio, etc. that didn’t have option iconshadow.
  • The second pagebeforechange has been replaced with pagebeforetransition. Both will be triggered for compatibility
  • Deprecated current persistent fixed toolbars in favor of true persistent (outside page)
  • Deprecated current dialog widget. Dialog will become an option in the page widget.
  • Deprecated current slider widget. We are going to refactor or replace the slider widget in next version.
  • Deprecated input element generation for filter
  • Deprecated filterPlaceholder option for filterable
  • Deprecated current behaviour of stripping query strings from hashes. Starting in 1.5 we’ll be following spec on hashes and provide a hook to handle custom navigation.


CDN-Hosted JavaScript:

CDN-Hosted CSS:

Copy-and-Paste Snippet for CDN-hosted files:

<link rel="stylesheet" href="" />
<script src=""></script>
<script src=""></script>

Note: jQuery Mobile 1.4 also supports jQuery core 2.0.

ZIP File: If you want to host the files yourself you can download a zip of all the files:

Fork jQuery Mobile on GitHub

Project leadership

Posted on by

Today we’re announcing a change to our project leadership. Since the start of the jQuery Mobile project in 2010, Todd Parker has been the project and design lead. After three years at the helm, he has decided to step aside as lead but will continue to participate as a team member with a focus on design and outreach.

We’re thrilled to announce that Jasper de Groot, a longtime team member, will be stepping in as the new jQuery Mobile project lead. Jasper is deeply knowledgeable and an all around great guy and we look forward to him leading the charge.

The most important part of any open source project is having a great team and we have that in spades with jQuery Mobile. We want to take a moment to recognize all the fantastic people on the mobile team, past and present, who have worked tirelessly over the last few years: Ghislain Seguin, John Bender, Gabriel Schulhof, Anne-Gaelle Colom, Alexander Schmitz, Scott Jehl, Mat Marquis, Kin Blas, Jason Scott, Tyler Benziger, Ralph Whitbeck, and over a hundred contributors from the community.

With this change in leadership, we’re also moving the Mobile and UI projects closer with more shared code, team members, meetings and a common destiny. We’ve been collaborating closely with Scott González, Jörn Zaefferer, and the rest of the UI team and look forward to a more unified approach going forward.

The team has been hard at work on the upcoming 1.4 release, which is nearing the alpha stage. It is focused on performance, API and code cleanup, and a new theme. Look for that release very soon.

Announcing jQuery Mobile 1.3.2

Posted on by

The jQuery Mobile team is happy to announce 1.3.2. This is the second maintenance release for 1.3 and contains fixes throughout the library. Try it now!

Demos & docs | Download & CDN | Change log


CDN-Hosted JavaScript:

CDN-Hosted CSS:


Copy-and-Paste Snippet for CDN-hosted files (recommended):

<link rel="stylesheet" href="" />
<script src=""></script>
<script src=""></script>


ZIP File:
If you want to host the files yourself you can download a zip of all the files:

Microsoft CDN hosted jQuery Mobile files:

Fork jQuery Mobile on GitHub


Change log


Popup: Correctly pass position data through to popupbeforeposition handler.

Popup: Set visibility: hidden instead of display: none to remove the need for un-hiding before height calculation.

keyboard does not disappear when after the pop-up is closed (Issue #5974)
– Popup: Blur any focused elements inside container, including the container itself, upon closing. Fixes #5974 – keyboard does not disappear when after the pop-up is closed.

Popup Widget Events Passed as init Options are Immediately Executed (Issue #5958)
– Popup: Performance improvements. Fixes #5958. Found with git bisect.


Fix for placeholder text not being grayed out in IE10


buttonMarkup: Remove popup special handling.


Duplicated “display” property (Issue #5985)
– Table: Removed duplicate display property from CSS. Fixes #5985. Thanks @mish7 !

Custom selects

Custom selects with an id containing a period don’t open their popup (Issue #5893)
– Custom select: Escape weird characters in popup/dialog ID when they become hrefs. Fixes #5893.

Dynamic Select empty when opening second time. (Issue #5935)
– Custom select: Remove dialog upon _destroy. Fixes #5935 – Dynamic Select empty when opening second time.

Non native menus: dialog size select title should match the label when changed after the dialog markup is added to the DOM (Issue #5956)
– Dialog: Render un-closeable during pagebeforehide. Fixes #5956.


Fieldcontain fieldset legend overflows in IE10 (Issue #6139)
– Controlgroup: Make legend wrap on IE10. Fixes #6139.


incorrect overflow handling selectmenu[multiple] inside fieldset (Issue #6077)
– Core CSS: Unset browser default min-width for fieldset. Fixes #6077.


Panel: Opening from anchor tag within listview does not remove active button class (Issue #5961)
– Panel: Make sure active button class is removed when link to panel is a listview button. Fixes #5961.


Slider widget does not work on Opera Mobile 12.10 browser with JQM version 1.3.1 (Issue #5903)
– Slider: On Opera Mobile event.which is undefined. Accept that and get slidin'. Fixes #5903.


loadPage Cannot read property ‘prefetch’ of undefined (Issue #5877)
– Prefetch: Check for existance of options object before checking prefetch property Fixes #5877 – loadPage Cannot read property 'prefetch' of undefined and addresses execption from #5951

Navigating back is broken with autoInitializePage = false (Cannot call method ‘trigger’ of undefined) (Issue #5284)
– resolve the nav ready deferred after the page container has been created Fixes #5284


Popup button missing role attribute / aria-owns missing “-popup” postfix (Issue #6117)
– Links: ID refs without hashtag for aria-owns attribute of links to popups. Fixes #6117.

The “popup” data rel attribute should be mapped to the respective ARIA attributes (Issue #5898)
– Links: Append popup accessibility attributes. Fixes #5898.

links.js needs to depend on core, because it uses .jqmEnhanceable() and the :jqmData() pseudoselector defined in core.


Split button list: Buttons not showing in IE7 (1.3 regression) (Issue #6002)
– Theme: Use shorthand for background color fallback to make it work on IE7. Fixes #6002.

Demo center

Label didn't match example.

Added note to the PHP redirect demo that says it only works on a server.

Update example CSS for “Making the panel responsive” (Issue #5889)
– Demos: Updated comment above example CSS for clarification. Fixes #5889.

Bug in documentation example “Making the panel responsive” (Issue #5936)
– Demos: Updated responsive panels CSS example. Fixes #5936.

Popup: Removed weird (and almost certainly accidental) popup-inside-popup embedding.


Popup integration tests: Add test to make sure popup elements do not have focus after the popup is closed. Tests #5974.

Custom select integration tests: Ensure dialog is removed after destroying dialog-sized select menu.