jqmobile-wp8-theme

My attempt to implement jQuery Mobile theme for Windows Phone 8

View the Project on GitHub sgrebnov/jqmobile-wp8-theme

Theme NuGet package for Visual Studio

NuGet Logo

Welcome

This theme provides a Windows Phone user interface for Apache Cordova apps using jQuery Mobile on Windows Phone 8.

Live demo

Web demo

Windows Phone 8 demo app

Copyrights

Licensed under the Apache License, Version 2.0 (the "License")

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

ChangeLog

April 2013. Added support of jQuery Mobile 1.3.

Components

jQM theme for Windows Phone

jQM theme for Windows Phone is presented by jquery.mobile.wp.theme.css file and related images folder.

/themes/wp/

Additional plugins

All additional theme plugins are located at /plugins folder

/plugins/app-bar/ - an Application Bar

/plugins/date-picker/ - Apache Cordova plugin for WP that exposes the native DateTime picker

/plugins/progress-bar/ - implements porgress bar control

/plugins/toggle-button/ - toggle button

** Each plugin folder contains sample page with usage example.

There is also special js code exporting theme switching functionality located at

/themes/themeswitcher/jquery.mobile.themeswitcher.js

Apache Cordova

The jQM theme for Windows Phone is designed to work with Apache Cordova on Windows Phone 8 for optimal integration. This is implemented by the following Apache Cordova plugins.

backButtonHandler.js - hardware back button handling functionality

dateTimePicker.js - js bridge for Apache Cordova native DateTimePicker

jquery.cordova.wp.themeswitcher.js - provides functionality to apply system colors (uses phoneTheme.js below)

phoneTheme.js - js bridge for Apache Cordova system colors detection plugin

Samples

Official demo for other developers.

/samples/jqm-public-demo/index.html

Windows Phone application based on Apache Cordova framework to demonstrate all theme functionality (system colors, native UI elements). Does not contain any html pages inside, it uses absolute reference to test pages (see next section) located remotly.

/samples/WindowsPhone8/jQMThemeForWindowsPhone

Test pages

jQuery Mobile gallery sample page (with some little modifications). Contains both html version and windows phone native application.

/tests/basic/gallery/

This sample page demonstrates all jQM theme for Windows Phone additional plugins/controls descibed above ('Additional plugins' section). Html only verison.

/tests/extra/all.html

Note. Pages above are used as a reference for Windows Phone demo application.

Prerequisite

The following componets are required

Usage

To run jqmobile demo

  1. Deploy to server the following directory (optional, you can run the demo from file system) /samples/jqm-public-demo/
  2. Navigate to (desktop or mobile browser) jqm-public-demo/index.html

To run gallery test pages

  1. Deploy to server the following directories (optional, you can run the demo from file system) /cordova /jqmobile-core /plugins /tests /themes
  2. Navigate to (desktop or mobile browser) /tests/basic/gallery/html/forms-all.html

To build Windows Phone demo app

  1. Open the following solution in Visual Studio 2012 or above /samples/WindowsPhone8/jQMThemeForWindowsPhone/jQMThemeForWindowsPhone.sln
  2. Update CordovaView.StartPageUri (MainPage.xaml) to reference to /tests/basic/gallery/html/forms-all.html located remotly.
  3. Build

Nuget packages for Visual Studio

jQMThemeForWindowsPhone8

This nuget package allows developers to apply a Windows Phone style look and feel to Windows Phone HTML5 applications developed with Apache Cordova and jQuery Mobile on Windows Phone 8.

To install jQMThemeForWindowsPhone8, run the following command in the Package Manager Console


Install-Package jQMThemeForWindowsPhone8

jQMThemeForWindowsPhone8Lite

This nuget package allows developers to apply a Windows Phone style look and feel to applications developed with 'Windows Phone HTML5 App' Visual Studio project template and jQuery Mobile on Windows Phone 8.

To install jQMThemeForWindowsPhone8Lite, run the following command in the Package Manager Console


Install-Package jQMThemeForWindowsPhone8Lite