Wiki source code of ERJQuery
Last modified by Ravi Mendis on 2010/11/30 05:16
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 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"]] |