Oracle Fusion Middleware Tag Reference for Oracle ADF Faces 12c (12.2.1.4.0) E81455-02 |
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.