You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tapestry.apache.org by jk...@apache.org on 2006/07/26 23:41:31 UTC
svn commit: r425857 - in /tapestry/tapestry4/trunk/src/site:
apt/javascript/core.apt apt/javascript/form.apt xdoc/index.xml
Author: jkuhnert
Date: Wed Jul 26 14:41:30 2006
New Revision: 425857
URL: http://svn.apache.org/viewvc?rev=425857&view=rev
Log:
Added more documentation interconnections via links.
Modified:
tapestry/tapestry4/trunk/src/site/apt/javascript/core.apt
tapestry/tapestry4/trunk/src/site/apt/javascript/form.apt
tapestry/tapestry4/trunk/src/site/xdoc/index.xml
Modified: tapestry/tapestry4/trunk/src/site/apt/javascript/core.apt
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/apt/javascript/core.apt?rev=425857&r1=425856&r2=425857&view=diff
==============================================================================
--- tapestry/tapestry4/trunk/src/site/apt/javascript/core.apt (original)
+++ tapestry/tapestry4/trunk/src/site/apt/javascript/core.apt Wed Jul 26 14:41:30 2006
@@ -52,14 +52,6 @@
tapestry.bind(url, content);
+-----------------------------------
-+-------------------------
-<script type="text/javascript">
- dojo.require("tapestry.form");
-
- tapestry.form.submit(dojo.byId("myform"));
-</script>
-+-------------------------
-
* tapestry.error(type, exception, http, kwArgs)
Global error handling function for dojo.io.bind requests. This function is used by all of the IO
Modified: tapestry/tapestry4/trunk/src/site/apt/javascript/form.apt
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/apt/javascript/form.apt?rev=425857&r1=425856&r2=425857&view=diff
==============================================================================
--- tapestry/tapestry4/trunk/src/site/apt/javascript/form.apt (original)
+++ tapestry/tapestry4/trunk/src/site/apt/javascript/form.apt Wed Jul 26 14:41:30 2006
@@ -76,7 +76,7 @@
The new tapestry client side validation API relies completely on the logic provided by the
<<<dojo.validate.check(form, profile)>>> function. This section will probably be undergoing more extensive
documentation at some point, but for now the jsdoc comments in dojo are pasted in below. <(tapestry profile
- specifics are covered in the javascript {{{validation.html}Validation}} section)>.
+ specifics are covered in the javascript {{{form-validation.html}Validation}} section)>.
<<See also:>> <<<dojo.validate.common>>> {{{http://archive.dojotoolkit.org/nightly/src/validate/common.js}source}}
@@ -188,6 +188,15 @@
*----------------------*---------------*------------*----------*----------------------------------------------+
submitName | String | no | | Optional submit name string to use when submitting.
*----------------------*---------------*------------*----------*----------------------------------------------+
+
+** Example
++-------------------------
+<script type="text/javascript">
+ dojo.require("tapestry.form");
+
+ tapestry.form.submit(dojo.byId("myform"));
+</script>
++-------------------------
* tapestry.form.cancel(form)
Modified: tapestry/tapestry4/trunk/src/site/xdoc/index.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/index.xml?rev=425857&r1=425856&r2=425857&view=diff
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/index.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/index.xml Wed Jul 26 14:41:30 2006
@@ -20,40 +20,45 @@
<p><strong>New Features:</strong></p>
<ul>
- <li><b>JSON -</b> Brand new API enabling data communication
- via the <a href="http://json.org/">JSON</a>(JavaScript Object Notation)
- standard. New component classes and rendering schemes also accompany
- the API addition, allowing anyone to easily add JSON communication
- to an existing component or new components. </li>
+ <li><b>JSON -</b> Brand new <a href="tapestry-framework/apidocs/org/apache/tapestry/IJSONRender.html">API</a>
+ enabling data communication via the
+ <a href="http://json.org/">JSON</a>(JavaScript Object Notation)
+ standard. New <a href="tapestry-framework/apidocs/org/apache/tapestry/dojo/IWidget.html">component classes</a>
+ and <a href="tapestry-framework/apidocs/org/apache/tapestry/services/ResponseBuilder.html">rendering schemes</a> also accompany the API addition, allowing anyone to easily
+ add JSON communication to an existing component or new components. </li>
<li><b>XHR -</b> The ever popular XML communication format has also been added into the
- Tapestry core, allowing most of the common <em>ajax</em> concepts to be
- easily developed in yours and existing Tapestry components.</li>
+ <a href="tapestry-framework/apidocs/org/apache/tapestry/services/impl/DojoAjaxResponseBuilder.html">Tapestry core</a>,
+ allowing most of the common <em>ajax</em> concepts to be easily developed in yours
+ and existing Tapestry components.</li>
<li><b><a href="http://dojotoolkit.org">Dojo</a> bundled -</b> As all of the functionality
in this release is based around the <a href="http://dojotoolkit.org">dojo</a>
javascript toolkit, we have provided it bundled with the core Tapestry jar
files. No profile building/installation necessary. Just drop the jars in and
get at all of the client side goodies you like.</li>
- <li><b>Widgets -</b> New <a href="http://dojotoolkit.org">dojo</a> toolkit based widget components
- and complimenting foundation Component classes make it easy for anyone to create
+ <li><b>Widgets -</b> New <a href="http://dojotoolkit.org">dojo</a> toolkit based
+ <a href="tapestry-framework/apidocs/org/apache/tapestry/dojo/form/Autocompleter.html">widget</a>
+ <a href="tapestry-framework/apidocs/org/apache/tapestry/dojo/form/DropdownDatePicker.html">components</a>
+ and complimenting <a href="tapestry-framework/apidocs/org/apache/tapestry/dojo/form/IFormWidget.html">foundation</a> Component classes make it easy for anyone to create
dojo widgets and use them as Tapestry components. The initial 4.1 release won't be
as focused on providing new components as it will solid infrastructure support, but
more and more will be included as the release matures. Currently included are
<em>Autocomplete,DropdownDatePicker,DropdownTimePicker</em>.</li>
- <li><b>Client Side Validation -</b> The client side validation support in Tapestry has been completely
- replaced with a new <a href="http://dojotoolkit.org">dojo</a> based API, providing
- richer and more complete validation than has been seen in previous releases. All of the
- validation constraints that can be specified on the server now have client side functional
- equivalents. Default logic for displaying validation errors/interactions on the client side
+ <li><b>Client Side Validation -</b> The <a href="/UsersGuide/clientside-validation.html">client side validation</a> support
+ in Tapestry has been completely replaced with a new <a href="http://dojotoolkit.org">dojo</a> based API,
+ providing richer and <a href="/javascript/form-validation.html">more complete</a> validation than has been
+ seen in previous releases. All of the validation constraints that can be specified on the server now have
+ client side functional equivalents. Default logic for displaying validation errors/interactions on the client side
UI has also been updated a great deal. The old alert box mechanism has been replaced by field
decorators that apply css rules to your form fields, as well as dhtml dialog boxes displaying
summaries of errors. Much much more is planned in this area, but the current set of functionality
should be more than enough to make many happy.</li>
- <li><b>New Annotations -</b> Perhaps the most exciting new addition, a new <strong>@EventListener</strong>
+ <li><b>New Annotations -</b> Perhaps the most exciting new addition, a new <a href="tapestry-annotations/index.html#EventListener">@EventListener</a>
annotation has been added. This will allow people to bind one of their page/component
class listeners to virtually any client side widget/html event concievable. The API also supports
varying types of listening, such as being able to submit a form when a particular event happens,
- or simplying using the new <b>BrowserEvent</b> object to determine the client side state when
- the event happened. <em>(Such as x/y coordinates of mouse clicks, event targets, etc..This is pretty
+ or simplying using the new <a href="tapestry-framework/apidocs/org/apache/tapestry/event/BrowserEvent.html">BrowserEvent</a>
+ object to determine the client side state when the event happened.
+ <em>(Such as x/y coordinates of mouse clicks, event targets, etc..This is pretty
much a literal one-to-one mapping to real browser generated Events.)</em></li>
</ul>