Wiki source code of ERJQuery

Last modified by Ravi Mendis on 2010/11/30 05:16

Show last authors
1 == What is ERJQuery? ==
2
3 ERJQuery is an alternative, //pseudo-stateless// Ajax framework for WebObjects applications.
4 It's is a [[jQuery>>url:http://jquery.com/||shape="rect"]] version of [[doc:documentation.Home.Frameworks.ERPrototaculous.WebHome]].
5 ERJQuery and [[doc:documentation.Home.Frameworks.ERPrototaculous.WebHome]] are mutually exclusive frameworks. In other words, you may only use one or the other.
6
7 Features include:
8
9 * 'Organic' support for [[jQuery>>url:http://jquery.com/||shape="rect"]] in WebObjects.
10 ** Light-weight dynamic elements to support jQuery
11 ** Transparent API that doesn't hide or abstract jQuery
12 ** Sans patches or extensions to jQuery
13 * Use of [[Unobtrusive Javascript>>url:http://en.wikipedia.org/wiki/Unobtrusive_JavaScript||shape="rect"]].
14 * Pseudo-stateless ajax responses
15 * A set of jQuery widgets.
16
17 Ajax actions and update containers are handled just like [[doc:documentation.Home.Frameworks.ERPrototaculous.WebHome]] except they use jQuery instead of Prototype and Scriptaculous.
18
19 ==== Unobtrusive JavaScript in ERJQuery ====
20
21 [[doc:WO.Using Unobtrusive JavaScript]]
22
23 {{include/}}
24
25 {{code}}
26
27 er.jquery.useUnobtrusively = true
28
29 {{/code}}
30
31 ==== jQuery WebObjects Elements ====
32
33 //jQuery.get()// has been implemented as a WebObjects dynamic element. Currently support for [[jQuery.get()>>url:http://api.jquery.com/jQuery.get/||shape="rect"]] and [[.load()>>url:http://api.jquery.com/load/||shape="rect"]] is limited to the following:
34
35 ===== jQuery.get() =====
36
37 * jQueryGetLink
38
39 ===== jQuery.load() =====
40
41 * jQueryLoadLink
42
43 ==== jQuery Widgets ====
44
45 (% class="alternate" %)
46 * [[FileUpload>>url:http://valums.com/ajax-upload/||shape="rect"]]
47 * [[Video Player>>url:http://www.longtailvideo.com/players/jw-flv-player||shape="rect"]]
48 * [[Tweet Button>>url:http://twitter.com/about/resources/tweetbutton||shape="rect"]]
49
50 Support for the file upload widget has been implemented as an input and as a CSS style-able container.
51
52 = Embrace Statelessness! =
53
54 [[doc:WO.Embrace Statelessness]]
55
56 {{include/}}
57
58 ERJQuery embraces the stateless model Ajax offers in exchange for simplifying the work WebObjects has to do - it's a win-win!
59
60 So you may observe one notable difference between ERJQuery and the Ajax framework is in the way it handles ajax responses.
61 In ERJQuery, updates and actions break with standard WebObjects behaviour by being pseudo-stateless just like [[doc:documentation.Home.Frameworks.ERPrototaculous.WebHome]].
62
63 == Compatibility ==
64
65 ERJQuery can not be used with WebObjects 5.3 as it is dependent on the hooks for ajax added to WebObjects with version 5.4.
66
67 {{warning title="ERJQuery is WebObjects *5.4* compatible only"/}}
68
69 == External Links ==
70
71 WOWODC '10 (Slides) - [[DirectToWeb 2.0>>url:http://www.wocommunity.org/wowodc10/slides/D2W2.pdf||shape="rect"]]