usage.apt

这是AJAX的一个HTML实现！ HTML标签AJAX的实现！

    defaultTab="true"/>
  <ajax:tab caption="Honda"
    baseUrl="${pageContext.request.contextPath}/htmlcontent.view"
    parameters="make=honda"/>
  <ajax:tab caption="Mazda"
    baseUrl="${pageContext.request.contextPath}/htmlcontent.view"
    parameters="make=mazda"/>
</ajax:tabPanel>
+------------------------------------------------------------------------+

** ajax:tabPanel
~~~~~~~~~~~~~~~~

*---------------------+------------------------------------------------------------+-------------*
 <<Parameter>>        | <<Description>>                                            | <<Required>>
*---------------------+------------------------------------------------------------+-------------*
 id         | ID of the tab panel                                        | yes
*---------------------+------------------------------------------------------------+-------------*
 preFunction          | Function to execute before Ajax is begun                   | no
*---------------------+------------------------------------------------------------+-------------*
 postFunction         | Function to execute after Ajax is finished, allowing for a chain of additional functions to execute | no
*---------------------+------------------------------------------------------------+-------------*
 errorFunction        | Function to execute if there is a server exception (non-200 HTTP response) | no
*---------------------+------------------------------------------------------------+-------------*
 parser               | The response parser to implement [default=ResponseHtmlParser] | no
*---------------------+------------------------------------------------------------+-------------*

** ajax:tab
~~~~~~~~~~

*---------------------+------------------------------------------------------------+-------------*
 <<Parameter>>        | <<Description>>                                            | <<Required>>
*---------------------+------------------------------------------------------------+-------------*
 baseUrl              | The URL to use for the AJAX action, which will return content for this tab | yes
*---------------------+------------------------------------------------------------+-------------*
 caption              | The caption for this tab                                   | yes
*---------------------+------------------------------------------------------------+-------------*
 defaultTab           | Indicates whether this tab is the initial one loaded [true|false] | no
*---------------------+------------------------------------------------------------+-------------*
 parameters           | A comma-separated list of parameters to pass to the server-side action or servlet | no
*---------------------+------------------------------------------------------------+-------------*


* ajax:toggle
~~~~~~~~~~~~~

  The toggle tag uses a single image to represent the display of the ratings with the help of CSS
  to manage the mouseover/mouseout.  Additionally, you may supply the tag with a form field to hold
  the value of the selected rating.

+------------------------------------------------------------------------+
<!-- To hold value of the selected rating; maps to the 'state' attribute -->
<form id="toggleForm" action=".">
  <input type="hidden" id="raterField" />
</form>

<h4>AJAX Rating System <span style="font:normal 8pt Verdana;">[${toggleRating}]</span></h4>
<ajax:toggle
  baseUrl="${pageContext.request.contextPath}/toggle.view"
  source="rater1"
  ratings="One,Two,Three,Four,Five"
  defaultRating="${toggleRating}"
  containerClass="star-rating"
  messageClass="star-rating-message"
  selectedClass="selected"
  selectedOverClass="selectedover"
  selectedLessClass="selectedless"
  overClass="over"
  onOff="false"
  state="raterField"
  preFunction="initProgress"
  postFunction="resetProgress"
  errorFunction="reportError"
  />
+------------------------------------------------------------------------+

  <<Note: Tag must appear AFTER the web form.>>

*---------------------+------------------------------------------------------------+-------------*
 <<Parameter>>        | <<Description>>                                            | <<Required>>
*---------------------+------------------------------------------------------------+-------------*
 var                  | Name of the JavaScript object created                      | no
*---------------------+------------------------------------------------------------+-------------*
 attachTo             | Name of the JavaScript object to which toggle will attach.  You must define 'var' for this to work. | no
*---------------------+------------------------------------------------------------+-------------*
 baseUrl              | URL of server-side action or servlet that processes a simple command from a toggle action; responds with a single option value and label | yes
*---------------------+------------------------------------------------------------+-------------*
 source               | A unique ID for each toggle tag                            | yes
*---------------------+------------------------------------------------------------+-------------*
 ratings              | Comma-delimited list of rating values                      | yes
*---------------------+------------------------------------------------------------+-------------*
 defaultRating        | The default rating to use from the 'ratings' list          | yes
*---------------------+------------------------------------------------------------+-------------*
 state                | ID of hidden form field used to hold the current state     | yes
*---------------------+------------------------------------------------------------+-------------*
 onOff                | Whether this is a simple on/off (two-value) rating [default=false] | no
*---------------------+------------------------------------------------------------+-------------*
 containerClass       | CSS style class for the container wrapping the toggle      | yes
*---------------------+------------------------------------------------------------+-------------*
 messageClass         | CSS style class for the message displayed as you mouseover each toggle image | no
*---------------------+------------------------------------------------------------+-------------*
 selectedClass        | CSS style class for the rating that's selected             | yes
*---------------------+------------------------------------------------------------+-------------*
 selectedLessClass    | CSS style class for the rating that is less than the selected one as you mouseover | yes
*---------------------+------------------------------------------------------------+-------------*
 selectedOverClass    | CSS style class for the rating that is greater than the selected one as you mouseover | yes
*---------------------+------------------------------------------------------------+-------------*
 overClass            | CSS style class for the rating that is greater than the selected one | yes
*---------------------+------------------------------------------------------------+-------------*
 parameters           | A comma-separated list of parameters to pass to the server-side action or servlet | rating={ajaxParameter}
