AUI.add('aui-resize', function(A) {
/**
* The Resize Utility allows you to make an HTML element resizable.
*
* @module aui-resize
*/
var Lang = A.Lang,
isArray = Lang.isArray,
isBoolean = Lang.isBoolean,
isNumber = Lang.isNumber,
isString = Lang.isString,
trim = Lang.trim,
indexOf = A.Array.indexOf,
DOT = '.',
COMMA = ',',
SPACE = ' ',
ACTIVE = 'active',
ACTIVE_HANDLE = 'activeHandle',
ACTIVE_HANDLE_EL = 'activeHandleEl',
ALL = 'all',
AUTO = 'auto',
AUTO_HIDE = 'autoHide',
BOTTOM = 'bottom',
CLASS_NAME = 'className',
CONSTRAIN = 'constrain',
CURSOR = 'cursor',
DIAGONAL = 'diagonal',
DOTTED = 'dotted',
DRAG_CURSOR = 'dragCursor',
GRIP = 'grip',
GRIPSMALL = 'gripsmall',
HANDLE = 'handle',
HANDLES = 'handles',
HIDDEN = 'hidden',
HORIZONTAL = 'horizontal',
ICON = 'icon',
INNER = 'inner',
LEFT = 'left',
MARGIN = 'margin',
MAX_HEIGHT = 'maxHeight',
MAX_WIDTH = 'maxWidth',
MIN_HEIGHT = 'minHeight',
MIN_WIDTH = 'minWidth',
NODE = 'node',
NODE_NAME = 'nodeName',
NONE = 'none',
OFFSET_HEIGHT = 'offsetHeight',
OFFSET_WIDTH = 'offsetWidth',
PARENT_NODE = 'parentNode',
POSITION = 'position',
PRESEVE_RATIO = 'preserveRatio',
PROXY = 'proxy',
PROXY_EL = 'proxyEl',
PX = 'px',
REGION = 'region',
RELATIVE = 'relative',
RESIZE = 'resize',
RESIZING = 'resizing',
RIGHT = 'right',
STATIC = 'static',
TICK_X = 'tickX',
TICK_Y = 'tickY',
TOP = 'top',
VERTICAL = 'vertical',
VIEW = 'view',
VIEWPORT_REGION = 'viewportRegion',
WRAP = 'wrap',
WRAPPER = 'wrapper',
WRAP_TYPES = 'wrapTypes',
BORDER_BOTTOM_WIDTH = 'borderBottomWidth',
BORDER_LEFT_WIDTH = 'borderLeftWidth',
BORDER_RIGHT_WIDTH = 'borderRightWidth',
BORDER_TOP_WIDTH = 'borderTopWidth',
EV_MOUSE_UP = 'resize:mouseUp',
EV_RESIZE = 'resize:resize',
EV_RESIZE_END = 'resize:end',
EV_RESIZE_START = 'resize:start',
T = 't',
TR = 'tr',
R = 'r',
BR = 'br',
B = 'b',
BL = 'bl',
L = 'l',
TL = 'tl',
isNode = function(v) {
return (v instanceof A.Node);
},
handleAttrName = function(handle) {
return HANDLE + handle.toUpperCase();
},
concat = function() {
return Array.prototype.slice.call(arguments).join(SPACE);
},
toInitialCap = A.cached(
function(str) {
return str.substring(0, 1).toUpperCase() + str.substring(1);
}
),
getCN = A.ClassNameManager.getClassName,
CSS_ICON = getCN(ICON),
CSS_ICON_GRIPSMALL_DIAGONAL_BR = getCN(ICON, GRIPSMALL, DIAGONAL, BR),
CSS_ICON_GRIP_DOTTED_HORIZONTAL = getCN(ICON, GRIP, DOTTED, HORIZONTAL),
CSS_ICON_GRIP_DOTTED_VERTICAL = getCN(ICON, GRIP, DOTTED, VERTICAL),
CSS_RESIZE = getCN(RESIZE),
CSS_RESIZE_HANDLE = getCN(RESIZE, HANDLE),
CSS_RESIZE_HANDLE_ACTIVE = getCN(RESIZE, HANDLE, ACTIVE),
CSS_RESIZE_HANDLE_INNER = getCN(RESIZE, HANDLE, INNER),
CSS_RESIZE_HANDLE_INNER_PLACEHOLDER = getCN(RESIZE, HANDLE, INNER, '{handle}'),
CSS_RESIZE_HANDLE_PLACEHOLDER = getCN(RESIZE, HANDLE, '{handle}'),
CSS_RESIZE_HIDDEN_HANDLES = getCN(RESIZE, HIDDEN, HANDLES),
CSS_RESIZE_PROXY = getCN(RESIZE, PROXY),
CSS_RESIZE_WRAPPER = getCN(RESIZE, WRAPPER),
CSS_ICON_DIAGONAL = concat(CSS_ICON, CSS_ICON_GRIPSMALL_DIAGONAL_BR),
CSS_ICON_HORIZONTAL = concat(CSS_ICON, CSS_ICON_GRIP_DOTTED_HORIZONTAL),
CSS_ICON_VERTICAL = concat(CSS_ICON, CSS_ICON_GRIP_DOTTED_VERTICAL),
REGEX_CHANGE_HEIGHT = /^(t|b)$/i,
REGEX_CHANGE_LEFT = /^(tl|l|bl)$/i,
REGEX_CHANGE_TOP = /^(tl|t|tr)$/i,
REGEX_CHANGE_WIDTH = /^(bl|br|l|r|tl|tr)$/i,
TPL_HANDLE = '<div class="'+concat(CSS_RESIZE_HANDLE, CSS_RESIZE_HANDLE_PLACEHOLDER)+'">' +
'<div class="'+concat(CSS_RESIZE_HANDLE_INNER, CSS_RESIZE_HANDLE_INNER_PLACEHOLDER)+'"></div>' +
'</div>',
TPL_PROXY_EL = '<div class="' + CSS_RESIZE_PROXY + '"></div>',
TPL_WRAP_EL = '<div class="' + CSS_RESIZE_WRAPPER + '"></div>',
ALL_HANDLES = [ T, TR, R, BR, B, BL, L, TL ];
/**
* <p><img src="assets/images/aui-resize/main.png"/></p>
*
* A base class for Resize, providing:
* <ul>
* <li>Basic Lifecycle (initializer, renderUI, bindUI, syncUI, destructor)</li>
* <li>Applies drag handles to an element to make it resizable</li>
* <li>Here is the list of valid resize handles:
* <code>[ 't', 'tr', 'r', 'br', 'b', 'bl', 'l', 'tl' ]</code>. You can
* read this list as top, top-right, right, bottom-right, bottom,
* bottom-left, left, top-left.</li>
* <li>The drag handles are inserted into the element and positioned
* absolute. Some elements, such as a textarea or image, don't support
* children. To overcome that, set wrap:true in your config and the
* element willbe wrapped for you automatically.</li>
* </ul>
*
* Quick Example:
*
* <pre><code>var instance = new A.Resize({
* node: '#resize1',
* proxy: true,
* preserveRatio: true,
* wrap: true,
* maxHeight: 170,
* maxWidth: 400,
* handles: 't, tr, r, br, b, bl, l, tl'
* });
* </code></pre>
*
* Check the list of <a href="Resize.html#configattributes">Configuration Attributes</a> available for
* Resize.
*
* @class Resize
* @param config {Object} Object literal specifying widget configuration properties.
* @constructor
* @extends Base
*/
var Resize = A.Component.create(
{
/**
* Static property provides a string to identify the class.
*
* @property Resize.NAME
* @type String
* @static
*/
NAME: RESIZE,
/**
* Static property used to define the default attribute
* configuration for the Resize.
*
* @property Resize.ATTRS
* @type Object
* @static
*/
ATTRS: {
/**
* Stores the active handle during the resize.
*
* @attribute activeHandle
* @default null
* @private
* @type String
*/
activeHandle: {
value: null,
validator: isString
},
/**
* Stores the active handle element during the resize.
*
* @attribute activeHandleEl
* @default null
* @private
* @type Node
*/
activeHandleEl: {
value: null,
validator: isNode
},
/**
* False to ensure that the resize handles are always visible, true to
* display them only when the user mouses over the resizable borders.
*
* @attribute autoHide
* @default false
* @type boolean
*/
autoHide: {
value: false,
validator: isBoolean
},
/**
* Will attempt to constrain the resize node to the boundaries. Arguments:<br>
* 'view': Contrain to Viewport<br>
* '#selector_string': Constrain to this node<br>
* '{Region Object}': An Object Literal containing a valid region (top, right, bottom, left) of page positions
*
* @attribute constrain
* @type {String/Object/Node}
*/
constrain: {
setter: function(v) {
if (v && (isNode(v) || isString(v) || v.nodeType)) {
v = A.one(v);
}
return v;
}
},
/**
* The handles to use (any combination of): 't', 'b', 'r', 'l', 'bl',
* 'br', 'tl', 'tr'. Can use a shortcut of All.
*
* @attribute handles
* @default all
* @type Array | String
*/
handles: {
setter: function(val) {
var instance = this;
var handles = [];
// handles attr accepts both array or string
if (isArray(val)) {
handles = val;
}
else if (isString(val)) {
// if the handles attr passed in is an ALL string...
if (val.toLowerCase() == ALL) {
handles = ALL_HANDLES;
}
// otherwise, split the string to extract the handles
else {
A.each(
val.split(COMMA),
function(node, i) {
var handle = trim(node);
// if its a valid handle, add it to the handles output
if (indexOf(ALL_HANDLES, handle) > -1) {
handles.push(handle);
}
}
);
}
}
return handles;
},
value: ALL
},
/**
* The minimum height of the element
*
* @attribute minHeight
* @default 15
* @type Number
*/
minHeight: {
value: 15,
validator: isNumber
},
/**
* The minimum width of the element
*
* @attribute minWidth
* @default 15
* @type Number
*/
minWidth: {
value: 15,
validator: isNumber
},
/**
* The maximum height of the element
*
* @attribute maxHeight
* @default Infinity
* @type Number
*/
maxHeight: {
value: Infinity,
validator: isNumber
},
/**
* The maximum width of the element
*
* @attribute maxWidth
* @default Infinity
* @type Number
*/
maxWidth: {
value: Infinity,
validator: isNumber
},
/**
* The selector or element to resize. Required.
*
* @attribute node
* @type Node
*/
node: {
setter: A.one
},
/**
* Maintain the element's ratio when resizing.
*
* @attribute preserveRatio
* @default false
* @type boolean
*/
preserveRatio: {
value: false,
validator: isBoolean
},
/**
* Resize a proxy element instead of the real element.
*
* @attribute proxy
* @default false
* @type boolean
*/
proxy: {
value: false,
validator: isBoolean
},
/**
* The Resize proxy element.
*
* @attribute proxyEl
* @default Generated using an internal HTML markup
* @type String | Node
*/
proxyEl: {
setter: A.one,
valueFn: function() {
return A.Node.create(TPL_PROXY_EL);
}
},
/**
* True when the element is being Resized.
*
* @attribute resizing
* @default false
* @type boolean
*/
resizing: {
value: false,
validator: isBoolean
},
/**
* The number of x ticks to span the resize to.
*
* @attribute tickX
* @default false
* @type Number | false
*/
tickX: {
value: false
},
/**
* The number of y ticks to span the resize to.
*
* @attribute tickY
* @default false
* @type Number | false
*/
tickY: {
value: false
},
/**
* True to wrap an element with a div if needed (required for textareas
* and images, defaults to false) in favor of the handles config option.
* The wrapper element type (default div) could be over-riden passing the
* <code>wrapper</code> attribute.
*
* @attribute wrap
* @default false
* @type boolean
*/
wrap: {
setter: function(val) {
var instance = this;
var node = instance.get(NODE);
var nodeName = node.get(NODE_NAME);
var typeRegex = instance.get(WRAP_TYPES);
// if nodeName is listed on WRAP_TYPES force use the wrapper
if (typeRegex.test(nodeName)) {
val = true;
}
return val;
},
value: false,
validator: isBoolean
},
/**
* Elements that requires a wrapper by default. Normally are elements
* which cannot have children elements.
*
* @attribute wrapTypes
* @default /canvas|textarea|input|select|button|img/i
* @readOnly
* @type Regex
*/
wrapTypes: {
readOnly: true,
value: /canvas|textarea|input|select|button|img/i
},
/**
* Element to wrap the <code>wrapTypes</code>. This element will house
* the handles elements.
*
* @attribute wrapper
* @default div
* @type String | Node
* @writeOnce
*/
wrapper: {
setter: function() {
var instance = this;
var node = instance.get(NODE);
// by deafult the wrapper is always the node
var wrapper = node;
// if the node is listed on the wrapTypes or wrap is set to true, create another wrapper
if (instance.get(WRAP)) {
wrapper = A.Node.create(TPL_WRAP_EL);
node.placeBefore(wrapper);
wrapper.append(node);
instance._copyStyles(node, wrapper);
// remove positioning of wrapped node, the WRAPPER take care about positioning
node.setStyles({
position: STATIC,
left: 0,
top: 0
});
}
return wrapper;
},
value: null,
writeOnce: true
}
},
EXTENDS: A.Base,
prototype: {
CSS_INNER_HANDLE_MAP: {
r: CSS_ICON_VERTICAL,
l: CSS_ICON_VERTICAL,
t: CSS_ICON_HORIZONTAL,
b: CSS_ICON_HORIZONTAL,
br: CSS_ICON_DIAGONAL
},
/**
* Whether the handle being dragged can change the height.
*
* @attribute changeHeightHandles
* @default false
* @type boolean
*/
changeHeightHandles: false,
/**
* Whether the handle being dragged can change the left.
*
* @attribute changeLeftHandles
* @default false
* @type boolean
*/
changeLeftHandles: false,
/**
* Whether the handle being dragged can change the top.
*
* @attribute changeTopHandles
* @default false
* @type boolean
*/
changeTopHandles: false,
/**
* Whether the handle being dragged can change the width.
*
* @attribute changeWidthHandles
* @default false
* @type boolean
*/
changeWidthHandles: false,
/**
* Cache the border widths of the contrain node if constrain
* option is being used.
*
* @attribute constrainBorderInfo
* @default {}
* @type Object
*/
constrainBorderInfo: null,
/**
* Stores the current values for the height, width, top and left. You are
* able to manipulate these values on resize in order to change the resize
* behavior.
*
* @property info
* @type Object
* @protected
*/
info: null,
/**
* Stores the original values for the height, width, top and left, stored
* on resize start.
*
* @property originalInfo
* @type Object
* @protected
*/
originalInfo: null,
/**
* Construction logic executed during Resize instantiation. Lifecycle.
*
* @method initializer
* @protected
*/
initializer: function() {
var instance = this;
instance.info = {};
instance.originalInfo = {};
instance.constrainBorderInfo = {
bottom: 0,
left: 0,
right: 0,
top: 0
};
instance.get(NODE).addClass(CSS_RESIZE);
instance.renderer();
},
/**
* Create the DOM structure for the Resize. Lifecycle.
*
* @method renderUI
* @protected
*/
renderUI: function() {
var instance = this;
instance._renderHandles();
instance._renderProxy();
},
/**
* Bind the events on the Resize UI. Lifecycle.
*
* @method bindUI
* @protected
*/
bindUI: function() {
var instance = this;
instance._createEvents();
instance._bindResize();
instance._bindDD();
instance._bindHandle();
},
/**
* Sync the Resize UI.
*
* @method syncUI
* @protected
*/
syncUI: function() {
var instance = this;
// hide handles if AUTO_HIDE is true
instance._setHideHandlesUI(
instance.get(AUTO_HIDE)
);
},
/**
* Descructor lifecycle implementation for the Resize class. Purges events attached
* to the node (and all child nodes) and removes the Resize handles.
*
* @method destructor
* @protected
*/
destructor: function() {
var instance = this;
var node = instance.get(NODE);
var wrapper = instance.get(WRAPPER);
// purgeElements on boundingBox
A.Event.purgeElement(wrapper, true);
// destroy handles dd and remove them from the dom
instance.eachHandle(function(handleEl) {
var dd = handleEl.dd;
if (dd) {
dd.destroy();
}
// remove handle
handleEl.remove(true);
});
// unwrap node
if (instance.get(WRAP)) {
node.setStyles({
margin: wrapper.getStyle(MARGIN),
position: wrapper.getStyle(POSITION)
});
wrapper.placeBefore(node);
wrapper.remove(true);
}
node.removeClass(CSS_RESIZE);
node.removeClass(CSS_RESIZE_HIDDEN_HANDLES);
},
/**
* Creates DOM (or manipulates DOM for progressive enhancement)
* This method is invoked by initializer(). It's chained automatically for
* subclasses if required.
*
* @method renderer
* @protected
*/
renderer: function() {
this.renderUI();
this.bindUI();
this.syncUI();
},
/**
* Bind the handles DragDrop events to the Resize instance.
*
* @method _bindDD
* @private
*/
_bindDD: function() {
var instance = this;
instance.on('drag:drag', instance._handleResizeEvent);
instance.on('drag:dropmiss', instance._handleMouseUpEvent);
instance.on('drag:end', instance._handleResizeEndEvent);
instance.on('drag:start', instance._handleResizeStartEvent);
},
/**
* Bind the events related to the handles (_onHandleMouseOver, _onHandleMouseOut).
*
* @method _bindHandle
* @private
*/
_bindHandle: function() {
var instance = this;
var wrapper = instance.get(WRAPPER);
wrapper.on('mouseenter', A.bind(instance._onWrapperMouseEnter, instance));
wrapper.on('mouseleave', A.bind(instance._onWrapperMouseLeave, instance));
wrapper.delegate('mouseout', A.bind(instance._onHandleMouseOut, instance), DOT+CSS_RESIZE_HANDLE);
wrapper.delegate('mouseover', A.bind(instance._onHandleMouseOver, instance), DOT+CSS_RESIZE_HANDLE);
},
/**
* Bind the resize events to the Resize.
*
* @method _bindDD
* @private
*/
_bindResize: function() {
var instance = this;
instance.after(EV_RESIZE, instance._afterResize);
},
/**
* Create the custom events used on the Resize.
*
* @method _createEvents
* @private
*/
_createEvents: function() {
var instance = this;
// create publish function for kweight optimization
var publish = function(name, fn) {
instance.publish(name, {
defaultFn: fn,
queuable: false,
emitFacade: true,
bubbles: true,
prefix: RESIZE
});
};
/**
* Handles the resize start event. Fired when a handle starts to be
* dragged.
*
* @event resize:start
* @preventable _defResizeStartFn
* @param {Event.Facade} event The resize start event.
* @bubbles Resize
* @type {Event.Custom}
*/
publish(
EV_RESIZE_START,
this._defResizeStartFn
);
/**
* Handles the resize event. Fired on each pixel when the handle is
* being dragged.
*
* @event resize:resize
* @preventable _defResizeFn
* @param {Event.Facade} event The resize event.
* @bubbles Resize
* @type {Event.Custom}
*/
publish(
EV_RESIZE,
this._defResizeFn
);
/**
* Handles the resize end event. Fired when a handle stop to be
* dragged.
*
* @event resize:end
* @preventable _defResizeEndFn
* @param {Event.Facade} event The resize end event.
* @bubbles Resize
* @type {Event.Custom}
*/
publish(
EV_RESIZE_END,
this._defResizeEndFn
);
/**
* Handles the resize mouseUp event. Fired when a mouseUp event happens on a
* handle.
*
* @event resize:mouseUp
* @preventable _defMouseUpFn
* @param {Event.Facade} event The resize mouseUp event.
* @bubbles Resize
* @type {Event.Custom}
*/
publish(
EV_MOUSE_UP,
this._defMouseUpFn
);
},
/**
* Responsible for loop each handle element and append to the wrapper.
*
* @method _renderHandles
* @protected
*/
_renderHandles: function() {
var instance = this;
var wrapper = instance.get(WRAPPER);
instance.eachHandle(function(handleEl) {
wrapper.append(handleEl);
});
},
/**
* Render the <a href="Resize.html#config_proxyEl">proxyEl</a> element and
* make it sibling of the <a href="Resize.html#config_node">node</a>.
*
* @method _renderProxy
* @protected
*/
_renderProxy: function() {
var instance = this;
var proxyEl = instance.get(PROXY_EL);
instance.get(WRAPPER).get(PARENT_NODE).append(
proxyEl.hide()
);
},
/**
* <p>Loop through each handle which is being used and executes a callback.</p>
* <p>Example:</p>
* <pre><code>instance.eachHandle(
* function(handleName, index) { ... }
* );</code></pre>
*
* @method eachHandle
* @param {function} fn Callback function to be executed for each handle.
*/
eachHandle: function(fn) {
var instance = this;
A.each(
instance.get(HANDLES),
function(handle, i) {
var handleEl = instance.get(
handleAttrName(handle)
);
fn.apply(instance, [handleEl, handle, i]);
}
);
},
/**
* Creates the handle element based on the handle name and initialize the
* DragDrop on it.
*
* @method _buildHandle
* @param {String} handle Handle name ('t', 'tr', 'b', ...).
* @protected
*/
_buildHandle: function(handle) {
var instance = this;
// create handle node
var node = A.Node.create(
A.substitute(TPL_HANDLE, {
handle: handle
})
);
// add respective css icon classes on the inner element of this handle
node.one(DOT+CSS_RESIZE_HANDLE_INNER).addClass(
instance.CSS_INNER_HANDLE_MAP[handle]
);
instance._setupHandleDD(handle, node);
return node;
},
/**
* Helper method to update the current values on
* <a href="Resize.html#property_info">info</a> to respect the
* constrain node.
*
* @method _checkConstrain
* @param {String} axis 'top' or 'left'
* @param {String} axisConstrain 'bottom' or 'right'
* @param {String} offset 'offsetHeight' or 'offsetWidth'
* @protected
*/
_checkConstrain: function(axis, axisConstrain, offset) {
var instance = this;
var info = instance.info;
var region = instance._getConstrainRegion();
if (region) {
var point1 = info[axis] + info[offset];
var point1Constrain = region[axisConstrain] - instance.constrainBorderInfo[axisConstrain];
if (point1 >= point1Constrain) {
info[offset] -= (point1 - point1Constrain);
}
var point2 = info[axis];
var point2Constrain = region[axis] + instance.constrainBorderInfo[axis];
if (point2 <= point2Constrain) {
info[axis] += (point2Constrain - point2);
info[offset] -= (point2Constrain - point2);
}
}
},
/**
* Update the current values on <a href="Resize.html#property_info">info</a>
* to respect the maxHeight and minHeight.
*
* @method _checkHeight
* @protected
*/
_checkHeight: function() {
var instance = this;
var info = instance.info;
var originalInfo = instance.originalInfo;
var maxHeight = instance.get(MAX_HEIGHT);
var minHeight = instance.get(MIN_HEIGHT);
instance._checkConstrain(TOP, BOTTOM, OFFSET_HEIGHT);
var isMaxHeight = (info.offsetHeight > maxHeight);
var isMinHeight = (info.offsetHeight < minHeight);
if (isMaxHeight) {
info.offsetHeight = maxHeight;
if (instance.changeTopHandles) {
// predicting, based on the original information, the last top valid in case of reach the min/max dimension
// this calculation avoid browser event leaks when user interact very fast with their mouse
info.top = originalInfo.top + originalInfo.offsetHeight - maxHeight;
}
}
if (isMinHeight) {
info.offsetHeight = minHeight;
if (instance.changeTopHandles) {
// predicting, based on the original information, the last top valid in case of reach the min/max dimension
// this calculation avoid browser event leaks when user interact very fast with their mouse
info.top = originalInfo.top + originalInfo.offsetHeight - minHeight;
}
}
},
/**
* Update the current values on <a href="Resize.html#property_info">info</a>
* calculating the correct ratio for the other values.
*
* @method _checkRatio
* @protected
*/
_checkRatio: function() {
var instance = this;
var info = instance.info;
var originalInfo = instance.originalInfo;
var oWidth = originalInfo.offsetWidth;
var oHeight = originalInfo.offsetHeight;
var oTop = originalInfo.top;
var oLeft = originalInfo.left;
// wRatio/hRatio functions keep the ratio information always synced with the current info information
// RETURN: percentage how much width/height has changed from the original width/height
var wRatio = function() {
return (info.offsetWidth/oWidth);
};
var hRatio = function() {
return (info.offsetHeight/oHeight);
};
// handles which only change the height, need to vary the width first
// and then check width to constrain to max/min dimensions
if (instance.changeHeightHandles) {
info.offsetWidth = oWidth*hRatio();
instance._checkWidth();
info.offsetHeight = oHeight*wRatio();
}
// handles which are able to change the width need to vary the height first
// and then check height to constrain to max/min dimensions
else if (instance.changeWidthHandles) {
info.offsetHeight = oHeight*wRatio();
instance._checkHeight();
info.offsetWidth = oWidth*hRatio();
}
// fixing the top on handles which are able to change top
// the idea here is change the top based on how much the height has changed instead of follow the dy
if (instance.changeTopHandles) {
info.top = oTop + (oHeight - info.offsetHeight);
}
// fixing the left on handles which are able to change left
// the idea here is change the left based on how much the width has changed instead of follow the dx
if (instance.changeLeftHandles) {
info.left = oLeft + (oWidth - info.offsetWidth);
}
},
/**
* Check whether the resizable node is inside the constrain region.
*
* @method _checkRegion
* @protected
* @return {boolean}
*/
_checkRegion: function() {
var instance = this;
var region = instance._getConstrainRegion();
return A.DOM.inRegion(null, region, true, instance.info);
},
/**
* Update the current values on <a href="Resize.html#property_info">info</a>
* to respect the maxWidth and minWidth.
*
* @method _checkWidth
* @protected
*/
_checkWidth: function() {
var instance = this;
var info = instance.info;
var originalInfo = instance.originalInfo;
var maxWidth = instance.get(MAX_WIDTH);
var minWidth = instance.get(MIN_WIDTH);
instance._checkConstrain(LEFT, RIGHT, OFFSET_WIDTH);
var isMaxWidth = (info.offsetWidth > maxWidth);
var isMinWidth = (info.offsetWidth < minWidth);
if (isMaxWidth) {
info.offsetWidth = maxWidth;
if (instance.changeLeftHandles) {
// predicting, based on the original information, the last left valid in case of reach the min/max dimension
// this calculation avoid browser event leaks when user interact very fast with their mouse
info.left = originalInfo.left + originalInfo.offsetWidth - maxWidth;
}
}
if (isMinWidth) {
info.offsetWidth = minWidth;
if (instance.changeLeftHandles) {
// predicting, based on the original information, the last left valid in case of reach the min/max dimension
// this calculation avoid browser event leaks when user interact very fast with their mouse
info.left = originalInfo.left + originalInfo.offsetWidth - minWidth;
}
}
},
/**
* Copy relevant styles of the <a href="Resize.html#config_node">node</a>
* to the <a href="Resize.html#config_wrapper">wrapper</a>.
*
* @method _copyStyles
* @param {Node} node Node from.
* @param {Node} wrapper Node to.
* @protected
*/
_copyStyles: function(node, wrapper) {
var instance = this;
var position = node.getStyle(POSITION).toLowerCase();
// resizable wrapper should be positioned
if (position == STATIC) {
position = RELATIVE;
}
// copy margin, padding, position styles from the node to wrapper
var wrapperStyle = {
position: position
};
var nodeStyle = {};
// store margin(Top,Right,Bottom,Left) from the nodes involved
// apply margin from node to the wrapper
A.each([ TOP, RIGHT, BOTTOM, LEFT ], function(dir) {
var name = MARGIN + toInitialCap(dir);
nodeStyle[name] = wrapper.getStyle(name);
wrapperStyle[name] = node.getStyle(name);
});
wrapper.setStyles(wrapperStyle);
node.setStyles(nodeStyle);
// force remove margin from the internal node
node.setStyles({ margin: 0 });
wrapper.set(
OFFSET_HEIGHT,
node.get(OFFSET_HEIGHT)
);
wrapper.set(
OFFSET_WIDTH,
node.get(OFFSET_WIDTH)
);
},
// extract handle name from a string
// using A.cached to memoize the function for performance
_extractHandleName: A.cached(
function(node) {
var className = node.get(CLASS_NAME);
var match = className.match(
new RegExp(
getCN(RESIZE, HANDLE, '(\\w{1,2})\\b')
)
);
return match ? match[1] : null;
}
),
/**
* Get the constrain region based on the <code>constrain</code>
* attribute.
*
* @method _getConstrainRegion
* @protected
* @return {Object Region}
*/
_getConstrainRegion: function() {
var instance = this;
var node = instance.get(NODE);
var constrain = instance.get(CONSTRAIN);
var region = null;
if (constrain) {
if (constrain == VIEW) {
region = node.get(VIEWPORT_REGION);
}
else if (isNode(constrain)) {
region = constrain.get(REGION);
}
else {
region = constrain;
}
}
return region;
},
/**
* <p>Generates metadata to the <a href="Resize.html#property_info">info</a>
* and <a href="Resize.html#property_originalInfo">originalInfo</a></p>
* <pre><code>bottom, actXY, left, top, offsetHeight, offsetWidth, right</code></pre>
*
* @method _getInfo
* @param {Node} node
* @param {EventFacade} event
* @private
*/
_getInfo: function(node, event) {
var instance = this, actXY;
var drag = event.dragEvent.target;
if (event) {
// the xy that the node will be set to. Changing this will alter the position as it's dragged.
actXY = (drag.actXY.length ? drag.actXY : drag.lastXY);
}
var nodeXY = node.getXY();
var nodeX = nodeXY[0];
var nodeY = nodeXY[1];
var offsetHeight = node.get(OFFSET_HEIGHT);
var offsetWidth = node.get(OFFSET_WIDTH);
return {
actXY: actXY,
bottom: (nodeY + offsetHeight),
left: nodeX,
offsetHeight: offsetHeight,
offsetWidth: offsetWidth,
right: (nodeX + offsetWidth),
top: nodeY
};
},
/**
* Update left and top information on
* <a href="Resize.html#property_info">info</a> based on the new top and left.
*
* @method _recalculateXY
* @private
*/
_recalculateXY: function() {
var instance = this;
var info = instance.info;
var originalInfo = instance.originalInfo;
info.left = originalInfo.left + (info.left - originalInfo.left);
info.top = originalInfo.top + (info.top - originalInfo.top);
},
/**
* Basic resize calculations.
*
* @method _resize
* @protected
*/
_resize: function() {
var instance = this;
var handle = instance.get(ACTIVE_HANDLE);
var info = instance.info;
var originalInfo = instance.originalInfo;
var dx = info.actXY[0] - originalInfo.actXY[0];
var dy = info.actXY[1] - originalInfo.actXY[1];
var rules = {
t: function() {
info.top = originalInfo.top + dy;
info.offsetHeight = originalInfo.offsetHeight - dy;
},
r: function() {
info.offsetWidth = originalInfo.offsetWidth + dx;
},
l: function() {
info.left = originalInfo.left + dx;
info.offsetWidth = originalInfo.offsetWidth - dx;
},
b: function() {
info.offsetHeight = originalInfo.offsetHeight + dy;
},
tr: function() {
this.t();
this.r();
},
br: function() {
this.b();
this.r();
},
tl: function() {
this.t();
this.l();
},
bl: function() {
this.b();
this.l();
}
};
rules[handle](dx, dy);
},
/**
* Initialize the DragDrop on the handle.
*
* @method _setupHandleDD
* @param {String} handle Handle name.
* @param {Node} node Node reference which the DragDrop will be created.
* @private
*/
_setupHandleDD: function(handle, node) {
var instance = this;
var dd = new A.DD.Drag(
{
bubbleTargets: instance,
clickPixelThresh: 0,
clickTimeThresh: 0,
data: {
handle: handle,
node: node
},
node: node,
useShim: true,
move: false
}
);
dd.plug(
A.Plugin.DDConstrained,
{
stickX: (handle == R || handle == L),
stickY: (handle == T || handle == B),
tickX: instance.get(TICK_X),
tickY: instance.get(TICK_Y)
}
);
},
/**
* Set offsetWidth and offsetHeight of the passed node.
*
* @method _setOffset
* @param {Node} node Node
* @param {number} offsetWidth
* @param {number} offsetHeight
* @protected
*/
_setOffset: function(node, offsetWidth, offsetHeight) {
node.set(OFFSET_WIDTH, offsetWidth);
node.set(OFFSET_HEIGHT, offsetHeight);
},
/**
* Sync the Resize UI with internal values from
* <a href="Resize.html#property_info">info</a>.
*
* @method _syncUI
* @protected
*/
_syncUI: function() {
var instance = this;
var info = instance.info;
var wrapper = instance.get(WRAPPER);
var node = instance.get(NODE);
instance._setOffset(wrapper, info.offsetWidth, info.offsetHeight);
if (instance.changeLeftHandles || instance.changeTopHandles) {
wrapper.setXY([info.left, info.top]);
}
// if wrapper is different from node
if (!wrapper.compareTo(node)) {
instance._setOffset(node, info.offsetWidth, info.offsetHeight);
}
// prevent webkit textarea resize
if (A.UA.webkit) {
node.setStyle(RESIZE, NONE);
}
},
/**
* Sync the proxy UI with internal values from
* <a href="Resize.html#property_info">info</a>.
*
* @method _syncProxyUI
* @protected
*/
_syncProxyUI: function() {
var instance = this;
var info = instance.info;
var activeHandleEl = instance.get(ACTIVE_HANDLE_EL);
var proxyEl = instance.get(PROXY_EL);
var cursor = activeHandleEl.getStyle(CURSOR);
proxyEl.show().setStyle(CURSOR, cursor);
activeHandleEl.dd.set(DRAG_CURSOR, cursor);
instance._setOffset(proxyEl, info.offsetWidth, info.offsetHeight);
proxyEl.setXY([ info.left, info.top ]);
},
/**
* Update <code>instance.changeHeightHandles,
* instance.changeLeftHandles, instance.changeTopHandles,
* instance.changeWidthHandles</code> information.
*
* @method _updateChangeHandleInfo
* @private
*/
_updateChangeHandleInfo: function(handle) {
var instance = this;
instance.changeHeightHandles = REGEX_CHANGE_HEIGHT.test(handle);
instance.changeLeftHandles = REGEX_CHANGE_LEFT.test(handle);
instance.changeTopHandles = REGEX_CHANGE_TOP.test(handle);
instance.changeWidthHandles = REGEX_CHANGE_WIDTH.test(handle);
},
/**
* Update <code>instance.constrainBorderInfo</code> values (bottom,
* left, top, right).
*
* @method _updateConstrainBorderInfo
* @private
*/
_updateConstrainBorderInfo: function() {
var instance = this;
var constrain = instance.get(CONSTRAIN);
if (isNode(constrain)) {
var getStyle = function(val) {
return parseFloat(constrain.getStyle(val)) || 0;
};
instance.constrainBorderInfo.bottom = getStyle(BORDER_BOTTOM_WIDTH);
instance.constrainBorderInfo.left = getStyle(BORDER_LEFT_WIDTH);
instance.constrainBorderInfo.right = getStyle(BORDER_RIGHT_WIDTH);
instance.constrainBorderInfo.top = getStyle(BORDER_TOP_WIDTH);
}
},
/**
* Update <a href="Resize.html#property_info">info</a> values (bottom, actXY, left, top, offsetHeight, offsetWidth, right).
*
* @method _updateInfo
* @private
*/
_updateInfo: function(event) {
var instance = this;
instance.info = instance._getInfo(
instance.get(WRAPPER),
event
);
},
/**
* Set the active state of the handles.
*
* @method _setActiveHandlesUI
* @param {boolean} val True to activate the handles, false to deactivate.
* @protected
*/
_setActiveHandlesUI: function(val) {
var instance = this;
var activeHandleEl = instance.get(ACTIVE_HANDLE_EL);
if (activeHandleEl) {
if (val) {
// remove CSS_RESIZE_HANDLE_ACTIVE from all handles before addClass on the active
instance.eachHandle(
function(handleEl) {
handleEl.removeClass(CSS_RESIZE_HANDLE_ACTIVE);
}
);
activeHandleEl.addClass(CSS_RESIZE_HANDLE_ACTIVE);
}
else {
activeHandleEl.removeClass(CSS_RESIZE_HANDLE_ACTIVE);
}
}
},
/**
* Set the visibility of the handles.
*
* @method _setHideHandlesUI
* @param {boolean} val True to hide the handles, false to show.
* @protected
*/
_setHideHandlesUI: function(val) {
var instance = this;
var wrapper = instance.get(WRAPPER);
if (!instance.get(RESIZING)) {
if (val) {
wrapper.addClass(CSS_RESIZE_HIDDEN_HANDLES);
}
else {
wrapper.removeClass(CSS_RESIZE_HIDDEN_HANDLES);
}
}
},
/**
* Default resize:mouseUp handler
*
* @method _defMouseUpFn
* @param {EventFacade} event The Event object
* @protected
*/
_defMouseUpFn: function(event) {
var instance = this;
instance.set(RESIZING, false);
},
/**
* Default resize:resize handler
*
* @method _defResizeFn
* @param {EventFacade} event The Event object
* @protected
*/
_defResizeFn: function(event) {
var instance = this;
var infoBefore = instance.info;
// update the instance.info values
instance._updateInfo(event);
// basic resize calculations
instance._resize();
// check the max/min height and locking top when these values are reach
instance._checkHeight();
// check the max/min width and locking left when these values are reach
instance._checkWidth();
// calculating the ratio, for proportionally resizing
if (instance.get(PRESEVE_RATIO)) {
instance._checkRatio();
}
// left and top information need to be updated based on the new top/left
// top/top is used to position the proxyEl
instance._recalculateXY();
if (instance.get(CONSTRAIN) && !instance._checkRegion()) {
instance.info = infoBefore;
}
},
/**
* Default resize:end handler
*
* @method _defResizeEndFn
* @param {EventFacade} event The Event object
* @protected
*/
_defResizeEndFn: function(event) {
var instance = this;
var drag = event.dragEvent.target;
// reseting actXY from drag when drag end
drag.actXY = [];
// if proxy is true, hide it on resize end
if (instance.get(PROXY)) {
instance._syncProxyUI();
instance.get(PROXY_EL).hide();
}
// syncUI when resize end
instance._syncUI();
instance.set(ACTIVE_HANDLE, null);
instance.set(ACTIVE_HANDLE_EL, null);
instance._setActiveHandlesUI(false);
},
/**
* Default resize:start handler
*
* @method _defResizeStartFn
* @param {EventFacade} event The Event object
* @protected
*/
_defResizeStartFn: function(event) {
var instance = this;
instance.set(RESIZING, true);
// create an originalInfo information for reference
instance.originalInfo = instance._getInfo(
instance.get(WRAPPER),
event
);
instance._updateInfo(event);
instance._updateConstrainBorderInfo();
},
/**
* Fires after resize:resize event.
*
* @method _afterResize
* @param {EventFacade} event resize:resize custom event
* @protected
*/
_afterResize: function(event) {
var instance = this;
// if proxy is true _syncProxyUI instead of _syncUI
if (instance.get(PROXY)) {
instance._syncProxyUI();
}
else {
// _syncUI of the wrapper, not using proxy
instance._syncUI();
}
},
/**
* Fires the resize:mouseUp event.
*
* @method _handleMouseUpEvent
* @param {EventFacade} event resize:mouseUp event facade
* @protected
*/
_handleMouseUpEvent: function(event) {
this.fire(EV_MOUSE_UP, { dragEvent: event, info: this.info });
},
/**
* Fires the resize:resize event.
*
* @method _handleResizeEvent
* @param {EventFacade} event resize:resize event facade
* @protected
*/
_handleResizeEvent: function(event) {
this.fire(EV_RESIZE, { dragEvent: event, info: this.info });
},
/**
* Fires the resize:end event.
*
* @method _handleResizeEndEvent
* @param {EventFacade} event resize:end event facade
* @protected
*/
_handleResizeEndEvent: function(event) {
this.fire(EV_RESIZE_END, { dragEvent: event, info: this.info });
},
/**
* Fires the resize:start event.
*
* @method _handleResizeStartEvent
* @param {EventFacade} event resize:start event facade
* @protected
*/
_handleResizeStartEvent: function(event) {
this.fire(EV_RESIZE_START, { dragEvent: event, info: this.info });
},
/**
* Mouseenter event handler for the <a href="Resize.html#config_wrapper">wrapper</a>.
*
* @method _onWrapperMouseEnter
* @param {EventFacade} event
* @protected
*/
_onWrapperMouseEnter: function(event) {
var instance = this;
if (instance.get(AUTO_HIDE)) {
instance._setHideHandlesUI(false);
}
},
/**
* Mouseleave event handler for the <a href="Resize.html#config_wrapper">wrapper</a>.
*
* @method _onWrapperMouseLeave
* @param {EventFacade} event
* @protected
*/
_onWrapperMouseLeave: function(event) {
var instance = this;
if (instance.get(AUTO_HIDE)) {
instance._setHideHandlesUI(true);
}
},
/**
* Mouseover event handler for the handles.
*
* @method _onHandleMouseOver
* @param {EventFacade} event
* @protected
*/
_onHandleMouseOver: function(event) {
var instance = this;
var node = event.currentTarget;
var handle = instance._extractHandleName(node);
if (!instance.get(RESIZING)) {
instance.set(ACTIVE_HANDLE, handle);
instance.set(ACTIVE_HANDLE_EL, node);
instance._setActiveHandlesUI(true);
instance._updateChangeHandleInfo(handle);
}
},
/**
* Mouseout event handler for the handles.
*
* @method _onHandleMouseOut
* @param {EventFacade} event
* @protected
*/
_onHandleMouseOut: function(event) {
var instance = this;
if (!instance.get(RESIZING)) {
instance._setActiveHandlesUI(false);
}
}
}
}
);
A.each(ALL_HANDLES, function(handle, i) {
// creating ATTRS with the handles elements
Resize.ATTRS[handleAttrName(handle)] = {
setter: function() {
return this._buildHandle(handle);
},
value: null,
writeOnce: true
};
});
A.Resize = Resize;
}, '@VERSION@' ,{requires:['aui-base','dd-constrain','dd-drag','dd-drop','substitute'], skinnable:true});