FuncUnit.prototype.drag function

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

func_unit.drag(options, callback) -> funcUnit

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.

S('#foo').drag('#bar')

Options as Coordinates

You can pass in coordinates as clientX and clientY:

S('#foo').drag('100x200')

Or as pageX and pageY

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

Or relative to the start position S('#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
S('#foo').drag({
  from: "0x0",
  to: "100x100",
  duration: 2000
})

callback {optional:Function}

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

returns {funcUnit}

returns the funcunit selector for chaining.