# Resizable Examples

These examples show how to apply a floating (default) and pinned Resizable component to a standard element.

Note that the js is not minified so it is readable. See basic.js for the full source code.

Basic Example
This is a basic as you get. To resize the box, position your mouse anywhere near the bottom, right or border right edge of the box. This example uses the default "floating" handles.

Resize Me!

    var basic = new Ext.Resizable('basic', {
            width: 200,
            height: 100,
            minWidth:100,
            minHeight:50
    });

Wrapped Elements
Some elements such as images and textareas don't allow child elements. In the past, you had to wrap these elements and set up a Resizable with resize child. As of yui-ext .33 RC2, Resizable will wrap the element, calculate adjustments for borders/padding and offset the handles for you. All you have to do is set "wrap:true". The manual way of specifying a "resizeChild" is still supported as well.

Pinned Handles
Notice this example has the resize handles "pinned". This is done by setting "pinned:true".

Dynamic Sizing
If you don't like the proxy resizing, you can also turn on dynamic sizing. Just set "dynamic:true".

Here's a textarea that is wrapped, has pinned handles and has dynamic sizing turned on.

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed metus nibh, sodales a, porta at, vulputate eget, dui. Pellentesque ut nisl. Maecenas tortor turpis, interdum non, sodales non, iaculis ac, lacus. Vestibulum auctor, tortor quis iaculis malesuada, libero lectus bibendum purus, sit amet tincidunt quam turpis vel lacus. In pellentesque nisl non sem. Suspendisse nunc sem, pretium eget, cursus a, fringilla vel, urna. Aliquam commodo ullamcorper erat. Nullam vel justo in neque porttitor laoreet. Aenean lacus dui, consequat eu, adipiscing eget, nonummy non, nisi. Morbi nunc est, dignissim non, ornare sed, luctus eu, massa. Vivamus eget quam. Vivamus tincidunt diam nec urna. Curabitur velit. Quisque dolor magna, ornare sed, elementum porta, luctus in, leo.
And look how simple the code is, even my grandma could write it.

    var dwrapped = new Ext.Resizable('dwrapped', {
        wrap:true,
        pinned:true,
        width:450,
        height:150,
        minWidth:200,
        minHeight: 50,
        dynamic: true
    });

Preserve Ratio
For some things like images, you will probably want to preserve the ratio of width to height. Just set preserveRatio:true.

    var wrapped = new Ext.Resizable('wrapped', {
        wrap:true,
        pinned:true,
        minWidth:50,
        minHeight: 50,
        preserveRatio: true
    });

Transparent Handles
If you just want the element to be resizable without any fancy handles, set transparent to true.

    var transparent = new Ext.Resizable('transparent', {
        wrap:true,
        minWidth:50,
        minHeight: 50,
        preserveRatio: true,
        transparent:true
    });

Customizable Handles
Resizable elements are resizable 8 ways. 8 way resizing for a static positioned element will cause the element to be positioned relative and taken out of the document flow. For resizing which adjusts the x and y of the element, the element should be positioned absolute. You can also control which handles are displayed by setting the "handles" attribute. The handles are styled using CSS so they can be customized to look however you would like them to.

This image has 8 way resizing, custom handles, is draggable and 8 way preserved ratio (that wasn't easy!).
Double click anywhere on the image to hide it when you are done.

    var custom = new Ext.Resizable('custom', {
        wrap:true,
        pinned:true,
        minWidth:50,
        minHeight: 50,
        preserveRatio: true,
        dynamic:true,
        handles: 'all', // shorthand for 'n s e w ne nw se sw'
        draggable:true
    });

Snapping
Resizable also supports basic snapping in increments.

    var snap = new Ext.Resizable('snap', {
        pinned:true,
        width:250,
        height:100,
        handles: 'e',
        widthIncrement:50,
        minWidth: 50,
        dynamic: true
    });

Warning: Snapping and preserveRatio conflict and can not be used together.

Animated Transitions
Resize operations can also be animated. Animations support configurable easing and duration. Here's a very basic clone of the first element, but with animation turned on. I used a "backIn" easing and made it a little slower than default.

Animate Me!

    var animated = new Ext.Resizable('animated', {
        width: 200,
        height: 100,
        minWidth:100,
        minHeight:50,
        animate:true,
        easing: 'backIn',
        duration:.6
    });

Warning: for obvious reasons animate and dynamic resizing can not be used together.