Resizable

Resizable is a simple widget that will help you to create elements on your page what can be resized by the user.

Get the latest version right here

All the source code of the project is available under terms of the MIT license

http://github.com/rightjs/rightjs-ui/tree/master/src/resizable/

For some standard usage examples see the demo page

Index

top ↑Features List

  • Easy and flexible usage
  • Can work with any direction
  • Fully CSS based design
  • Tiny (2k gzipped) build file
  • No drag-n-drop dependencies

top ↑Usage Basics

First, copy in place one of the files above, as you usually do. Then copy this image to the same location on your server. (check the styles section for more options on this regard)

After that you have three ways to create resizable blocks. First, you can simply define an HTML structure like that

<div class="rui-resizable">
<div class="rui-resizable-content">
// your content goes in here
</div>
<div class="rui-resizable-handle"></div>
</div>

In this case RightJS will use lazy initialization of the widget on demand. Or you can turn any element on your page into resizable widget programmatically like that.

<div id="my-element">
// Some content in here
</div>

$('my-element').makeResizable();

In this case RightJS will initialize a resizable unit instantly. To switch the functionality off use the undoResizable() method.

And finally you can use the Resizable unit as a class

var resizable = new Resizable('my-element', {
direction: 'bottom'
});

resizable.setSize(200, 200);

resizable.destroy(); // the destructor

top ↑Defining Directions

By default your resizables will be bidirectional, with a handle at the right bottom corner. But this widget can work with any of the four directions specifically.

If you create your resizable as a HTML structure, then simply use css classes, like rui-resizable-right, rui-resizable-bottom, and so on.

<div class="rui-resizable-bottom">
// the rest of the stuff in here
</div>

If you create your resizable programmatically then use the direction option

$('my-element').makeResizable({direction: 'right'});

It will automatically assign necessary classes for you.

top ↑Defining Boundaries

This widget will automatically respect your CSS level settings like min-width, max-height, etc.

<div class="rui-resizable" style="min-width: 10em">
// the rest of the construction in here
</div>

And you also can define the limits with the options, like that

$('my-element').makeResizable({
minWidth: 100,
maxHeight: '20em'
});

NOTE: You can use any type of values, numbers, sizes with dimensions, even percents.

top ↑Options List

The list of options is pretty short and we went through all of them in the previous two chapters

NameDefaultDescription
directionnulltop, left, right, bottom or null for bidirectional
minWidthnullminimal width limit
maxWidthnullmaximal width limit
minHeightnullminimal height limit
maxHeightnullmaximal height limit

As usual you can use any of those options with constructor, the makeResizable method or with the data-resizable HTML5 attribute.

top ↑Events List

There is a simple list of events this widget supports

NameDescription
startwhen the resize starts
resizewhen the widget is resized by the user
releasewhen the resize ends

top ↑Style Alterations

Resizables have a pretty simple structure, which you can create by yourself or let the script to create it for you

<div class="rui-resizable">
<div class="rui-resizable-content">
// your content goes in here
</div>
<div class="rui-resizable-handle"></div>
</div>

NOTE: this widget has an image dependency which is used as the background for the handle elements. You can grab it over here and save to the same location on your server. Or you can use your own image and define it in your CSS layer like that

.rui-resizable-handle {
background-image: url(/url/to/my-image.png);
}