Overview | Library | Tag | Help
| FRAMES NO FRAMES

## ICEfaces-EE ACE Components
Tag draggable

Enables an Id-specified component to be moved via dragging. Draggable component can cause events on droppable ones.

For more information, see the Draggable Wiki Documentation.

Client Events
Name | Description | Supported classes for argument
start | Fired when the target component starts to be dragged (default event). By default, no components are rendered in this ajax request, because rendering this draggable component itself or the target component could cause a dynamic update that replaces the original nodes being dragged on the page, which could interrupt the dragging action for the user. | javax.faces.event.AjaxBehaviorEvent

Client events can be used with Client Behaviors and the ace:ajax tag.

Tag Information
Tag Class | org.icefaces.ace.component.dnd.DraggableTag
TagExtraInfo Class | None
Body Content | JSP
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
axis | no | true | `java.lang.String` | Restrict the drag movement of this item to an axis. Default is null, possible values include: "x" & "y".
binding | no | true | `javax.el.ValueExpression` | Using an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean.
containment | no | true | `java.lang.String` | JQuery selector of the element whose boundaries should restrict the movement of this draggable. Other possible values are 'parent', 'document', and 'window'.
cursor | no | true | `java.lang.String` | Cursor style to set when this component is being dragged. See this page for a reference of what cursor styles your browser supports.
datasource | no | true | `java.lang.String` | Allows you to set the ID of an UIData component that will provide a Java object as input for the drag start event. That object is defined by matching the index of the draggable to an object at the same index in the UIData component backing.
disabled | no | true | `boolean` | If set, movement is disabled.
dragOnly | no | true | `boolean` | If set, component won't cause drop event.
dragStartListener | no | true | `javax.el.MethodExpression` | MethodExpression reference to a method called whenever the target component starts to be dragged. (It is advised not to use this event for updating the component being dragged, in order to avoid having its markup replaced while still dragging it. See wiki for more details.)
for | no | true | `java.lang.String` | Id of the component to add draggable behavior to.
grid | no | true | `java.lang.String` | Defines the drag movement of this component as though snapping to a grid in defined intervals. Ex: '20x20', measured in pixels.
handle | no | true | `java.lang.String` | Restrict the drag-event start to an element specified by this JQuery selector.
helper | no | true | `java.lang.String` | Specifies which element to move during the dragging event. Possible values are 'original' or 'clone'.
id | no | true | `java.lang.String` | The component identifier for this component. This value must be unique within the closest parent component that is a naming container.
opacity | no | true | `java.lang.Double` | The opacity for the helper during dragging. Values can range from 0.00 to 1.00. Default = '1.0'.
rendered | no | true | `boolean` | Return true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'.
revert | no | true | `boolean` | If set, the component will return to its original position when dragging stops.
scope | no | true | `java.lang.String` | This arbitrary keyword allows sets of dragabbles and droppables with the same keyword to be associated with each other exclusively.
snap | no | true | `boolean` | Enable 'snap to droppable' behavior for this component.
snapMode | no | true | `java.lang.String` | Specifies which edges on elements to snap to. Possible values include: outer, inner and both.
snapTolerance | no | true | `int` | Distance in pixels from the droppable edges at which snapping should occur.
stack | no | true | `java.lang.String` | JQuery selector that defines the set of items this draggable shares its space with, ensures this item is brought to the front z-index when dragged.
widgetVar | no | true | `java.lang.String` | The JavaScript component instance variable name.
zindex | no | true | `int` | The z-index to set for the helper object.

Variables
| No Variables Defined.

Overview | Library | Tag | Help
| FRAMES NO FRAMES

Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.