Since today the latest Version 3.2.0 of Struts2 jQuery Plugin is available. The main change is the switch from jQuery 1.5.2 to the latest version 1.6.4 of the jQuery 1.6.x releases. You can now benefit from all the improvements and performance optimizations from the jQuery 1.6.x versions.

If you are using third party jQuery plugins, be sure the are working well with this jQuery version.

Except the library updates there are over 20 solved Issues with this release. Especially the Datepicker, the Dialog and the Tree Tag are improved.

Library Updates

• jQuery 1.6.4
• jQuery UI 1.8.16
• jQuery Mobile RC 2
• jqGrid 4.2.0
• ckEditor 3.6.2

For a complete list of changes since last version, please visit the Changelog.

Download: http://code.google.com/p/struts2-jquery/downloads/list
Showcase: http://www.weinfreund.de/struts2-jquery-showcase/
Issues: http://code.google.com/p/struts2-jquery/issues/list
User Group: http://groups.google.com/group/struts2-jquery

The new Version 3.1.0 of Struts2 jQuery Plugin is now available with an improved Tree and Autocompleter Tag and a new Timepicker Addon for the Datepicker Tag.

A improved Tree Tag

The Tree Tag provides now support for different Node Types and support for Context Menus. Two new Tree Tag examples in the Showcase explain how to use this new Features.

<s:set id="contextPath"  value="#request.get('javax.servlet.forward.context_path')" />
<sjt:tree 
	id="treeTypes" 
	jstreetheme="default" 
	openAllOnLoad="true" 
	types="{
			'valid_children' : [ 'root' ],
			'types' : {
				'root' : {
					'icon' : { 
						'image' : '%{contextPath}/images/root.png' 
					},
					'valid_children' : [ 'folder', 'file' ],
				},
				'folder' : {
					'icon' : { 
						'image' : '%{contextPath}/images/folder.png' 
					},
					'valid_children' : [ 'folder', 'file' ],
				},
				'file' : {
					'icon' : { 
						'image' : '%{contextPath}/images/file.png' 
					},
					'valid_children' : [ 'none' ],
				}
		}
	}">
	<sjt:treeItem title="Root" type="root">
		<sjt:treeItem title="Folder One"  type="folder">
			<sjt:treeItem title="File One" type="file"/>
			<sjt:treeItem title="File Two" type="file"/>
		</sjt:treeItem>
		<sjt:treeItem title="Folder Two"  type="folder">
			<sjt:treeItem title="Folder Three"  type="folder">
				<sjt:treeItem title="File Four" type="file"/>
			</sjt:treeItem>
			<sjt:treeItem title="File Three" type="file"/>
		</sjt:treeItem>
	</sjt:treeItem>
</sjt:tree>

Timepicker

An other offen requested feature the Timepicker is now available. This is an enhancment of the existing Datepicker Tag.

<sj:datepicker 
	id="time0" 
	label="Select a Date/Time" 
	value="%{new java.util.Date()}" 
	timepicker="true" 
/>
<sj:datepicker 
	id="time1" 
	label="Select a Time" 
	value="%{new java.util.Date()}" 
	timepicker="true" 
	timepickerOnly="true"
/>

A improved Autocompleter Tag

It is now possible to display the List Value instead of the List Key. See Issue 395 for detailed informations. Also you can now specify a List Label which is displayed during the search.

Libary Updates

• jQuery UI 1.8.14
• jQuery Mobile Beta 1
• jqGrid 4.1.1
• ckEditor 3.6.1
• tinyMCE 3.4.3.1

For a complete list of changes since last version, please visit the Changelog.

Download: http://code.google.com/p/struts2-jquery/downloads/list
Showcase: http://www.weinfreund.de/struts2-jquery-showcase/
Issues: http://code.google.com/p/struts2-jquery/issues/list
User Group: http://groups.google.com/group/struts2-jquery

Step1: Install and Configure Maven

