Jump to content
GreenSock

DraggablePlugin

.lockedAxis

.lockedAxis : String

Returns : String

The axis along which movement is locked during that particular drag.

Details

Boolean - The axis along which movement is locked (either "x" or "y"). For example, if lockAxis is true on a Draggable of type: "x,y", and the user starts dragging horizontally, lockedAxis would be "y" because vertical movement won’t be allowed during that drag. The lockedAxis property isn’t set immediately upon press - the Draggable must wait to see which direction the user drags first. You can define a onLockAxis callback if you’d like to be notified when the axis gets locked.

lockedAxis is also populated on touch-enabled devices when you have a Draggable whose type only permits it to drag along one axis (like type: "x", type: "y", type: "left", or type: "top") and the user touch-drags and the Draggable determines the direction, either allowing native touch-scrolling or Draggable-induced dragging.

  1. Draggable.create("#yourID", {
  2. type: "x,y",
  3. lockAxis: true,
  4. onLockAxis: function() {
  5. console.log("locked axis: " + this.lockedAxis);
  6. }
  7. });
Copyright 2017, GreenSock. All rights reserved. This work is subject to theterms of useor for Club GreenSock members, the software agreement that was issued with the membership.
×