GWT library for jQuery Mobile
Java CSS JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
examples JQMDataTable minor fixes Nov 15, 2016
library Minor optimization for event handlers. Jan 18, 2017
plugins
remote Next development iteration 1.5.0-SNAPSHOT Oct 28, 2016
standalone Next development iteration 1.5.0-SNAPSHOT Oct 28, 2016
.gitignore updated Oct 27, 2016
.travis.yml
GAE_examples_update.txt
README.md updated docs for 1.4.7 Oct 28, 2016
jqm4gwt-18x18.png project icon added. Apr 28, 2015
jqm4gwt-24x24.png
license.txt
pom.xml Next development iteration 1.5.0-SNAPSHOT Oct 28, 2016

README.md

alt tag jqm4gwt Build Status

jqm4gwt is an advanced wrapper over the jQuery Mobile framework, which transforms it into 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 jQuery Mobile 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. jQuery Mobile 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.7 released 27-Oct-2016

Dependencies are available from Maven Central:

<dependency>
  <groupId>com.sksamuel.jqm4gwt</groupId>
  <artifactId>jqm4gwt-remote</artifactId>
  <version>1.4.7</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.