We use Maven to describe this software project and to manage the dependencies.

1.) Download maven from http://maven.apache.org/download.html and extract it.

2.) Add MAVEN_HOME/bin to your PATH

Step2: Create your Struts2 Project

1.) Switch to your Eclipse Workspace.

cd workspace

2.) Create the Project based on the struts2-archetype-convention archetype.

mvn archetype:generate -B -DgroupId=com.jgeppert.examples -DartifactId=struts2-example -DarchetypeGroupId=org.apache.struts -DarchetypeArtifactId=struts2-archetype-convention -DarchetypeVersion=2.2.3

3.) Wait until maven download the whole Internet except Cats Pictures and Porn.

4.) Go into the new created folder struts2-example

cd struts2-example

5.) Open pom.xml in an Editor

6.) Set your project version to 0.0.1

    <version>0.0.1</version>

7.) Set your Struts2 Version to 2.3.1.2

    <properties>
        <struts2.version>2.3.1.2</struts2.version>
    </properties>

8.) Build your blank application

mvn install

9.) Try it out

mvn jetty:run

10.) Open http://localhost:8080/struts2-example/ in your Browser

The Message "Struts is up and running..." should appear.

Step3: Create the Eclipse Project

1.) Open your Eclipse IDE

2.) Install m2-eclipse and restart your IDE.

3.) Open the Import Dialog in your Eclipse IDE and import your created Project "struts2-example".

Step4: Add the Struts2 jQuery Plugin to your Project

The Struts2 jQuery Plugin provides an easy Integration of jQuery into this Project.

1.) Open your pom.xml and edit your project properties.

    <properties>
        <struts2.version>2.3.1.2</struts2.version>
        <struts2jquery.version>3.2.1</struts2jquery.version>
    </properties>

2.) Add the Dependencies

	<dependency>
		<groupId>com.jgeppert.struts2.jquery</groupId>
		<artifactId>struts2-jquery-plugin</artifactId>
		<version>${struts2jquery.version}</version>
	</dependency>

3.) Create a new Action YourNameAction.java inside of the com.jgeppert.examples.actions Package

package com.jgeppert.examples.actions;
 
import com.opensymphony.xwork2.ActionSupport;
 
public class YourNameAction extends ActionSupport {
 
    private String name;
 
    public String execute() throws Exception {
	if(name == null || name.length() < 3){
	    addActionError("Please enter valid name with more the 2 characters!");
	    return ERROR;
	}
 
        return SUCCESS;
    }
 
    public String getName() {
        return name;
    }
 
 
    public void setName(String name) {
        this.name = name;
    }
}

4.) Replace the Content of hello.jsp

<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<%@ taglib prefix="sj" uri="/struts-jquery-tags"%>
<html>
<head>
    <title>My App</title>
    <sj:head jquerytheme="start"/>
    <style>
    	body {
    		font-family: Arial,sans-serif;
    		font-size: 9pt;
    	}
    </style>
</head>
 
<body>
	<h2>Please enter a Name</h2>
 
	<s:form action="your-name" theme="xhtml">
		<s:textfield name="name" label="Enter your Name"/>
		<sj:submit 
			targets="result" 
			effect="highlight" 
			value="Submit" 
			button="true"
		/>
	</s:form>
 
	<h3>AJAX Result</h3>
	<div id="result"></div>
</body>
</html>

5.) Create a new JSP inside of your WEB-INF/content folder called your-name.jsp

<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<h4>Welcome <s:property value="name"/>!</h4>

6.) Create a new JSP inside of your WEB-INF/content folder called your-name-error.jsp

<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<s:actionerror theme="jquery"/>

7.) Run "mvn install" and "mvn jetty:run"

8.) Open http://localhost:8080/struts2-example/ in your Browser and our created form should be appear.

9.) Submit without enter a Name. The Error Message should be visible inside of our defined Target Div without reloading the whole Page.

10.) Submit you form with an valid name.

Download the Sample Project Sources.

