Oracle Fusion Middleware Tag Reference for Oracle ADF Faces 12c (12.2.1.4.0) E81455-02 |
This tag makes a collection component (e.g. table, treeTable or tree) a drop target and can be used to declaratively initialize the drop target.
This example makes the tree a drop target.
<af:table var="test1" value="#{collectionDnD.sourceValues}" id="table"
summary="collection drag source"
rowSelection="single">
<af:column headerText="Product">
<af:outputText value="#{test1.product}"/>
</af:column>
<af:column headerText="Cost">
<af:outputText value="#{test1.cost}"/>
</af:column>
<af:collectionDragSource actions="COPY" modelName="DnDDemoModel"/>
</af:table>
<af:table var="test2" value="#{collectionDnD.targetValues}" id="table2"
summary="collection drag source"
rowSelection="single">
<af:column headerText="Product">
<af:outputText value="#{test2.product}"/>
</af:column>
<af:column headerText="Cost">
<af:outputText value="#{test2.cost}"/>
</af:column>
<af:collectionDropTarget actions="COPY" modelName="DnDDemoModel"
dropListener="#{collectionDnD.handleDrop}"/>
</af:table>
Attributes
Name
Type
Supports EL?
Description
actions
String
no
Drag and drop actions supported by this target. The actions must be an NMTOKENS from
the set of "COPY, "MOVE", "LINK" in any particular order e.g. (actions="COPY LINK MOVE").
If no actions are specified, the default is "COPY".
modelName
String
no
The model name for this drop target. The model name is used to identify this drop target.
Please note that drag and drop can only be performed between compatible collection
components. The model name is used for the compatibility purpose.
dropListener
javax.faces.el.MethodBinding
Only EL
A method reference to a callback with the signature
oracle.adf.view.rich.dnd.DnDAction method(oracle.adf.view.rich.event.DropEvent dropEvent)
called when a drop occurs on the component. This callback should check the
DropEvent to determine whether it will accept the drop or not. If the callback
accepts the drop, it should perform the drop and return the DnDAction it performed--
DnDAction.COPY
, DnDAction.MOVE
or DnDAction.LINK
,
otherwise it should return DnDAction.NONE
to indicate that the
drop was rejected. The target component is automatically redrawn in response
to a successful drop.
Please note that dropSite==null
is a legal value in DropEvent.
dropSite==null
and DropOrientation==ON
indicates that the drop has happened outside
the data portion of the collection component and should be treated as a drop on the entire
component.
Also note that dropSite==null
and DropOrientation==AFTER
indicates that the drop
has happened on an empty collection component and the user intends to append the data.
For further information see the DropEvent
class in the JavaDoc.