Oracle Fusion Middleware Tag Reference for Oracle ADF Faces 12c (12.1.2) E23188-01

<af:collectionDropTarget>

collectionDropTarget collection drop target

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.

</section> <section name="Code_Example_s_">

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.