Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
GWT library for jQuery Mobile
Java CSS JavaScript
branch: master

This branch is 84 commits behind jqm4gwt:master

README.md

jqm4gwt Build Status

JQuery Mobile wrapper for GWT is a project that wraps the JQuery Mobile framework into a gwt widget library that can be used in a GWT application. This allows GWT developers to develop mobile web apps with and leverage the vibrant jQuery Mobile widgets community without having to hand code javascript. In addition, projects that currently leverage GWT can add a mobile channel with ease.

Note that because this project is a wrapper into Java, you do not have to invoke javascript native methods, nor do you have to pass inline javascript to generic methods. You create widgets exactly as you do in the normal GWT widgetset. In fact you don't have to have any understanding of how jquery mobile works behind the scenes (although of course it helps if you do).

A quick example to create a jquery mobile enhanced button is:

JQMButton button = new JQMButton("Click me");

or the same as UiBinder template:

<ui:UiBinder xmlns:b="urn:import:com.sksamuel.jqm4gwt.button">
<b:JQMButton text="Click me" />

The project mirrors the release cycle of JQuery Mobile. That is, when version x.y is released of JQM we try to then release version x.y of jqm4gwt to match. Bug fixes in our code are released as x.y.z.

There is full support for GWT's UiBinder, and a self-contained version of the module providing all of the dependent JQueryMobile JavaScript, CSS, and images.

Jqm4gwt also provides a useful form framework that enables rapid prototyping of form pages, including ajax submission and validation. See http://code.google.com/p/jqm4gwt/wiki/FormFramework

For more information, see the Frequently Asked Questions.

Please contribute with pull requests! See the Contributors Guidelines to assure the health of the project.

Examples

Examples and demos are hosted on a google app engine instance

These include the typical hello world and a show case of JQuery Mobile widgets and events.

What's Supported

The full JQuery Mobile widget set is supported. That is pages, dialogs, popups, buttons, form elements, list boxes, navigation, etc. Jqm4gwt goes further and supports standard GWT MVP constructs (Activities, Places, etc) and mixes that with the JQuery Mobile navigation system seemlessly. JQueryMobile is exposed to GWT users via both a simple Fluent-style API and via GWT's UiBinder.

Getting Started

Read the quick start guide. You will need to be familiar with GWT already.

Getting It

Latest Release: 1.4.3.Final released 28-July-2014

Dependencies are available from Maven Central:

<dependency>
  <groupId>com.sksamuel.jqm4gwt</groupId>
  <artifactId>jqm4gwt-remote</artifactId>
  <version>1.4.3.Final</version>
</dependency>

Spread the word and join the conversation!

If you like jqm4gwt then cheer on ohloh ohloh logo

Want to talk about it? Join the discussion group for jqm4gwt on Google Groups.

Related Projects

If you are looking for a GWT wrapper for the desktop jQuery UI then gwtquery-ui or koobe/gwtquery-ui is where to look. For a GWT wrapper of JQuery then gwtquery is where to go.

License

This software is licensed under the Apache 2 license, quoted below.

Copyright 2014 Stephen Samuel

Licensed under the Apache License, Version 2.0 (the "License"); you may not
use this file except in compliance with the License. You may obtain a copy of
the License at

    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.
Something went wrong with that request. Please try again.