*---------------------+------------------------------------------------------------+-------------*
 preFunction          | Function to execute before Ajax is begun                   | no
*---------------------+------------------------------------------------------------+-------------*
 postFunction         | Function to execute after Ajax is finished, allowing for a chain of additional functions to execute | no
*---------------------+------------------------------------------------------------+-------------*
 errorFunction        | Function to execute if there is a server exception (non-200 HTTP response) | no
*---------------------+------------------------------------------------------------+-------------*
 parser               | The response parser to implement [default=ResponseHtmlParser] | no
*---------------------+------------------------------------------------------------+-------------*


* ajax:updateField
~~~~~~~~~~~~~~~~~~

  Builds the JavaScript required to update one or more form fields based on the value of another
  single field.

+------------------------------------------------------------------------+
<form>
  <fieldset>
  <legend>Velocity Conversion</legend>
  <label for="mph">Miles/Hour (mph)</label>
  <input type="text" id="mph" />
  <input id="action" type="button" value="Go"/>

  <label for="kph">Kilometers/Hour (kph)</label>
  <input type="text" id="kph" />

  <label for="mps">Meters/Second (m/s)</label>
  <input type="text" id="mps" />
  </fieldset>
</form>

<ajax:updateField
  baseUrl="${pageContext.request.contextPath}/ConvertMPH.view"
  source="mph"
  target="kph,mps"
  action="action"
  parameters="mph={mph}" />
+------------------------------------------------------------------------+

  <<Note: Tag must appear AFTER the web form.>>


*---------------------+------------------------------------------------------------+-------------*
 <<Parameter>>        | <<Description>>                                            | <<Required>>
*---------------------+------------------------------------------------------------+-------------*
 var                  | Name of the JavaScript object created                      | no
*---------------------+------------------------------------------------------------+-------------*
 attachTo             | Name of the JavaScript object to which updateField will attach.  You must define 'var' for this to work. | no
*---------------------+------------------------------------------------------------+-------------*
 baseUrl              | URL of server-side action or servlet that processes a simple command | yes
*---------------------+------------------------------------------------------------+-------------*
 source               | The form field that will hold the parameter passed to the servlet | yes
*---------------------+------------------------------------------------------------+-------------*
 target               | A comma-delimited list of form field IDs that will be populated with results | yes
*---------------------+------------------------------------------------------------+-------------*
 action               | ID of form button or image tag that will fire the onclick event | yes
*---------------------+------------------------------------------------------------+-------------*
 parameters           | A comma-separated list of parameters to pass to the server-side action or servlet | no
*---------------------+------------------------------------------------------------+-------------*
 eventType            | Specifies the event type to attach to the source field(s)  | no
*---------------------+------------------------------------------------------------+-------------*
 preFunction          | Function to execute before Ajax is begun                   | no
*---------------------+------------------------------------------------------------+-------------*
 postFunction         | Function to execute after Ajax is finished, allowing for a chain of additional functions to execute | no
*---------------------+------------------------------------------------------------+-------------*
 errorFunction        | Function to execute if there is a server exception (non-200 HTTP response) | no
*---------------------+------------------------------------------------------------+-------------*
 parser               | The response parser to implement [default=ResponseHtmlParser] | no
*---------------------+------------------------------------------------------------+-------------*

* ajax:tree
~~~~~~~~~~~~~~~~~~

  Builds the JavaScript required to create a tree

+------------------------------------------------------------------------+


<ajax:tree 
	baseUrl="${contextPath}/tree.view" 
	id="cars"
	parameters="node={ajaxParameter}"
	nodeClass="nodeClass"
	expandedClass="expandedNode"
	collapsedClass="collapsedNode"
	treeClass="tree">
</ajax:tree>
+------------------------------------------------------------------------+

  <<Note: The styleId value will be the first one sent to the baseUrl to get the nodes on the first level>>


*---------------------+------------------------------------------------------------+-------------*
 <<Parameter>>        | <<Description>>                                            | <<Required>>
*---------------------+------------------------------------------------------------+-------------*
 baseUrl              | URL of server-side action or servlet that processes a simple command | yes
*---------------------+------------------------------------------------------------+-------------*
 action               | ID of form button or image tag that will fire the onclick event | yes
*---------------------+------------------------------------------------------------+-------------*
 parameters           | A comma-separated list of parameters to pass to the server-side action or servlet | yes
*---------------------+------------------------------------------------------------+-------------*
 id              | The ID of the tree   | yes
*---------------------+------------------------------------------------------------+-------------*
 preFunction          | Function to execute before Ajax is begun                   | no
*---------------------+------------------------------------------------------------+-------------*
 postFunction         | Function to execute after Ajax is finished, allowing for a chain of additional functions to execute | no
*---------------------+------------------------------------------------------------+-------------*
 errorFunction        | Function to execute if there is a server exception (non-200 HTTP response) | no
*---------------------+------------------------------------------------------------+-------------*
 parser               | The response parser to implement [default=ResponseXmlToHtmlLinkListParser] | no
*---------------------+------------------------------------------------------------+-------------*
 collapsedClass       | CSS style class for the node's image(when collapsed) | no
*---------------------+------------------------------------------------------------+-------------*
 expandedClass        | CSS style class for the node's image(when expanded) | no
*---------------------+------------------------------------------------------------+-------------*
 treeClass            | CSS style class for the unsorted list(each node is hosted on one) | no
*---------------------+------------------------------------------------------------+-------------*
 nodeClass        | CSS style class for the node's link | no
*---------------------+------------------------------------------------------------+-------------*