I'am happy to inform you that Version 3.0.0 of Struts2 jQuery Plugin is now available with a lot of new features an improvments.

A new Tree Tag

With this version there is an offen requested feature available. The new Tree Tag allows you to create easy Trees in your templates. This Tree Tag is based on the great jQuery jsTree Plugin.

<sjt:tree id="treeStatic" jstreetheme="default">
	<sjt:treeItem title="Struts2">
		<sjt:treeItem title="General">
			<sjt:treeItem title="Struts2" href="http://struts.apache.org/2.x/index.html"/>
			<sjt:treeItem title="Struts2 @ Facebook" href="http://www.facebook.com/pages/Struts2-Users/103890046351798"/>
		</sjt:treeItem>
		<sjt:treeItem title="Plugins">
			<sjt:treeItem title="Struts2 Plugins" href="https://cwiki.apache.org/S2PLUGINS/home.html"/>
			<sjt:treeItem title="Struts2 jQuery Plugin" href="http://code.google.com/p/struts2-jquery/"/>
			<sjt:treeItem title="Struts2 Full Hibernate Plugin" href="http://code.google.com/p/full-hibernate-plugin-for-struts2/"/>
		</sjt:treeItem>
		<sjt:treeItem title="Blogs">
			<sjt:treeItem title="Struts2 jQuery News" href="http://www.jgeppert.com/category/java/struts2-jquery/"/>
		</sjt:treeItem>
		<sjt:treeItem title="AJAX Links">
			<s:url id="ajax1" value="/ajax1.action"/>
			<sjt:treeItem title="Ajax 1" href="%{ajax1}" targets="result"/>
			<s:url id="ajax2" value="/ajax2.action"/>
			<sjt:treeItem title="Ajax 2" href="%{ajax2}" targets="result" effect="highlight" effectDuration="2500"/>
			<s:url id="ajax3" value="/ajax3.action"/>
			<sjt:treeItem title="Ajax 3" href="%{ajax3}" targets="result" onBeforeTopics="beforeLink" onCompleteTopics="completeLink"/>
			<s:url id="ajax4" value="/ajax4.action"/>
			<sjt:treeItem title="Ajax 4" href="%{ajax4}" targets="result" effect="bounce" effectDuration="1000"/>
		</sjt:treeItem>
	</sjt:treeItem>
</sjt:tree>

Mobile Module

For an better support of mobile development with Java and the popular MVC Framework Struts2, this version of Struts2 jQuery Plugin brings a new Module based on jQuery mobile to you. This includes an easy AJAX support and a jQuery mobile theme for form elements. The new Struts2 jQuery Mobile Showcase gives you an introduction how to use this new module.

Grid Module

This version provides an enhanced Subgrid Feature. Now it is possible to create Multilevel Subgrids. Please take a look at the new 3-Level Subgrid Example in the Grid Showcase.  

Richtext Editor

With this version it is easy to enable Uploads for Images and Flash files for your Ckeditor instance.

Enable File Uploads in your struts2.xml:

<!-- Settings for CKEditor Image Upload -->
<constant name="struts.ckeditor.allowUploads" value="true" /> <!-- default is false -->
<constant name="struts.ckeditor.allowedFileExtensions" value="jpg,jpeg,png" />
<constant name="struts.ckeditor.uploadFolder" value="/image-uploads" />

Enable File Uploads in your ckeditor instance:

<sjr:ckeditor 
	id="richtextEditor" 
	name="echo" 
	rows="10" 
	cols="80" 
	width="730"
	height="400"
	uploads="true"
/>

Libary Updates

• jQuery 1.5.2
• jQuery UI 1.8.12
• jQuery Mobile Aplpha 4.1
• jqGrid 4.0.0
• flot 0.7
• ckEditor 3.5.3
• tinyMCE 3.4.2

For a complete list of changes since last version, please visit the Changelog.

