jqm4gwt

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] (https://github.com/jqm4gwt/jqm4gwt/wiki/Frequently-Asked-Questions).

Please contribute with pull requests! See the [Contributors Guidelines] (https://github.com/jqm4gwt/jqm4gwt/wiki/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

[jqm4gwt Remote Module] (http://search.maven.org/remotecontent?filepath=com/sksamuel/jqm4gwt/jqm4gwt-remote/1.4.7/jqm4gwt-remote-1.4.7.jar)
[jqm4gwt Library Module] (http://search.maven.org/remotecontent?filepath=com/sksamuel/jqm4gwt/jqm4gwt-library/1.4.7/jqm4gwt-library-1.4.7.jar)
[Remote Sources] (http://search.maven.org/remotecontent?filepath=com/sksamuel/jqm4gwt/jqm4gwt-remote/1.4.7/jqm4gwt-remote-1.4.7-sources.jar)
[Library Sources] (http://search.maven.org/remotecontent?filepath=com/sksamuel/jqm4gwt/jqm4gwt-library/1.4.7/jqm4gwt-library-1.4.7-sources.jar)

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

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.

jqm4gwt / jqm4gwt