Oracle Fusion Middleware Tag Reference for Oracle ADF Faces 12c (12.2.1.4.0) E81455-03

# <af:dropTarget>

dropTarget droptarget

The <af:dropTarget> tag provides generic drop support for components that don't show any location-specific drop feedback. If the drop action matches any of the DataFlavors specified by the enclosed <af:dataFlavor> tags and the proposed drop action matches one of the `actions` then the `dropListener`'s `javax.el.MethodExpression` will be called with the DropEvent. The af:dropTarget tag must have at minimum one af:dataFlavor child tag.

This example shows setting the `actions`, and `dropListener` attribute of the <af:dropTarget> tag as well as using the <af:dataFlavor> tag to support drops of `java.util.Collection` objects onto the outputText, firing the `handleCollectionFireDrop` method on the `TestDropHandler` managed bean.

##

      <af:outputText id="objectDropTarget" value="Fire these developers:">
        <af:dropTarget actions="COPY"
                      dropListener="#{TestDropHandler.handleCollectionFireDrop}">
          <af:dataFlavor flavorClass="java.util.Collection"/>
        </af:dropTarget>
      </af:outputText>

    Attributes

        Name
        Type
        Supports EL?
        Description

    id
    String
    no

                    the identifier for the tag. The identifier must follow a subset of the syntax allowed in HTML:

                      Must not be a zero-length String
                      First character must be an ASCII letter (A-Za-z) or an underscore ('_')
                      Subsequent characters must be an ASCII letter or digit (A-Za-z0-9), an underscore ('_'), or a
                          dash ('-')

    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".

    clientDropListener
    String
    no

                    JavaScript method taking no parameters that will be called when an item is dropped
                    on the dropTarget.  The JavaScript method can perform client side processing related
                    to the operation before a server call is made.  This method returns an AdfDnDContext
                    action.  For example, if the method returns AdfDnDContext.ACTION_NONE the drop
                    operation will be canceled and no server call will be made; if the method returns
                    AdfDnDContext.ACTION_COPY a copy operation will be allowed and a server call will be
                    made which will execute the dropListener if it exists.

    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.