Download: http://code.google.com/p/struts2-jquery/downloads/list
Showcase: http://www.weinfreund.de/struts2-jquery-showcase/
Issues: http://code.google.com/p/struts2-jquery/issues/list
User Group: http://groups.google.com/group/struts2-jquery

• Upgrade to jQuery UI 1.8.2
• Upgrade to jqGrid 3.6.5
• Solve  Issue 154 : load from google cdn does not work for jquery ui themes
• Solve Issue 155: Default Loading Text
• Solve Issue 156: onSelectAll topics
• Solve  Issue 157 : useSelectedTabCookies in tabbedpanel broken in 2.1.0
• Solve  Issue 161 : Select options vanish when re-entering the page
• Solve  Issue 170 : Struts2-jquery-plugin not recognizing tag in jsp page
• Solve  Issue 171 : sj:accordion autoHeight does not work
• Solve  Issue 176 : Autcompleter input textfield width should be configurable
• Solve Issue 179: Nested tab didn't work
• Solve Issue 184: loadingText doesn't appear to have any effect with jqgrid plugin
• Solve Issue 185: attributes hidegrid, hoverrows and shrinkToFit in grid tag can not be set to false
• Solve Issue 186: how to submit a form while loading grid?
• Solve Issue 188: Some locales does not work, particularly "fr"
• Solve Issue 190: Add Head Tag attribute 'compatibility' for an jQuery 1.3 compatibility mode
• Solve Issue 191: deferred loading of dynamic elements
• Solve Issue 192: Default Error Text
• Solve Issue 193: Using base tag with sj:a causes page to reload

• Upgrade to jQuery UI 1.8.1
• Head Tag attribute jqueryui is now true by default
• various new examples in the showcase
• The grid showcase is now a maven modul and part of the release cycle
• Solve  Issue 77 : Grid Sample not working properly in IE
• Solve  Issue 94 : customBasepath doesn't affect the .js path
• Solve  Issue 113 : Load needed JavaScript? and CSS resources on demand
• Solve  Issue 114 : Support for new replaceTarget Option in form plugin
• Solve  Issue 115 : Grid with locale code ca(catalan) doesn't work. jQuery and grid difers at the name of the catalan locale(ca-cat)
• Solve  Issue 116 : pepper-grinder theme
• Solve  Issue 123 : Implement an debug mode
• Solve  Issue 124 : Make it possible to easy extend this plugin for custome extensions
• Solve  Issue 125 : Dialog cannot set position with array of String or Pixel
• Solve  Issue 126 : drag and drop grid rows
• Solve  Issue 127 : onChangeTopics not working for textarea and textfield.
• Solve  Issue 128 : onChangeTopics with <sj:checkboxlist>
• Solve  Issue 130 : Add Showcase Example how to extend the plugin with custome functions
• Solve  Issue 131 : Add a Richtext Editor Widget to the plugin
• Solve  Issue 132 : Scrolling does not work properly
• Solve  Issue 134 : Move Grid Feature in seperate struts2-jquery-grid-plugin
• Solve  Issue 135 : Enable Maven Support for Grid Showcase
• Solve  Issue 138 : Upgrade to jQuery UI 1.8.1
• Solve  Issue 139 : attribute parentTheme does not work well with css_xhtml theme
• Solve  Issue 141 : Override the param names
• Solve  Issue 146 : <sj:dialog> makes multiple AJAX calls
• Solve Issue 148: Sortable grid option not working

