resize/js/resize-base.js

	resize-base.js revision cc1d4edffd5ecfd11d5b68c5d24988d0cfb2371a
6a67d144095c31bbafed93cec1619590157335eajvergara/**
6a67d144095c31bbafed93cec1619590157335eajvergara * The Resize Utility allows you to make an HTML element resizable.
6a67d144095c31bbafed93cec1619590157335eajvergara *
6a67d144095c31bbafed93cec1619590157335eajvergara * @module resize
6a67d144095c31bbafed93cec1619590157335eajvergara */
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergaravar Lang = Y.Lang,
6a67d144095c31bbafed93cec1619590157335eajvergara    isArray = Lang.isArray,
8cf870d281dc8c242f083d14dfef05f24aa5fceeJnRouvignac    isBoolean = Lang.isBoolean,
8cf870d281dc8c242f083d14dfef05f24aa5fceeJnRouvignac    isNumber = Lang.isNumber,
6a67d144095c31bbafed93cec1619590157335eajvergara    isString = Lang.isString,
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara    trim = Lang.trim,
6a67d144095c31bbafed93cec1619590157335eajvergara    indexOf = Y.Array.indexOf,
8cf870d281dc8c242f083d14dfef05f24aa5fceeJnRouvignac
8cf870d281dc8c242f083d14dfef05f24aa5fceeJnRouvignac    DOT = '.',
8cf870d281dc8c242f083d14dfef05f24aa5fceeJnRouvignac    COMMA = ',',
8cf870d281dc8c242f083d14dfef05f24aa5fceeJnRouvignac    SPACE = ' ',
6a67d144095c31bbafed93cec1619590157335eajvergara    HANDLE_SUB = '{handle}',
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara    ACTIVE = 'active',
6a67d144095c31bbafed93cec1619590157335eajvergara    ACTIVE_HANDLE = 'activeHandle',
6a67d144095c31bbafed93cec1619590157335eajvergara    ACTIVE_HANDLE_NODE = 'activeHandleNode',
f14a485fcb48f77d077a14b766f0acc097093fe5jvergara    ALL = 'all',
a5b9f8fb834b1b2208e59a2fa76714bd91a5f147violette    AUTO_HIDE = 'autoHide',
6a67d144095c31bbafed93cec1619590157335eajvergara    BOTTOM = 'bottom',
6a67d144095c31bbafed93cec1619590157335eajvergara    CLASS_NAME = 'className',
6a67d144095c31bbafed93cec1619590157335eajvergara    CURSOR = 'cursor',
6a67d144095c31bbafed93cec1619590157335eajvergara    DEF_MIN_HEIGHT = 'defMinHeight',
6a67d144095c31bbafed93cec1619590157335eajvergara    DEF_MIN_WIDTH = 'defMinWidth',
6a67d144095c31bbafed93cec1619590157335eajvergara    DRAG_CURSOR = 'dragCursor',
6a67d144095c31bbafed93cec1619590157335eajvergara    HANDLE = 'handle',
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter    HANDLES = 'handles',
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter    HIDDEN = 'hidden',
6a67d144095c31bbafed93cec1619590157335eajvergara    INNER = 'inner',
6a67d144095c31bbafed93cec1619590157335eajvergara    LEFT = 'left',
6a67d144095c31bbafed93cec1619590157335eajvergara    MARGIN = 'margin',
6a67d144095c31bbafed93cec1619590157335eajvergara    NODE = 'node',
6a67d144095c31bbafed93cec1619590157335eajvergara    NODE_NAME = 'nodeName',
5b9085a87d43ed3ae0b149a9c79ba57723733185jvergara    NONE = 'none',
6a67d144095c31bbafed93cec1619590157335eajvergara    OFFSET_HEIGHT = 'offsetHeight',
0877596da3b90efc5fd39171cef80a2fb8ec395ekenneth_suter    OFFSET_WIDTH = 'offsetWidth',
6a67d144095c31bbafed93cec1619590157335eajvergara    PARENT_NODE = 'parentNode',
6a67d144095c31bbafed93cec1619590157335eajvergara    POSITION = 'position',
6a67d144095c31bbafed93cec1619590157335eajvergara    PROXY = 'proxy',
0877596da3b90efc5fd39171cef80a2fb8ec395ekenneth_suter    PROXY_NODE = 'proxyNode',
53247d28ba99538f841a13ea2cde01c3faa3ef36kenneth_suter    RELATIVE = 'relative',
6a67d144095c31bbafed93cec1619590157335eajvergara    RESIZE = 'resize',
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter    RESIZING = 'resizing',
6a67d144095c31bbafed93cec1619590157335eajvergara    RIGHT = 'right',
6a67d144095c31bbafed93cec1619590157335eajvergara    STATIC = 'static',
6a67d144095c31bbafed93cec1619590157335eajvergara    TOP = 'top',
6a67d144095c31bbafed93cec1619590157335eajvergara    WRAP = 'wrap',
6a67d144095c31bbafed93cec1619590157335eajvergara    WRAPPER = 'wrapper',
6a67d144095c31bbafed93cec1619590157335eajvergara    WRAP_TYPES = 'wrapTypes',
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter
6a67d144095c31bbafed93cec1619590157335eajvergara    EV_MOUSE_UP = 'resize:mouseUp',
6a67d144095c31bbafed93cec1619590157335eajvergara    EV_RESIZE = 'resize:resize',
6a67d144095c31bbafed93cec1619590157335eajvergara    EV_RESIZE_ALIGN = 'resize:align',
6a67d144095c31bbafed93cec1619590157335eajvergara    EV_RESIZE_END = 'resize:end',
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter    EV_RESIZE_START = 'resize:start',
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter    T = 't',
6a67d144095c31bbafed93cec1619590157335eajvergara    TR = 'tr',
6a67d144095c31bbafed93cec1619590157335eajvergara    R = 'r',
6a67d144095c31bbafed93cec1619590157335eajvergara    BR = 'br',
6a67d144095c31bbafed93cec1619590157335eajvergara    B = 'b',
6a67d144095c31bbafed93cec1619590157335eajvergara    BL = 'bl',
6a67d144095c31bbafed93cec1619590157335eajvergara    L = 'l',
6a67d144095c31bbafed93cec1619590157335eajvergara    TL = 'tl',
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara    isNode = function(v) {
6a67d144095c31bbafed93cec1619590157335eajvergara        return (v instanceof Y.Node);
6a67d144095c31bbafed93cec1619590157335eajvergara    },
6a67d144095c31bbafed93cec1619590157335eajvergara
3e6ff045d382a718a951d6305c8910ffc268f893kenneth_suter    handleAttrName = function(handle) {
6a67d144095c31bbafed93cec1619590157335eajvergara        return HANDLE + handle.toUpperCase();
6a67d144095c31bbafed93cec1619590157335eajvergara    },
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara    concat = function() {
6a67d144095c31bbafed93cec1619590157335eajvergara        return Array.prototype.slice.call(arguments).join(SPACE);
6a67d144095c31bbafed93cec1619590157335eajvergara    },
857225469c51bedb8c0566aa7757800cfaac4075kenneth_suter
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter    toInitialCap = Y.cached(
0142bbb7ccb5d0efb942c20f5d27e5ddfb4344fdkenneth_suter        function(str) {
0142bbb7ccb5d0efb942c20f5d27e5ddfb4344fdkenneth_suter            return str.substring(0, 1).toUpperCase() + str.substring(1);
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter        }
2401d3c2af505789c7c3b860a43e973f27731243jvergara    ),
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara    getCN = Y.ClassNameManager.getClassName,
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter    CSS_RESIZE = getCN(RESIZE),
0142bbb7ccb5d0efb942c20f5d27e5ddfb4344fdkenneth_suter    CSS_RESIZE_HANDLE = getCN(RESIZE, HANDLE),
6a67d144095c31bbafed93cec1619590157335eajvergara    CSS_RESIZE_HANDLE_ACTIVE = getCN(RESIZE, HANDLE, ACTIVE),
857225469c51bedb8c0566aa7757800cfaac4075kenneth_suter    CSS_RESIZE_HANDLE_INNER = getCN(RESIZE, HANDLE, INNER),
0142bbb7ccb5d0efb942c20f5d27e5ddfb4344fdkenneth_suter    CSS_RESIZE_HANDLE_INNER_PLACEHOLDER = getCN(RESIZE, HANDLE, INNER, HANDLE_SUB),
0142bbb7ccb5d0efb942c20f5d27e5ddfb4344fdkenneth_suter    CSS_RESIZE_HANDLE_PLACEHOLDER = getCN(RESIZE, HANDLE, HANDLE_SUB),
6a67d144095c31bbafed93cec1619590157335eajvergara    CSS_RESIZE_HIDDEN_HANDLES = getCN(RESIZE, HIDDEN, HANDLES),
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter    CSS_RESIZE_PROXY = getCN(RESIZE, PROXY),
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter    CSS_RESIZE_WRAPPER = getCN(RESIZE, WRAPPER);
6a67d144095c31bbafed93cec1619590157335eajvergara
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter/**
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter * A base class for Resize, providing:
0142bbb7ccb5d0efb942c20f5d27e5ddfb4344fdkenneth_suter * <ul>
53247d28ba99538f841a13ea2cde01c3faa3ef36kenneth_suter *    <li>Basic Lifecycle (initializer, renderUI, bindUI, syncUI, destructor)</li>
6a67d144095c31bbafed93cec1619590157335eajvergara *    <li>Applies drag handles to an element to make it resizable</li>
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter *    <li>Here is the list of valid resize handles:
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter *        <code>[ 't', 'tr', 'r', 'br', 'b', 'bl', 'l', 'tl' ]</code>. You can
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter *        read this list as top, top-right, right, bottom-right, bottom,
6a67d144095c31bbafed93cec1619590157335eajvergara *        bottom-left, left, top-left.</li>
6a67d144095c31bbafed93cec1619590157335eajvergara *    <li>The drag handles are inserted into the element and positioned
5b9085a87d43ed3ae0b149a9c79ba57723733185jvergara *        absolute. Some elements, such as a textarea or image, don't support
c6c8254710feb80354037c2afb8d1cdae930a27akenneth_suter *        children. To overcome that, set wrap:true in your config and the
6a67d144095c31bbafed93cec1619590157335eajvergara *        element willbe wrapped for you automatically.</li>
6a67d144095c31bbafed93cec1619590157335eajvergara * </ul>
6a67d144095c31bbafed93cec1619590157335eajvergara *
6a67d144095c31bbafed93cec1619590157335eajvergara * Quick Example:
6a67d144095c31bbafed93cec1619590157335eajvergara *
6a67d144095c31bbafed93cec1619590157335eajvergara * <pre><code>var instance = new Y.Resize({
6a67d144095c31bbafed93cec1619590157335eajvergara *  node: '#resize1',
6a67d144095c31bbafed93cec1619590157335eajvergara *  proxy: true,
6a67d144095c31bbafed93cec1619590157335eajvergara *  preserveRatio: true,
6a67d144095c31bbafed93cec1619590157335eajvergara *  wrap: true,
6a67d144095c31bbafed93cec1619590157335eajvergara *  maxHeight: 170,
a7d59bf59f3b588e70b86d920e0ab271496f4f06kenneth_suter *  maxWidth: 400,
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter *  handles: 't, tr, r, br, b, bl, l, tl'
6a67d144095c31bbafed93cec1619590157335eajvergara * });
6a67d144095c31bbafed93cec1619590157335eajvergara * </code></pre>
6a67d144095c31bbafed93cec1619590157335eajvergara *
6a67d144095c31bbafed93cec1619590157335eajvergara * Check the list of <a href="Resize.html#configattributes">Configuration Attributes</a> available for
6a67d144095c31bbafed93cec1619590157335eajvergara * Resize.
6a67d144095c31bbafed93cec1619590157335eajvergara *
2401d3c2af505789c7c3b860a43e973f27731243jvergara * @class Resize
2401d3c2af505789c7c3b860a43e973f27731243jvergara * @param config {Object} Object literal specifying widget configuration properties.
2401d3c2af505789c7c3b860a43e973f27731243jvergara * @constructor
2401d3c2af505789c7c3b860a43e973f27731243jvergara * @extends Base
2401d3c2af505789c7c3b860a43e973f27731243jvergara */
2401d3c2af505789c7c3b860a43e973f27731243jvergarafunction Resize() {
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter    Resize.superclass.constructor.apply(this, arguments);
2401d3c2af505789c7c3b860a43e973f27731243jvergara}
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter
faf590fc96c28da606c8802466a4d95bd940a495jvergaraY.mix(Resize, {
2401d3c2af505789c7c3b860a43e973f27731243jvergara    /**
2401d3c2af505789c7c3b860a43e973f27731243jvergara     * Static property provides a string to identify the class.
2401d3c2af505789c7c3b860a43e973f27731243jvergara     *
a7d59bf59f3b588e70b86d920e0ab271496f4f06kenneth_suter     * @property Resize.NAME
2401d3c2af505789c7c3b860a43e973f27731243jvergara     * @type String
2401d3c2af505789c7c3b860a43e973f27731243jvergara     * @static
2401d3c2af505789c7c3b860a43e973f27731243jvergara     */
6a67d144095c31bbafed93cec1619590157335eajvergara    NAME: RESIZE,
6a67d144095c31bbafed93cec1619590157335eajvergara
0877596da3b90efc5fd39171cef80a2fb8ec395ekenneth_suter    /**
6a67d144095c31bbafed93cec1619590157335eajvergara     * Static property used to define the default attribute
0877596da3b90efc5fd39171cef80a2fb8ec395ekenneth_suter     * configuration for the Resize.
6a67d144095c31bbafed93cec1619590157335eajvergara     *
6a67d144095c31bbafed93cec1619590157335eajvergara     * @property Resize.ATTRS
3e6ff045d382a718a951d6305c8910ffc268f893kenneth_suter     * @type Object
6a67d144095c31bbafed93cec1619590157335eajvergara     * @static
6a67d144095c31bbafed93cec1619590157335eajvergara     */
11178d20048abeee671d0cdb2aab6dfbaa36293bjvergara    ATTRS: {
0142bbb7ccb5d0efb942c20f5d27e5ddfb4344fdkenneth_suter        /**
11178d20048abeee671d0cdb2aab6dfbaa36293bjvergara         * Stores the active handle during the resize.
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute activeHandle
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default null
6a67d144095c31bbafed93cec1619590157335eajvergara         * @private
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type String
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        activeHandle: {
3e6ff045d382a718a951d6305c8910ffc268f893kenneth_suter            value: null,
6a67d144095c31bbafed93cec1619590157335eajvergara            validator: isString
6a67d144095c31bbafed93cec1619590157335eajvergara        },
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Stores the active handle element during the resize.
0877596da3b90efc5fd39171cef80a2fb8ec395ekenneth_suter         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute activeHandleNode
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default null
6a67d144095c31bbafed93cec1619590157335eajvergara         * @private
0877596da3b90efc5fd39171cef80a2fb8ec395ekenneth_suter         * @type Node
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara         */
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara        activeHandleNode: {
0877596da3b90efc5fd39171cef80a2fb8ec395ekenneth_suter            value: null,
0877596da3b90efc5fd39171cef80a2fb8ec395ekenneth_suter            validator: isNode
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara        },
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara        /**
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara         * False to ensure that the resize handles are always visible, true to
6a67d144095c31bbafed93cec1619590157335eajvergara         * display them only when the user mouses over the resizable borders.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute autoHide
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default false
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type boolean
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        autoHide: {
6a67d144095c31bbafed93cec1619590157335eajvergara            value: false,
53247d28ba99538f841a13ea2cde01c3faa3ef36kenneth_suter            validator: isBoolean
6a67d144095c31bbafed93cec1619590157335eajvergara        },
a7d59bf59f3b588e70b86d920e0ab271496f4f06kenneth_suter
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * The default minimum height of the element. Only used when
6a67d144095c31bbafed93cec1619590157335eajvergara         * ResizeConstrained is not plugged.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute defMinHeight
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default 15
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type Number
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        defMinHeight: {
6a67d144095c31bbafed93cec1619590157335eajvergara            value: 15,
6a67d144095c31bbafed93cec1619590157335eajvergara            validator: isNumber
6a67d144095c31bbafed93cec1619590157335eajvergara        },
53247d28ba99538f841a13ea2cde01c3faa3ef36kenneth_suter
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
a7d59bf59f3b588e70b86d920e0ab271496f4f06kenneth_suter         * The default minimum width of the element. Only used when
6a67d144095c31bbafed93cec1619590157335eajvergara         * ResizeConstrained is not plugged.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute defMinWidth
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default 15
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type Number
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        defMinWidth: {
6a67d144095c31bbafed93cec1619590157335eajvergara            value: 15,
6a67d144095c31bbafed93cec1619590157335eajvergara            validator: isNumber
6a67d144095c31bbafed93cec1619590157335eajvergara        },
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * The handles to use (any combination of): 't', 'b', 'r', 'l', 'bl',
6a67d144095c31bbafed93cec1619590157335eajvergara         * 'br', 'tl', 'tr'. Can use a shortcut of All.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute handles
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default all
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type Array | String
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        handles: {
6a67d144095c31bbafed93cec1619590157335eajvergara            setter: '_setHandles',
6a67d144095c31bbafed93cec1619590157335eajvergara            value: ALL
6a67d144095c31bbafed93cec1619590157335eajvergara        },
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * The selector or element to resize. Required.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute node
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type Node
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        node: {
6a67d144095c31bbafed93cec1619590157335eajvergara            setter: Y.one
2401d3c2af505789c7c3b860a43e973f27731243jvergara        },
2401d3c2af505789c7c3b860a43e973f27731243jvergara
2401d3c2af505789c7c3b860a43e973f27731243jvergara        /**
2401d3c2af505789c7c3b860a43e973f27731243jvergara         * Resize a proxy element instead of the real element.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute proxy
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default false
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type boolean
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        proxy: {
6a67d144095c31bbafed93cec1619590157335eajvergara            value: false,
6a67d144095c31bbafed93cec1619590157335eajvergara            validator: isBoolean
6a67d144095c31bbafed93cec1619590157335eajvergara        },
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * The Resize proxy element.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute proxyNode
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default Generated using an internal HTML markup
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type String | Node
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        proxyNode: {
6a67d144095c31bbafed93cec1619590157335eajvergara            setter: Y.one,
6a67d144095c31bbafed93cec1619590157335eajvergara            valueFn: function() {
7056ae8910decb0d96b430451ac58b99526eb0d9jvergara                return Y.Node.create(this.PROXY_TEMPLATE);
6a67d144095c31bbafed93cec1619590157335eajvergara            }
6a67d144095c31bbafed93cec1619590157335eajvergara        },
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * True when the element is being Resized.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute resizing
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default false
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type boolean
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        resizing: {
6a67d144095c31bbafed93cec1619590157335eajvergara            value: false,
6a67d144095c31bbafed93cec1619590157335eajvergara            validator: isBoolean
6a67d144095c31bbafed93cec1619590157335eajvergara        },
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * True to wrap an element with a div if needed (required for textareas
6a67d144095c31bbafed93cec1619590157335eajvergara         * and images, defaults to false) in favor of the handles config option.
6a67d144095c31bbafed93cec1619590157335eajvergara         * The wrapper element type (default div) could be over-riden passing the
6a67d144095c31bbafed93cec1619590157335eajvergara         * <code>wrapper</code> attribute.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute wrap
7056ae8910decb0d96b430451ac58b99526eb0d9jvergara         * @default false
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type boolean
6a67d144095c31bbafed93cec1619590157335eajvergara         */
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara        wrap: {
6a67d144095c31bbafed93cec1619590157335eajvergara            setter: '_setWrap',
6a67d144095c31bbafed93cec1619590157335eajvergara            value: false,
6a67d144095c31bbafed93cec1619590157335eajvergara            validator: isBoolean
6a67d144095c31bbafed93cec1619590157335eajvergara        },
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Elements that requires a wrapper by default. Normally are elements
6a67d144095c31bbafed93cec1619590157335eajvergara         * which cannot have children elements.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @attribute wrapTypes
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default /canvas|textarea|input|select|button|img/i
6a67d144095c31bbafed93cec1619590157335eajvergara         * @readOnly
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type Regex
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        wrapTypes: {
6a67d144095c31bbafed93cec1619590157335eajvergara            readOnly: true,
6a67d144095c31bbafed93cec1619590157335eajvergara            value: /^canvas|textarea|input|select|button|img|iframe|table|embed$/i
6a67d144095c31bbafed93cec1619590157335eajvergara        },
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara         * Element to wrap the <code>wrapTypes</code>. This element will house
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara         * the handles elements.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara         * @attribute wrapper
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default div
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara         * @type String | Node
6a67d144095c31bbafed93cec1619590157335eajvergara         * @writeOnce
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        wrapper: {
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara            readOnly: true,
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara            valueFn: '_valueWrapper',
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara            writeOnce: true
6a67d144095c31bbafed93cec1619590157335eajvergara        }
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter    }
6a67d144095c31bbafed93cec1619590157335eajvergara});
c9d984b0d2c0fda320e79eb3868dd6fbeb1ffa34jvergara
6a67d144095c31bbafed93cec1619590157335eajvergaraY.Resize = Y.extend(
6a67d144095c31bbafed93cec1619590157335eajvergara    Resize,
6a67d144095c31bbafed93cec1619590157335eajvergara    Y.Base,
6a67d144095c31bbafed93cec1619590157335eajvergara    {
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Array containing all possible resizable handles.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property ALL_HANDLES
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter         * @type {String}
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter         */
6a67d144095c31bbafed93cec1619590157335eajvergara        ALL_HANDLES: [ T, TR, R, BR, B, BL, L, TL ],
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Regex which matches with the handles that could change the height of
6a67d144095c31bbafed93cec1619590157335eajvergara         * the resizable element.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property REGEX_CHANGE_HEIGHT
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type {String}
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter         */
6a67d144095c31bbafed93cec1619590157335eajvergara        REGEX_CHANGE_HEIGHT: /^(t|tr|b|bl|br|tl)$/i,
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter         * Regex which matches with the handles that could change the left of
0142bbb7ccb5d0efb942c20f5d27e5ddfb4344fdkenneth_suter         * the resizable element.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property REGEX_CHANGE_LEFT
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type {String}
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        REGEX_CHANGE_LEFT: /^(tl|l|bl)$/i,
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Regex which matches with the handles that could change the top of
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter         * the resizable element.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property REGEX_CHANGE_TOP
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type {String}
0142bbb7ccb5d0efb942c20f5d27e5ddfb4344fdkenneth_suter         */
6a67d144095c31bbafed93cec1619590157335eajvergara        REGEX_CHANGE_TOP: /^(tl|t|tr)$/i,
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Regex which matches with the handles that could change the width of
6a67d144095c31bbafed93cec1619590157335eajvergara         * the resizable element.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property REGEX_CHANGE_WIDTH
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type {String}
6a67d144095c31bbafed93cec1619590157335eajvergara         */
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter        REGEX_CHANGE_WIDTH: /^(bl|br|l|r|tl|tr)$/i,
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Template used to create the resize wrapper node when needed.
3e6ff045d382a718a951d6305c8910ffc268f893kenneth_suter         *
0142bbb7ccb5d0efb942c20f5d27e5ddfb4344fdkenneth_suter         * @property WRAP_TEMPLATE
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type {String}
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        WRAP_TEMPLATE: '<div class="'+CSS_RESIZE_WRAPPER+'"></div>',
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Template used to create the resize proxy.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property PROXY_TEMPLATE
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type {String}
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        PROXY_TEMPLATE: '<div class="'+CSS_RESIZE_PROXY+'"></div>',
6a67d144095c31bbafed93cec1619590157335eajvergara
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Template used to create each resize handle.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property HANDLE_TEMPLATE
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type {String}
2401d3c2af505789c7c3b860a43e973f27731243jvergara         */
2401d3c2af505789c7c3b860a43e973f27731243jvergara        HANDLE_TEMPLATE: '<div class="'+concat(CSS_RESIZE_HANDLE, CSS_RESIZE_HANDLE_PLACEHOLDER)+'">' +
2401d3c2af505789c7c3b860a43e973f27731243jvergara                            '<div class="'+concat(CSS_RESIZE_HANDLE_INNER, CSS_RESIZE_HANDLE_INNER_PLACEHOLDER)+'">&nbsp;</div>' +
6a67d144095c31bbafed93cec1619590157335eajvergara                        '</div>',
6a67d144095c31bbafed93cec1619590157335eajvergara
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Whether the handle being dragged can change the height.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property changeHeightHandles
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default false
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type boolean
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        changeHeightHandles: false,
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Whether the handle being dragged can change the left.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property changeLeftHandles
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter         * @default false
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type boolean
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter         */
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter        changeLeftHandles: false,
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter        /**
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter         * Whether the handle being dragged can change the top.
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter         *
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter         * @property changeTopHandles
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default false
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type boolean
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        changeTopHandles: false,
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter         * Whether the handle being dragged can change the width.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property changeWidthHandles
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default false
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type boolean
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        changeWidthHandles: false,
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Store DD.Delegate reference for the respective Resize instance.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property delegate
6a67d144095c31bbafed93cec1619590157335eajvergara         * @default null
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type Object
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        delegate: null,
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Stores the current values for the height, width, top and left. You are
6a67d144095c31bbafed93cec1619590157335eajvergara         * able to manipulate these values on resize in order to change the resize
6a67d144095c31bbafed93cec1619590157335eajvergara         * behavior.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property info
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type Object
6a67d144095c31bbafed93cec1619590157335eajvergara         * @protected
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        info: null,
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Stores the last values for the height, width, top and left.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property lastInfo
6a67d144095c31bbafed93cec1619590157335eajvergara         * @type Object
6a67d144095c31bbafed93cec1619590157335eajvergara         * @protected
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        lastInfo: null,
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Stores the original values for the height, width, top and left, stored
6a67d144095c31bbafed93cec1619590157335eajvergara         * on resize start.
6a67d144095c31bbafed93cec1619590157335eajvergara         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @property originalInfo
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter         * @type Object
6a67d144095c31bbafed93cec1619590157335eajvergara         * @protected
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        originalInfo: null,
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter        /**
7b6b125d52edabd5b1c9134feef7aeae0e69499ekenneth_suter         * Construction logic executed during Resize instantiation. Lifecycle.
0142bbb7ccb5d0efb942c20f5d27e5ddfb4344fdkenneth_suter         *
6a67d144095c31bbafed93cec1619590157335eajvergara         * @method initializer
6a67d144095c31bbafed93cec1619590157335eajvergara         * @protected
6a67d144095c31bbafed93cec1619590157335eajvergara         */
6a67d144095c31bbafed93cec1619590157335eajvergara        initializer: function() {
6a67d144095c31bbafed93cec1619590157335eajvergara            var instance = this;
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara            instance.info = {};
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara            instance.originalInfo = {};
5b3741e0620fd2baaa974cecc2c2d953bb7d4fbbkenneth_suter
6a67d144095c31bbafed93cec1619590157335eajvergara            instance.get(NODE).addClass(CSS_RESIZE);
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara            instance.renderer();
6a67d144095c31bbafed93cec1619590157335eajvergara        },
6a67d144095c31bbafed93cec1619590157335eajvergara
6a67d144095c31bbafed93cec1619590157335eajvergara        /**
6a67d144095c31bbafed93cec1619590157335eajvergara         * Create the DOM structure for the Resize. Lifecycle.
7056ae8910decb0d96b430451ac58b99526eb0d9jvergara         *
7056ae8910decb0d96b430451ac58b99526eb0d9jvergara         * @method renderUI
7056ae8910decb0d96b430451ac58b99526eb0d9jvergara         * @protected
f14a485fcb48f77d077a14b766f0acc097093fe5jvergara         */
7056ae8910decb0d96b430451ac58b99526eb0d9jvergara        renderUI: function() {
6a67d144095c31bbafed93cec1619590157335eajvergara            var instance = this;

            instance._renderHandles();
        },

        /**
         * Bind the events on the Resize UI. Lifecycle.
         *
         * @method bindUI
         * @protected
         */
        bindUI: function() {
            var instance = this;

            instance._createEvents();
            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,
                node = instance.get(NODE),
                wrapper = instance.get(WRAPPER),
                pNode = wrapper.get(PARENT_NODE);

            // purgeElements on boundingBox
            Y.Event.purgeElement(wrapper, true);

            // destroy handles dd and remove them from the dom
            instance.eachHandle(function(handleEl) {
                instance.delegate.dd.destroy();

                // remove handle
                handleEl.remove(true);
            });

            // unwrap node
            if (instance.get(WRAP)) {
                instance._copyStyles(wrapper, node);

                if (pNode) {
                    pNode.insertBefore(node, wrapper);
                }

                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();
        },

        /**
         * <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;

            Y.each(
                instance.get(HANDLES),
                function(handle, i) {
                    var handleEl = instance.get(
                        handleAttrName(handle)
                    );

                    fn.apply(instance, [handleEl, handle, i]);
                }
            );
        },

        /**
         * Bind the handles DragDrop events to the Resize instance.
         *
         * @method _bindDD
         * @private
         */
        _bindDD: function() {
            var instance = this;

            instance.delegate = new Y.DD.Delegate(
                {
                    bubbleTargets: instance,
                    container: instance.get(WRAPPER),
                    dragConfig: {
                        clickPixelThresh: 0,
                        clickTimeThresh: 0,
                        useShim: true,
                        move: false
                    },
                    nodes: DOT+CSS_RESIZE_HANDLE,
                    target: false
                }
            );

            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 (_onHandleMouseEnter, _onHandleMouseLeave).
         *
         * @method _bindHandle
         * @private
         */
        _bindHandle: function() {
            var instance = this,
                wrapper = instance.get(WRAPPER);

            wrapper.on('mouseenter', Y.bind(instance._onWrapperMouseEnter, instance));
            wrapper.on('mouseleave', Y.bind(instance._onWrapperMouseLeave, instance));
            wrapper.delegate('mouseenter', Y.bind(instance._onHandleMouseEnter, instance), DOT+CSS_RESIZE_HANDLE);
            wrapper.delegate('mouseleave', Y.bind(instance._onHandleMouseLeave, instance), DOT+CSS_RESIZE_HANDLE);
        },

        /**
         * Create the custom events used on the Resize.
         *
         * @method _createEvents
         * @private
         */
        _createEvents: function() {
            var instance = this,
                // create publish function for kweight optimization
                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 align event.
             *
             * @event resize:align
             * @preventable _defResizeAlignFn
             * @param {Event.Facade} event The resize align event.
             * @bubbles Resize
             * @type {Event.Custom}
             */
            publish(EV_RESIZE_ALIGN, this._defResizeAlignFn);

            /**
             * 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,
                wrapper = instance.get(WRAPPER);

            instance.eachHandle(function(handleEl) {
                wrapper.append(handleEl);
            });
        },

        /**
          * Render the <a href="Resize.html#config_proxyNode">proxyNode</a> element and
          * make it sibling of the <a href="Resize.html#config_node">node</a>.
          *
          * @method _renderProxy
          * @protected
          */
        _renderProxy: function() {
            var instance = this,
                proxyNode = instance.get(PROXY_NODE);

            if (!proxyNode.inDoc()) {
                instance.get(WRAPPER).get(PARENT_NODE).append(
                    proxyNode.hide()
                );
            }
        },

        /**
         * 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;

            return Y.Node.create(
                Y.substitute(instance.HANDLE_TEMPLATE, {
                    handle: handle
                })
            );
        },

        /**
         * Helper method to update the current size value on
         * <a href="Resize.html#property_info">info</a> to respect the
         * min/max values and fix the top/left calculations.
         *
         * @method _checkSize
         * @param {String} offset 'offsetHeight' or 'offsetWidth'
         * @param {number} size Size to restrict the offset
         * @protected
         */
        _checkSize: function(offset, size) {
            var instance = this,
                info = instance.info,
                originalInfo = instance.originalInfo,
                axis = (offset == OFFSET_HEIGHT) ? TOP : LEFT;

            // forcing the offsetHeight/offsetWidth to be the passed size
            info[offset] = size;

            // 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
            if (((axis == LEFT) && instance.changeLeftHandles) ||
                ((axis == TOP) && instance.changeTopHandles)) {

                info[axis] = originalInfo[axis] + originalInfo[offset] - size;
            }
        },

        /**
         * 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 position = node.getStyle(POSITION).toLowerCase(),
                nodeStyle = {},
                wrapperStyle;

            // resizable wrapper should be positioned
            if (position == STATIC) {
                position = RELATIVE;
            }

            // copy margin, padding, position styles from the node to wrapper
            wrapperStyle = {
                position: position
            };

            // store top/left from the nodes involved
            // apply top/left from node to the wrapper
            Y.each([ TOP, LEFT ], function(name) {
                nodeStyle[name] = wrapper.getStyle(name);
                wrapperStyle[name] = node.getStyle(name);
            });

            // store margin(Top,Right,Bottom,Left) from the nodes involved
            // apply margin from node to the wrapper
            Y.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 Y.cached to memoize the function for performance
        _extractHandleName: Y.cached(
            function(node) {
                var className = node.get(CLASS_NAME),

                    match = className.match(
                        new RegExp(
                            getCN(RESIZE, HANDLE, '(\\w{1,2})\\b')
                        )
                    );

                return match ? match[1] : null;
            }
        ),

        /**
         * <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 actXY,
                drag = event.dragEvent.target,
                nodeXY = node.getXY(),
                nodeX = nodeXY[0],
                nodeY = nodeXY[1],
                offsetHeight = node.get(OFFSET_HEIGHT),
                offsetWidth = node.get(OFFSET_WIDTH);

            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);
            }

            return {
                actXY: actXY,
                bottom: (nodeY + offsetHeight),
                left: nodeX,
                offsetHeight: offsetHeight,
                offsetWidth: offsetWidth,
                right: (nodeX + offsetWidth),
                top: nodeY
            };
        },

        /**
         * Basic resize calculations.
         *
         * @method _resize
         * @protected
         */
        _resize: function() {
            var instance = this,
                handle = instance.get(ACTIVE_HANDLE),
                info = instance.info,
                originalInfo = instance.originalInfo,

                dx = info.actXY[0] - originalInfo.actXY[0],
                dy = info.actXY[1] - originalInfo.actXY[1],

                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);
        },

        /**
         * 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,
                info = instance.info,
                wrapper = instance.get(WRAPPER),
                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 (Y.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,
                info = instance.info,
                activeHandleNode = instance.get(ACTIVE_HANDLE_NODE),
                proxyNode = instance.get(PROXY_NODE),
                cursor = activeHandleNode.getStyle(CURSOR);

            proxyNode.show().setStyle(CURSOR, cursor);

            instance.delegate.dd.set(DRAG_CURSOR, cursor);

            instance._setOffset(proxyNode, info.offsetWidth, info.offsetHeight);

            proxyNode.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 = instance.REGEX_CHANGE_HEIGHT.test(handle);
            instance.changeLeftHandles = instance.REGEX_CHANGE_LEFT.test(handle);
            instance.changeTopHandles = instance.REGEX_CHANGE_TOP.test(handle);
            instance.changeWidthHandles = instance.REGEX_CHANGE_WIDTH.test(handle);
        },

        /**
         * 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,
                activeHandleNode = instance.get(ACTIVE_HANDLE_NODE);

            if (activeHandleNode) {
                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);
                        }
                    );

                    activeHandleNode.addClass(CSS_RESIZE_HANDLE_ACTIVE);
                }
                else {
                    activeHandleNode.removeClass(CSS_RESIZE_HANDLE_ACTIVE);
                }
            }
        },

        /**
         * Setter for the handles attribute
         *
         * @method _setHandles
         * @protected
         * @param {String} val
         */
        _setHandles: function(val) {
            var instance = this,
                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 = instance.ALL_HANDLES;
                }
                // otherwise, split the string to extract the handles
                else {
                    Y.each(
                        val.split(COMMA),
                        function(node, i) {
                            var handle = trim(node);

                            // if its a valid handle, add it to the handles output
                            if (indexOf(instance.ALL_HANDLES, handle) > -1) {
                                handles.push(handle);
                            }
                        }
                    );
                }
            }

            return handles;
        },

        /**
         * 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,
                wrapper = instance.get(WRAPPER);

            if (!instance.get(RESIZING)) {
                if (val) {
                    wrapper.addClass(CSS_RESIZE_HIDDEN_HANDLES);
                }
                else {
                    wrapper.removeClass(CSS_RESIZE_HIDDEN_HANDLES);
                }
            }
        },

        /**
         * Setter for the wrap attribute
         *
         * @method _setWrap
         * @protected
         * @param {boolean} val
         */
        _setWrap: function(val) {
            var instance = this,
                node = instance.get(NODE),
                nodeName = node.get(NODE_NAME),
                typeRegex = instance.get(WRAP_TYPES);

            // if nodeName is listed on WRAP_TYPES force use the wrapper
            if (typeRegex.test(nodeName)) {
                val = true;
            }

            return val;
        },

        /**
         * 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;

            instance._handleResizeAlignEvent(event.dragEvent);

            // if proxy is true _syncProxyUI instead of _syncUI
            if (instance.get(PROXY)) {
                instance._syncProxyUI();
            }
            else {
                // _syncUI of the wrapper, not using proxy
                instance._syncUI();
            }
        },

        /**
         * Default resize:align handler
         *
         * @method _defResizeAlignFn
         * @param {EventFacade} event The Event object
         * @protected
         */
        _defResizeAlignFn: function(event) {
            var instance = this, info;

            instance.lastInfo = instance.info;

            // update the instance.info values
            instance._updateInfo(event);

            info = instance.info;

            // basic resize calculations
            instance._resize();

            // if Y.Plugin.ResizeConstrained is not plugged, check for min dimension
            if (!instance.con) {
                var defMinHeight = instance.get(DEF_MIN_HEIGHT),
                    defMinWidth = instance.get(DEF_MIN_WIDTH);

                if (info.offsetHeight <= defMinHeight) {
                    instance._checkSize(OFFSET_HEIGHT, defMinHeight);
                }

                if (info.offsetWidth <= defMinWidth) {
                    instance._checkSize(OFFSET_WIDTH, defMinWidth);
                }
            }
        },

        /**
         * Default resize:end handler
         *
         * @method _defResizeEndFn
         * @param {EventFacade} event The Event object
         * @protected
         */
        _defResizeEndFn: function(event) {
            var instance = this,
                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_NODE).hide();
            }

            // syncUI when resize end
            instance._syncUI();

            instance.set(ACTIVE_HANDLE, null);
            instance.set(ACTIVE_HANDLE_NODE, 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);

            if (instance.get(PROXY)) {
                instance._renderProxy();
            }
        },

        /**
         * 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:align event.
         *
         * @method _handleResizeAlignEvent
         * @param {EventFacade} event resize:resize event facade
         * @protected
         */
        _handleResizeAlignEvent: function(event) {
            this.fire(EV_RESIZE_ALIGN, { 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 _onHandleMouseEnter
         * @param {EventFacade} event
         * @protected
         */
        _onHandleMouseEnter: function(event) {
            var instance = this,
                node = event.currentTarget,
                handle = instance._extractHandleName(node);

            if (!instance.get(RESIZING)) {
                instance.set(ACTIVE_HANDLE, handle);
                instance.set(ACTIVE_HANDLE_NODE, node);

                instance._setActiveHandlesUI(true);
                instance._updateChangeHandleInfo(handle);
            }
        },

        /**
         * Mouseout event handler for the handles.
         *
         * @method _onHandleMouseLeave
         * @param {EventFacade} event
         * @protected
         */
        _onHandleMouseLeave: function(event) {
            var instance = this;

            if (!instance.get(RESIZING)) {
                instance._setActiveHandlesUI(false);
            }
        },

        /**
         * Default value for the wrapper attribute
         *
         * @method _valueWrapper
         * @protected
         * @readOnly
         */
        _valueWrapper: function() {
            var instance = this,
                node = instance.get(NODE),
                pNode = node.get(PARENT_NODE),
                // by deafult the wrapper is always the node
                wrapper = node;

            // if the node is listed on the wrapTypes or wrap is set to true, create another wrapper
            if (instance.get(WRAP)) {
                wrapper = Y.Node.create(instance.WRAP_TEMPLATE);

                if (pNode) {
                    pNode.insertBefore(wrapper, node);
                }

                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;
        }
    }
);

Y.each(Y.Resize.prototype.ALL_HANDLES, function(handle, i) {
    // creating ATTRS with the handles elements
    Y.Resize.ATTRS[handleAttrName(handle)] = {
        setter: function() {
            return this._buildHandle(handle);
        },
        value: null,
        writeOnce: true
    };
});