View Full Version : Documentation/Manual/Tutorial for new-to-GXT users?

31 Oct 2011, 12:31 PM
Well, as you can tell from the barrage of questions in a short time frame, I'm new to GWT.

We're starting to do an evaluation. I've seen some of the Samples/Demos, but the source provided is GXT 2.x code, some of which is not applicable to GXT 3.x

Given that I (and anyone in my organization) will be completely new to GXT, I'd like references that will not, shall we say, "contaminate" my knowledge with 2.x-specific information.

The JavaDoc API that came with the download is extremely sparse in terms of explanation of methods/classes.

The blog entry for 3.0 makes mention of a manual that will be available.

Is there anything so far, even if not yet complete?

A manual? Tutorials for beginners who will be starting with GXT 3.0? Will the JavaDoc API be fleshed out, or is it starting to be filled out currently?

Thanks! Any help would be definitely appreciated. I'm trying to learn from basically square one, and would like to keep my stumbling to a minimum.

31 Oct 2011, 12:51 PM
This is just my personal opinion. A developer preview is not good for learning an API. The API is not stable and you should still expect changes. For evaluating GXT 3 you should wait definitely until GXT 3 reaches a beta state.

We are still working on creating more javadocs and also the manual. You should expect much better javadocs once in the beta and rc cycles.

5 Jan 2013, 6:01 AM
It's 2013 and I still don't see any manual. Is it available now?

7 Feb 2013, 8:49 AM
The most recent introduction documents I found (2/2013) are from GXT 2.x, and they are incompatible with 3.x right off the bat.
In my evaluation work comparing various AJAX frameworks this will score pretty low... /:)

Colin Alworth
7 Feb 2013, 1:28 PM
While there are requests here and there for a 'getting started', for the most part, the same rules that describe creating and manipulating widgets. As of GXT 3 (and especially with GWT 2.5), UiBinder works exactly the same with GXT widgets as with GWT widgets - other supported features include the Cell API and the GWT Editor framework - any existing documentation that applies to them also applies to GXT.

Javadocs should be much more complete than in 2011 when this thread was started, and the examples at http://sencha.com/examples are much more fleshed out.

The basic process for setting up a GXT project is pretty straight-forward: set up a GWT project in your IDE of choice, download GXT and follow the instructions in setup.txt. This is 4 main steps - add the jar to your classpath, add an inherits statement to your module, ensure you are using a strict doctype, and add a reference to reset.css to your html page.

Are you looking for hello world examples, or specific tutorials?

11 Feb 2013, 12:06 PM
Yes while the widget examples are nice, what is lacking is an example putting it all together in a non-trivial example app. As it stands now the cheesey StockWatcher example provided on the GWT site is superior to anything available now for GXT as a getting started guide.

20 Feb 2013, 12:16 AM
I can only confirm what the thread creator stated - it is more or less extremely hard to get into GXT with the given tutorials, especially since GXT3.x breaks most of them. While the user interface part is slightly better documented, what's totally missing is the backend connection - how to deal with services, paging, filtering, etc. A "best practices" would be great. I had a look into the examples' source code, but that's just showing you how it is done, but not WHY it is done.

20 Feb 2013, 4:01 AM
The things you are requesting are not really related to GXT.

Things like loading data, using the editor framework, mvp, etc. are more related to GWT then to GXT (as Colin already mentioned). You can use GWT RPC and MVP as described and put your GXT widgets in the view.

Viel Spass ;-)

20 Feb 2013, 4:32 AM
i'm referring to using GXT-specific classes for pagination, filtering and sorting with RPC services. the documentation for these is non-existing, even though GXT is awesome in every other way.

1 Mar 2013, 9:00 AM
@gwieser (http://www.sencha.com/forum/member.php?555161-gwieser) Great idea. I'll see about helping provide some more examples regarding RPC pagination, sort and filtering.