org.apache.tapestry5.internal.services
Class ClientBehaviorSupportImpl

java.lang.Object
  extended by org.apache.tapestry5.internal.services.ClientBehaviorSupportImpl
All Implemented Interfaces:
ClientBehaviorSupport

public class ClientBehaviorSupportImpl
extends Object
implements ClientBehaviorSupport


Constructor Summary
ClientBehaviorSupportImpl(JavaScriptSupport javascriptSupport, Environment environment)
           
 
Method Summary
 void addFormFragment(String clientId, boolean alwaysSubmit, String showFunctionName, String hideFunctionName)
          Deprecated. Use addFormFragment(String, boolean, String, String, String) instead
 void addFormFragment(String clientId, boolean alwaysSubmit, String showFunctionName, String hideFunctionName, String visibilityBoundFunctionName)
          Adds a new client-side Tapestry.FormFragment object.
 void addFormFragment(String clientId, String showFunctionName, String hideFunctionName)
          Deprecated. Use addFormFragment(String,boolean,String,String) instead
 void addFormInjector(String clientId, Link link, InsertPosition insertPosition, String showFunctionName)
          Adds a new client-side Tapestry.FormInjector object.
 void addValidation(Field field, String validationName, String message, Object constraint)
          Collects field validation information.
 void addZone(String clientId, String showFunctionName, String updateFunctionName)
          Adds a new client-side Tapestry.Zone object.
 void commit()
          Invoked at the end of rendering to commit (to the JavaScriptSupport) any accumulated validations.
 void linkZone(String linkId, String elementId, Link eventLink)
          Sets the client-side onclick handler for an <a> element to perform an Ajax update of a zone.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ClientBehaviorSupportImpl

public ClientBehaviorSupportImpl(JavaScriptSupport javascriptSupport,
                                 Environment environment)
Method Detail

addZone

public void addZone(String clientId,
                    String showFunctionName,
                    String updateFunctionName)
Description copied from interface: ClientBehaviorSupport
Adds a new client-side Tapestry.Zone object. Zones are linked to a an element (typically, a <div>). A Zone may have handlers used to initially show it, or to highlight it when its content changes. Such handlers are referenced by name, as functions of the Tapestry.ElementEffect object.

Specified by:
addZone in interface ClientBehaviorSupport
Parameters:
clientId - client-side id of the element that will be updated by the zone
showFunctionName - name of the function used to initially show the zone (if not visible), or null for default
updateFunctionName - name of function used to highlight the function after an update, or null for default

linkZone

public void linkZone(String linkId,
                     String elementId,
                     Link eventLink)
Description copied from interface: ClientBehaviorSupport
Sets the client-side onclick handler for an <a> element to perform an Ajax update of a zone.

Specified by:
linkZone in interface ClientBehaviorSupport
Parameters:
linkId - id of the link to Ajax enable
elementId - id of an element that has been previously registered as a Zone

addFormFragment

public void addFormFragment(String clientId,
                            String showFunctionName,
                            String hideFunctionName)
Deprecated. Use addFormFragment(String,boolean,String,String) instead

Description copied from interface: ClientBehaviorSupport
Adds a new client-side Tapestry.FormFragment object. FormFragment's are used to make parts of a client-side form visible or invisible, which involves interactions with both the server-side and client-side validation.

Specified by:
addFormFragment in interface ClientBehaviorSupport
Parameters:
clientId - client-side id of the element that will be made visible or invisible
showFunctionName - name of function (of the Tapestry.ElementEffect object) used to make the SubForm visible, or null for the default
hideFunctionName - name of the function used to make the SubForm invisible, or null for the default

addFormFragment

public void addFormFragment(String clientId,
                            boolean alwaysSubmit,
                            String showFunctionName,
                            String hideFunctionName)
Deprecated. Use addFormFragment(String, boolean, String, String, String) instead

Description copied from interface: ClientBehaviorSupport
Adds a new client-side Tapestry.FormFragment object. FormFragment's are used to make parts of a client-side form visible or invisible, which involves interactions with both the server-side and client-side validation.

Specified by:
addFormFragment in interface ClientBehaviorSupport
Parameters:
clientId - client-side id of the element that will be made visible or invisible
alwaysSubmit - if true, the fragment ignores client-side visiblility and always submits its values
showFunctionName - name of function (of the Tapestry.ElementEffect object) used to make the SubForm visible, or null for the default
hideFunctionName - name of the function used to make the SubForm invisible, or null for the default

addFormFragment

public void addFormFragment(String clientId,
                            boolean alwaysSubmit,
                            String showFunctionName,
                            String hideFunctionName,
                            String visibilityBoundFunctionName)
Description copied from interface: ClientBehaviorSupport
Adds a new client-side Tapestry.FormFragment object. FormFragment's are used to make parts of a client-side form visible or invisible, which involves interactions with both the server-side and client-side validation.

Specified by:
addFormFragment in interface ClientBehaviorSupport
Parameters:
clientId - client-side id of the element that will be made visible or invisible
alwaysSubmit - if true, the fragment ignores client-side visiblility and always submits its values
showFunctionName - name of function (of the Tapestry.ElementEffect object) used to make the SubForm visible, or null for the default
hideFunctionName - name of the function used to make the SubForm invisible, or null for the default
visibilityBoundFunctionName - name of the function used to bound the isDeepVisible search, or null for the default

addFormInjector

public void addFormInjector(String clientId,
                            Link link,
                            InsertPosition insertPosition,
                            String showFunctionName)
Description copied from interface: ClientBehaviorSupport
Adds a new client-side Tapestry.FormInjector object. FormInjectors are used to extend an existing Form with new content.

Specified by:
addFormInjector in interface ClientBehaviorSupport
Parameters:
clientId - client-side id of the element that identifiess where the new content will be placed
link - action request link used to trigger the server-side object, to render the new content
insertPosition - where the new content should go (above or below the element)
showFunctionName - name of function (of the Tapestry.ElementEffect object) used to make the new element visible, or null for the default

addValidation

public void addValidation(Field field,
                          String validationName,
                          String message,
                          Object constraint)
Description copied from interface: ClientBehaviorSupport
Collects field validation information.

Specified by:
addValidation in interface ClientBehaviorSupport
Parameters:
field - for which validation is being generated
validationName - name of validation method (see Tapestry.Validation in tapestry.js)
message - the error message to display if the field is invalid
constraint - additional constraint value, or null for validations that don't require a constraint

commit

public void commit()
Invoked at the end of rendering to commit (to the JavaScriptSupport) any accumulated validations.



Copyright © 2003-2012 The Apache Software Foundation.