Skip to Content

Wiki source code of ERPrototaculous

Version 265.1 by Ravi Mendis on 2009/07/17 01:19
Show last authors
1 == Introduction ==
2
3 ERPrototaculous was developed to provide the ajax functionality in ERDivaLook.
4
5 === What is ERPrototaculous? ===
6
7 Features include:
8
9 * 'Organic' support for Prototype and Scriptaculous in WebObjects.
10 ** Light-weight dynamic WebObjects elements to support Prototype
11 ** No custom patches to Prototype
12 ** Sans custom Prototype extensions
13 * Use of [[Unobtrusive Javascript>>http://en.wikipedia.org/wiki/Unobtrusive_JavaScript]].
14 * Pseudo-stateless ajax responses
15 * A set of widgets in the Prototype + Scriptaculous family.
16
17 ==== Unobtrusive Javascript in ERPrototaculous ====
18
19 Unobtrusive javascript is used in contrast to on-demand style of ajax programming.
20 By including Javascript as well as CSS globally in the page wrapper, CSS and/or Javascript doesn't have to load inside ajax requests.
21
22 The result is **faster** and more **reliable** ajax in WebObjects applications.
23
24 ==== Prototype WebObjects Elements ====
25
26 ##Ajax.Updater## and ##Ajax.Request## have been implemented as WebObjects dynamic elements.
27
28 ===== Ajax.Updater =====
29
30 Support for Prototype's [[Ajax.Updater>>http://www.prototypejs.org/api/ajax/updater]] is in the form of three components:
31
32 * AjaxUpdaterLink
33 * AjaxUpdaterButton
34 * AjaxUpdaterForm (with ##onsubmit## for ajax form submission)
35
36 These components will update a **container** on the page.
37
38 ===== Ajax.Request =====
39
40 Prototype's [[Ajax.Request>>http://www.prototypejs.org/api/ajax/request]] is in the form of:
41
42 * AjaxRequestLink
43 * AjaxRequestButton
44
45 These are used for strictly **background** ajax communication.
46
47 ==== Prototype + Scriptaculous Widgets ====
48
49 * Accordion
50 * LightWindow
51 * ModalBox
52 * CalendarDateSelect
53 * FileUpload
54
55 == Forms in ERPrototaculous ==
56
57 Differences from using forms in WebObjects. i.e ##WOForm##:
58
59 1. All form controls must be named. This includes text fields, selects and buttons.
60 (WebObjects dynamically assigned names are not compatible with ERPrototaculous).
61 1. All forms in an ERPrototaculous app are instances of ##AjaxUpdaterForm##.
62 1. Form submits can be the form of a:
63
64 *
65 ** Static ##<button>##.
66 ** WOSubmitButton (if the result is to update whole page/app).
67 ** AjaxUpdaterButton (to update a **container**). Or
68 ** AjaxRequestButton (for a **background** ajax request).
69
70 == Ajax Page Caching in ERPrototaculous ==
71
72 One notable difference in the ERPrototaculous and Ajax.framework is in the ajax responses.
73 ERPrototaculous updates and actions break with "The WebObjects Way" by being pseudo-stateless.
74
75 Instead of returning a fresh response, an ajax update or action is in fact the same instance.
76
77 The reason returning a fresh response is not necessary is because a client never travels back or forwards through an ajax application unlike in a typical WebObjects app.
78 Here the current state of the update or action is all that is necessary.