MVC.Controller.Action.Drag API

MVC.Controller.Action.Drag, prototype, init, mousedown, static, match

Inherits: MVC.Controller.Action.Event

Adds drag functionality to controller actions with the following events:

dragstart - called when a drag is first moved.
dragging - called everytime the drag moves
dragend - called when someone releases a dragable object (mouseup)

Drags actions are called with MVC.Controller.Params.Drag. Use the drag params to change the behavior of the drag.

For more information on how Drag works read MVC.Draggable.

Install

include.plugins('controller/dragdrop')

Example

TasksController = MVC.Controller.extend('tasks',{
  ".handle dragstart" : function(params){
      //set something else to be dragged instead of this object
      params.representitive(MVC.$E('dragitem'), 15, 15);
      params.revert();
  },
  ".handle dragging" : function(params){

  },
  ".handle dragend" : function(params){

  }
}

Static Methods

match

Matches "(.*?)\\s?(dragstart|dragend|dragging)$"

Prototype Methods

init

init(action_name, callback, className, element, f, controller) -> undefined

Attaches a delegated mousedown function to the css selector for this action. Saves additional actions in callbacks.

action_name {String} - the name of the function

callback {} -

className {} -

element {} -

f {Function} - the function itself

controller {MVC.Controller} - the controller this action belongs to

mousedown

mousedown(element, params) -> undefined

Called when someone mouses down on a draggable object. Gathers all callback functions and creates a new Draggable.