Client Attributes

The ADF Faces tag af:clientAttribute lets you specify the name and value of an attribute to add to a component. For example:

                               
<af:image source="/jdeveloper.png">
  <af:clientAttribute name="cup" value="Coffee"/>
</af:image>
                            

Note that in a real-world application, the value attribute would be an EL expression pointing to a bound attribute (for example, #{bindings.Departmentname.inputValue}). At runtime the EL expression will evaluate to a value.

By embedding af:clientAttribute into a component, at runtime, the added attribute is made available both on the client side as well as on the server side.

In the example, by adding af:clientAttribute to the image component and also specifying the added attribute as the drag source, at runtime when the user drags the image, the added attribute becomes the component attribute to use as the drag source. You will add the af:attributeDragSource tag next:

                               
<af:image source="/jdeveloper.png">
  <af:clientAttribute name="cup" value="Coffee"/>
  <af:attributeDragSource attribute="cup"/>
</af:image>
                            

Note: If you wish to use an existing component attribute as the drag source, you don't need to add af:clientAttribute. For example, the following code uses the component's value attribute as the drag source:

                               
<af:outputText value="Drag this">
  <af:attributeDragSource attribute="value"/>
</af:image>
                            

Copyright © 1997, 2009, Oracle. All rights reserved.