.drag()

  • function
FuncUnit.prototype.drag  

drag(options [,success])

Drags an element into another element or coordinates. This takes the same parameters as [syn.prototype.move move].

Parameters

  1. options {String | Object}

    A selector or coordinates describing the motion of the drag.

    Options as a Selector
    Passing a string selector to drag the mouse. The drag runs to the center of the element matched by the selector. The following drags from the center of #foo to the center of #bar.
    F('#foo').drag('#bar')
    
  2. success {function()}Optional

    a callback that runs after the drag, but before the next action.

Returns

{funcUnit}

returns the funcunit object for chaining.

Options as Coordinates
You can pass in coordinates as clientX and clientY:
F('#foo').drag('100x200')

Or as pageX and pageY

F('#foo').drag('100X200')

Or relative to the start position

F('#foo').drag('+10+20')
Options as an Object
You can configure the duration, start, and end point of a drag by passing in a json object.
//drags from 0x0 to 100x100 in 2 seconds
F('#foo').drag({
  from: "0x0",
  to: "100x100",
  duration: 2000
})