• Upgrade to jQuery 1.4.2 ( Issue 91 )
• Upgrade to jQuery UI 1.8.0
• Upgrade to jqGrid 3.6.4
• Upgrade to jQuery Form Plugin 2.43
• Implement an Autocompleter ( Issue 10 )
• Implement an Radiomap as jQuery UI Buttonset
• Implement an CheckboxList as jQuery UI Buttonset
• Support for Form Validation
• Support for new jQuery UI Button Widget
• Include all offical jQuery UI Themes
• New Showcase Example how to handle JSON Results
• New Showcase Example how to build accordion manually
• New Showcase Examples for Autocompleter
• New Showcase Examples for AJAX Client Form Validation
• Complete  Issue 102 : Enable Sonatype Nexus OSS repository deployment for Maven central repository sync
• Complete  Issue 104 : Move source to a Maven multi module setup
• Fix Issue 65: Build accordion manually
• Fix Issue 80: Add Size Parameter for select tag
• Fix Issue 84: JavaScript Error when parent form has no id
• Fix Issue 86: onRowSelectTopcs only published when editurl is used
• Fix  Issue 88 : <s:url> + formId in <sj:div> bug with first form field
• Fix  Issue 89 : <sj:submit> do not notify topics
• Fix  Issue 90 : <sj:submit> with "onBeforeTopics" without ajax submit
• Fix Issue 95: datepicker locale should use the struts current locale
• Fix Issue 97: FormFilter Attribute on SubmitTag
• Fix Issue 98: onAlwaysTopics but in sj:submit and sj:a
• Fix Issue 106: "Multiple" attribute in sj:select tag
• Fix Issue 107: value attribute in select tag has no effect
• Fix Issue 108: how to set #sjdialog with query string dynamically
• Fix Issue 112: add attributes for alternate rows in the grid tag

• Enable Subgrid Feature for Grid Tag
• New Grid Showcase together with Full Hibernate Plugin for Struts2
• Upgrade jQuery BBQ to 1.1
• New Velocity Example in Showcase
• Fix  Issue 45 : AJAX form submission with href parameters
• Fix  Issue 50 : gridModel parameter is compulsory, but not used
• Fix  Issue 51 : url parameters escaped
• Fix  Issue 53 : Meaningless viewrecords information
• Fix  Issue 58 : New Attribute formoptions for GridColumn Tag
• Fix  Issue 59 : tabbedpanel spinner cannot be disabled using empty string value
• Fix  Issue 60 : Distorted Divs in Local Tabs
• Fix  Issue 63 : Submit is not working in Velocity

• Unterstützung des jQuery Grid Plugin
• Unterstützung für Listen Topics
• Mehr Topics für das Dialog Widget
• Neues Besipiel für ein Ajax basierendes Doubleselect im Showcase
• Implementierungen der Issues 25, 27, 30, 31, 32, 33, 34, 36, 38, 39

• Eine History Technik für Ajax Content und Tabs basierend auf jQuery BBQ Plugin
• Ein Standard Indicator ist im Head Tag definierbar
• Generierte HTML Tags verzichten auf extra Attribute (Besser Kompatibilität mit XHMTL)
• Mehrere kleine Erweiterungen und Fehlerbehebungen

• AJAX Textarea and Textfield
• AJAX Select Box (mit Struts2 JSON Plugin)
• Support for Topics

• Der jQuery Slider wird als neues Widget unterstützt
• Die Interactions Sortable und Selectable können durch Effect Div und dem Remote Div genutzt werden.
• Erweiterter Datepicker (siehe Showcase)
• Überarbeiteter AJAX Aufruf für bessere Event Unterstützung

• Die jQuery Progressbar
• Drag & Drop mit dem Effect Div und dem Remote Div
• Resizeable für Effect Div und dem Remote Div
• Google als CDN für jQuery Bibliothek auswählbar
• Erweiterungen des Showcases
• Unterstützung für Freemarker

• Accordion - Das jQuery Accordion aus einer Liste generieren oder den Content via AJAX laden.
• Dialog - Der jQuery Dialog ebenfalls mit möglicher AJAX Funktionalität.
• EffectDiv - ein Div mit Effekten rendern.

• AJAX
  • Remote Link
  • Remote DIV
  • AJAX Form
  • Effekte
• Widgets
  • Tabs mit lokalem und AJAX Inhalt
  • Datepicker
• Themes
  • 5 verschieden Themes
  • einfache Integration von eigenen Themes