Author: mschulte
Date: Tue Jul 17 11:33:02 2007
New Revision: 557010
URL: http://svn.apache.org/viewvc?view=rev&rev=557010
Log:
documented fix for TAPESTRY-1202
Modified:
tapestry/tapestry4/trunk/src/site/apt/ajax/eventlistener.apt
Modified: tapestry/tapestry4/trunk/src/site/apt/ajax/eventlistener.apt
URL:
http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/apt/ajax/eventlistener.apt?view=diff&rev=557010&r1=557009&r2=557010
==============================================================================
--- tapestry/tapestry4/trunk/src/site/apt/ajax/eventlistener.apt (original)
+++ tapestry/tapestry4/trunk/src/site/apt/ajax/eventlistener.apt Tue Jul 17
11:33:02 2007
@@ -114,6 +114,27 @@
....
+-----------------------------------------------------------------------
+** Accessing intercepted functions' parameters on the server-side
+
+ <<Note:>> This feature requires version 4.1.3.
+
+ When listening to a client-side javascript function that does not represent
a native
+ browser-event, you can access the parameters passed to the function on the
server-side.
+ The Parameters are made available as a JSON-Array within the class
+ {{{../apidocs/org/apache/tapestry/event/BrowserEvent.html}BrowserEvent}}.
+
+ So, given a javascript function "trigger" defined on component "triggerable"
which
+ was called like <<<triggerable.trigger(\{"theAnswer":42\}, ... )>>>, you may
get hold
+ of the answer like that:
+
++-----------------------------------------------------------------------
[EMAIL PROTECTED](events="trigger", targets="triggerable", elements="element")
+public void onTriggered( BrowserEvent event )
+{
+ doSomething(
event.getMethodArguments().getJSONObject(0).getInt("theAnswer") );
+}
++-----------------------------------------------------------------------
+
** Submitting forms when an event happens, and bypass client validation while
you're at it
The last example was good for showing how to listen to widget function
events, but what are you