|
|
GettingStarted
Getting started with gwt-dnd in your own application.
GWT Version Compatibility Matrix
| If you are using GWT version... | Then use gwt-dnd version... |
| GWT 1.5.0 (1.5 RC1) | gwt-dnd-2.5.2.jar |
| GWT 1.5M2 (1.5 Milestone 2) | Do not use GWT1.5M2 as it does not work with gwt-dnd. |
| GWT 1.4.62 (1.4 Update 2) | gwt-dnd-2.0.7.jar † |
| GWT 1.4.61 (1.4 Update) | gwt-dnd-2.0.7.jar † |
| GWT 1.4.60 (1.4) | gwt-dnd-2.0.7.jar † |
| GWT 1.4.59 (1.4 RC2) | gwt-dragdrop-1.2.6.jar ‡ |
| GWT 1.4.10 (1.4 RC1) | gwt-dragdrop-1.1.jar ‡ |
| GWT 1.3.3 | gwt1.3.3-dragdrop-2007-11-02.jar ‡ |
† Existing projects may continue to use the gwt-dnd 1.x API, while new projects should always start with the gwt-dnd 2.x API
‡ If you can, please upgrade to the latest GWT and gwt-dnd release
Important GWT Bugs/Issues
| GWT version | GWT Issue | Related gwt-dnd issue | Comments |
| SVN trunk | - | - | - |
| 1.4 | GWT issue 1583 Arrays.sort(Object[]) and Collections.sort(Object[]) are not stable | gwt-dnd issue 19 Problem with overlapping drop targets in web mode | When a draggable widget is dropped in an area where multiple drop targets (partially) overlap, the drop target that is selected is determined by the order in which the drop controllers were originally registered in hosted mode, but may be inconsistent in web mode. |
| 1.3.3 | (multiple) | - | See the 'Minor Issues to Consider for GWT 1.3.3' section in Getting Started with 1.x wiki. |
| - | - | gwt-dnd issue 26 | There are multiple reports of IE6 crashing when images are being dragged, either directly, or part of another panel. It appears that image bundles, or at least large images or bundles are a factor. Try dragging smaller (or unbundled) images if you see problems in IE6. And, please report general findings on the gwt-dnd group, and any specific information on gwt-dnd issue 26. |
| - | GWT issue 1953 | - | Beware of absolute panels attached to absolute panels. |
| - | GWT Issue 1813 | - | RootPanel.get(id) fails to set 'position:relative' and 'overflow:hidden' |
Adding the gwt-dnd Module to your Eclipse Project
| gwt-dnd API version | Instructions | Comments |
| gwt-dnd 1.x | GettingStartedWith1_x | Most projects should use this latest stable API. |
| gwt-dnd 2.x | GettingStartedWith2_x | Leading edge projects, and those requiring the ability to drag multiple widgets at once should use the new API. |
Tips
- While the Eclipse IDE is not strictly necessary, having a good IDE such as Eclispe will make your life a lot easier. Certainly feel free to use your IDE of choice.
- Consider developing in quirks mode until GWT fully supports standard (strict) mode. See GWT Issue 1305. To compare options, start here: http://www.quirksmode.org/css/quirksmode.html.
- Make sure you use an UncaughtExceptionHandler so that unexpected exceptions are not lost in web mode
- Realize that hosted mode is slower than (compiled-to-JavaScript) web mode. So, if things feels sluggish, try web mode to reassure yourself.
Sign in to add a comment