Resizable Widget

Categories: Interactions

Resizable Widgetversion added: 1.0

Description: Change the size of an element using the mouse.

QuickNavExamples

Options

Methods

Events

The jQuery UI Resizable plugin makes selected elements resizable (meaning they have draggable resize handles). You can specify one or more handles as well as min and max width and height.

Theming

The resizable widget uses the jQuery UI CSS framework to style its look and feel. If resizable specific styling is needed, the following CSS class names can be used for overrides or as keys for the classes option:

  • ui-resizable: The resizable element. During a resize, the ui-resizable-resizing class is added. When the autoHide option is set, the ui-resizable-autohide class is added.
  • ui-resizable-handle: One of the handles of the resizable, specified using the handles option. Each handle will also have a ui-resizable-{direction} class according to its position.
  • ui-resizable-ghost: When using the ghost option, this class is applied to the ghost helper element.
  • ui-resizable-helper: When the animate option is used, but the helper option isn't specified, this class is added to the generated helper.

Dependencies

Additional Notes:

  • This widget requires some functional CSS, otherwise it won't work. If you build a custom theme, use the widget's specific CSS file as a starting point.

Options

alsoResize 

Type: Selector or jQuery or Element
Default: false
One or more elements to resize synchronously with the resizable element.
Code examples:

Initialize the resizable with the alsoResize option specified:

1
2
3
 
$( ".selector" ).resizable({
  alsoResize: "#mirror"
});

Get or set the alsoResize option, after initialization:

1
2
3
4
5
 
// Getter
var alsoResize = $( ".selector" ).resizable( "option", "alsoResize" );
 
// Setter
$( ".selector" ).resizable( "option", "alsoResize", "#mirror" );

animate 

Type: Boolean
Default: false
Animates to the final size after resizing.
Code examples:

Initialize the resizable with the animate option specified:

1
2
3
 
$( ".selector" ).resizable({
  animate: true
});

Get or set the animate option, after initialization:

1
2
3
4
5
 
// Getter
var animate = $( ".selector" ).resizable( "option", "animate" );
 
// Setter
$( ".selector" ).resizable( "option", "animate", true );

animateDuration 

Type: Number or String
Default: "slow"
How long to animate when using the animate option.
Multiple types supported:
  • Number: Duration in milliseconds.
  • String: A named duration, such as "slow" or "fast".
Code examples:

Initialize the resizable with the animateDuration option specified:

1
2
3
 
$( ".selector" ).resizable({
  animateDuration: "fast"
});

Get or set the animateDuration option, after initialization:

1
2
3
4
5
 
// Getter
var animateDuration = $( ".selector" ).resizable( "option", "animateDuration" );
 
// Setter
$( ".selector" ).resizable( "option", "animateDuration", "fast" );

animateEasing 

Type: String
Default: "swing"
Which easing to apply when using the animate option.
Code examples:

Initialize the resizable with the animateEasing option specified:

1
2
3
 
$( ".selector" ).resizable({
  animateEasing: "easeOutBounce"
});

Get or set the animateEasing option, after initialization:

1
2
3
4
5
 
// Getter
var animateEasing = $( ".selector" ).resizable( "option", "animateEasing" );
 
// Setter
$( ".selector" ).resizable( "option", "animateEasing", "easeOutBounce" );

aspectRatio 

Type: Boolean or Number
Default: false
Whether the element should be constrained to a specific aspect ratio.
Multiple types supported:
  • Boolean: When set to true, the element will maintain its original aspect ratio.
  • Number: Force the element to maintain a specific aspect ratio during resizing.
Code examples:

Initialize the resizable with the aspectRatio option specified:

1
2
3
 
$( ".selector" ).resizable({
  aspectRatio: true
});

Get or set the aspectRatio option, after initialization:

1
2
3
4
5
 
// Getter
var aspectRatio = $( ".selector" ).resizable( "option", "aspectRatio" );
 
// Setter
$( ".selector" ).resizable( "option", "aspectRatio", true );

autoHide 

Type: Boolean
Default: false
Whether the handles should hide when the user is not hovering over the element.
Code examples:

Initialize the resizable with the autoHide option specified:

1
2
3
 
$( ".selector" ).resizable({
  autoHide: true
});

Get or set the autoHide option, after initialization:

1
2
3
4
5
 
// Getter
var autoHide = $( ".selector" ).resizable( "option", "autoHide" );
 
// Setter
$( ".selector" ).resizable( "option", "autoHide", true );

cancel 

Type: Selector
Default: "input,textarea,button,select,option"
Prevents resizing from starting on specified elements.
Code examples:

Initialize the resizable with the cancel option specified:

1
2
3
 
$( ".selector" ).resizable({
  cancel: ".cancel"
});

Get or set the cancel option, after initialization:

1
2
3
4
5
 
// Getter
var cancel = $( ".selector" ).resizable( "option", "cancel" );
 
// Setter
$( ".selector" ).resizable( "option", "cancel", ".cancel" );

classes 

Type: Object
Default: 
{
  "ui-resizable-se": "ui-icon ui-icon-gripsmall-diagonal-se"
}

Specify additional classes to add to the widget's elements. Any of classes specified in the Theming section can be used as keys to override their value. To learn more about this option, check out the learn article about the classes option.

Code examples:

Initialize the resizable with the classes option specified, changing the theming for the ui-resizable class:

1
2
3
4
5
 
$( ".selector" ).resizable({
  classes: {
    "ui-resizable": "highlight"
  }
});

Get or set a property of the classes option, after initialization, here reading and changing the theming for the ui-resizable class:

1
2
3
4
5
 
// Getter
var themeClass = $( ".selector" ).resizable( "option", "classes.ui-resizable" );
 
// Setter
$( ".selector" ).resizable( "option", "classes.ui-resizable", "highlight" );

containment 

Type: Selector or Element or String
Default: false
Constrains resizing to within the bounds of the specified element or region.
Multiple types supported:
  • Selector: The resizable element will be contained to the bounding box of the first element found by the selector. If no element is found, no containment will be set.
  • Element: The resizable element will be contained to the bounding box of this element.
  • String: Possible values: "parent" and "document".
Code examples:

Initialize the resizable with the containment option specified:

1
2
3
 
$( ".selector" ).resizable({
  containment: "parent"
});

Get or set the containment option, after initialization:

1
2
3
4
5
 
// Getter
var containment = $( ".selector" ).resizable( "option", "containment" );
 
// Setter
$( ".selector" ).resizable( "option", "containment", "parent" );

delay 

Type: Number
Default: 0
Tolerance, in milliseconds, for when resizing should start. If specified, resizing will not start until after mouse is moved beyond duration. This can help prevent unintended resizing when clicking on an element. (version deprecated: 1.12)
Code examples:

Initialize the resizable with the delay option specified:

1
2
3
 
$( ".selector" ).resizable({
  delay: 150
});

Get or set the delay option, after initialization:

1
2
3
4
5
 
// Getter
var delay = $( ".selector" ).resizable( "option", "delay" );
 
// Setter
$( ".selector" ).resizable( "option", "delay", 150 );

disabled 

Type: Boolean
Default: false
Disables the resizable if set to true.
Code examples:

Initialize the resizable with the disabled option specified:

1
2
3
 
$( ".selector" ).resizable({
  disabled: true
});

Get or set the disabled option, after initialization:

1
2
3
4
5
 
// Getter
var disabled = $( ".selector" ).resizable( "option", "disabled" );
 
// Setter
$( ".selector" ).resizable( "option", "disabled", true );

distance 

Type: Number
Default: 1
Tolerance, in pixels, for when resizing should start. If specified, resizing will not start until after mouse is moved beyond distance. This can help prevent unintended resizing when clicking on an element. (version deprecated: 1.12)
Code examples:

Initialize the resizable with the distance option specified:

1
2
3
 
$( ".selector" ).resizable({
  distance: 30
});

Get or set the distance option, after initialization:

1
2
3
4
5
 
// Getter
var distance = $( ".selector" ).resizable( "option", "distance" );
 
// Setter
$( ".selector" ).resizable( "option", "distance", 30 );

ghost 

Type: Boolean
Default: false
If set to true, a semi-transparent helper element is shown for resizing.
Code examples:

Initialize the resizable with the ghost option specified:

1
2
3
 
$( ".selector" ).resizable({
  ghost: true
});

Get or set the ghost option, after initialization:

1
2
3
4
5
 
// Getter
var ghost = $( ".selector" ).resizable( "option", "ghost" );
 
// Setter
$( ".selector" ).resizable( "option", "ghost", true );

grid 

Type: Array
Default: false
Snaps the resizing element to a grid, every x and y pixels. Array values: [ x, y ].
Code examples:

Initialize the resizable with the grid option specified:

1
2
3
 
$( ".selector" ).resizable({
  grid: [ 20, 10 ]
});

Get or set the grid option, after initialization:

1
2
3
4
5
 
// Getter
var grid = $( ".selector" ).resizable( "option", "grid" );
 
// Setter
$( ".selector" ).resizable( "option", "grid", [ 20, 10 ] );

handles 

Type: String or Object
Default: "e, s, se"
Which handles can be used for resizing.
Multiple types supported:
  • String: A comma delimited list of any of the following: n, e, s, w, ne, se, sw, nw, all. The necessary handles will be auto-generated by the plugin.
  • Object:

    The following keys are supported: { n, e, s, w, ne, se, sw, nw }. The value of any specified should be a jQuery selector matching the child element of the resizable to use as that handle. If the handle is not a child of the resizable, you can pass in the DOMElement or a valid jQuery object directly.

    Note: When generating your own handles, each handle must have the ui-resizable-handle class, as well as the appropriate ui-resizable-{direction} class, .e.g., ui-resizable-s.

Code examples:

Initialize the resizable with the handles option specified:

1
2
3
 
$( ".selector" ).resizable({
  handles: "n, e, s, w"
});

Get or set the handles option, after initialization:

1
2
3
4
5
 
// Getter
var handles = $( ".selector" ).resizable( "option", "handles" );
 
// Setter
$( ".selector" ).resizable( "option", "handles", "n, e, s, w" );

helper 

Type: String
Default: false
A class name that will be added to a proxy element to outline the resize during the drag of the resize handle. Once the resize is complete, the original element is sized.
Code examples:

Initialize the resizable with the helper option specified:

1
2
3
 
$( ".selector" ).resizable({
  helper: "resizable-helper"
});

Get or set the helper option, after initialization:

1
2
3
4
5
 
// Getter
var helper = $( ".selector" ).resizable( "option", "helper" );
 
// Setter
$( ".selector" ).resizable( "option", "helper", "resizable-helper" );

maxHeight 

Type: Number
Default: null
The maximum height the resizable should be allowed to resize to.
Code examples:

Initialize the resizable with the maxHeight option specified:

1
2
3
 
$( ".selector" ).resizable({
  maxHeight: 300
});

Get or set the maxHeight option, after initialization:

1
2
3
4
5
 
// Getter
var maxHeight = $( ".selector" ).resizable( "option", "maxHeight" );
 
// Setter
$( ".selector" ).resizable( "option", "maxHeight", 300 );

maxWidth 

Type: Number
Default: null
The maximum width the resizable should be allowed to resize to.
Code examples:

Initialize the resizable with the maxWidth option specified:

1
2
3
 
$( ".selector" ).resizable({
  maxWidth: 300
});

Get or set the maxWidth option, after initialization:

1
2
3
4
5
 
// Getter
var maxWidth = $( ".selector" ).resizable( "option", "maxWidth" );
 
// Setter
$( ".selector" ).resizable( "option", "maxWidth", 300 );

minHeight 

Type: Number
Default: 10
The minimum height the resizable should be allowed to resize to.
Code examples:

Initialize the resizable with the minHeight option specified:

1
2
3
 
$( ".selector" ).resizable({
  minHeight: 150
});

Get or set the minHeight option, after initialization:

1
2
3
4
5
 
// Getter
var minHeight = $( ".selector" ).resizable( "option", "minHeight" );
 
// Setter
$( ".selector" ).resizable( "option", "minHeight", 150 );

minWidth 

Type: Number
Default: 10
The minimum width the resizable should be allowed to resize to.
Code examples:

Initialize the resizable with the minWidth option specified:

1
2
3
 
$( ".selector" ).resizable({
  minWidth: 150
});

Get or set the minWidth option, after initialization:

1
2
3
4
5
 
// Getter
var minWidth = $( ".selector" ).resizable( "option", "minWidth" );
 
// Setter
$( ".selector" ).resizable( "option", "minWidth", 150 );

Methods

destroy()Returns: jQuery (plugin only)

Removes the resizable functionality completely. This will return the element back to its pre-init state.
  • This method does not accept any arguments.
Code examples:

Invoke the destroy method:

1
 
$( ".selector" ).resizable( "destroy" );

disable()Returns: jQuery (plugin only)

Disables the resizable.
  • This method does not accept any arguments.
Code examples:

Invoke the disable method:

1
 
$( ".selector" ).resizable( "disable" );

enable()Returns: jQuery (plugin only)

Enables the resizable.
  • This method does not accept any arguments.
Code examples:

Invoke the enable method:

1
 
$( ".selector" ).resizable( "enable" );

instance()Returns: Object

Retrieves the resizable's instance object. If the element does not have an associated instance, undefined is returned.

Unlike other widget methods, instance() is safe to call on any element after the resizable plugin has loaded.

  • This method does not accept any arguments.
Code examples:

Invoke the instance method:

1
 
$( ".selector" ).resizable( "instance" );

option( optionName )Returns: Object

Gets the value currently associated with the specified optionName.

Note: For options that have objects as their value, you can get the value of a specific key by using dot notation. For example, "foo.bar" would get the value of the bar property on the foo option.

  • optionName
    Type: String
    The name of the option to get.
Code examples:

Invoke the method:

1
 
var isDisabled = $( ".selector" ).resizable( "option", "disabled" );

option()Returns: PlainObject

Gets an object containing key/value pairs representing the current resizable options hash.
  • This signature does not accept any arguments.
Code examples:

Invoke the method:

1
 
var options = $( ".selector" ).resizable( "option" );

option( optionName, value )Returns: jQuery (plugin only)

Sets the value of the resizable option associated with the specified optionName.

Note: For options that have objects as their value, you can set the value of just one property by using dot notation for optionName. For example, "foo.bar" would update only the bar property of the foo option.

  • optionName
    Type: String
    The name of the option to set.
  • value
    Type: Object
    A value to set for the option.
Code examples:

Invoke the method:

1
 
$( ".selector" ).resizable( "option", "disabled", true );

option( options )Returns: jQuery (plugin only)

Sets one or more options for the resizable.
  • options
    Type: Object
    A map of option-value pairs to set.
Code examples:

Invoke the method:

1
 
$( ".selector" ).resizable( "option", { disabled: true } );

widget()Returns: jQuery

Returns a jQuery object containing the resizable element.
  • This method does not accept any arguments.
Code examples:

Invoke the widget method:

1
 
var widget = $( ".selector" ).resizable( "widget" );

Events

create( event, ui )Type: resizecreate

Triggered when the resizable is created.

Note: The ui object is empty but included for consistency with other events.

Code examples:

Initialize the resizable with the create callback specified:

1
2
3
 
$( ".selector" ).resizable({
  create: function( event, ui ) {}
});

Bind an event listener to the resizecreate event:

1
 
$( ".selector" ).on( "resizecreate", function( event, ui ) {} );

resize( event, ui )Type: resize

This event is triggered during the resize, on the drag of the resize handler.
  • event
    Type: Event
  • ui
    Type: Object
    • element
      Type: jQuery
      The jQuery object representing the element to be resized
    • helper
      Type: jQuery
      The jQuery object representing the helper that's being resized
    • originalElement
      Type: jQuery
      The jQuery object representing the original element before it is wrapped
    • originalPosition
      Type: Object
      The position represented as { left, top } before the resizable is resized
    • originalSize
      Type: Object
      The size represented as { width, height } before the resizable is resized
    • position
      Type: Object
      The current position represented as { left, top }. The values may be changed to modify where the element will be positioned. Useful for custom resizing logic.
    • size
      Type: Object
      The current size represented as { width, height }. The values may be changed to modify where the element will be positioned. Useful for custom resizing logic.
Code examples:

Initialize the resizable with the resize callback specified:

1
2
3
 
$( ".selector" ).resizable({
  resize: function( event, ui ) {}
});

Bind an event listener to the resize event:

1
 
$( ".selector" ).on( "resize", function( event, ui ) {} );

Restrict height resizing to 30 pixel increments:

1
2
3
4
5
 
$( ".selector" ).resizable({
  resize: function( event, ui ) {
    ui.size.height = Math.round( ui.size.height / 30 ) * 30;
  }
});

start( event, ui )Type: resizestart

This event is triggered at the start of a resize operation.
  • event
    Type: Event
  • ui
    Type: Object
    • element
      Type: jQuery
      The jQuery object representing the element to be resized
    • helper
      Type: jQuery
      The jQuery object representing the helper that's being resized
    • originalElement
      Type: jQuery
      The jQuery object representing the original element before it is wrapped
    • originalPosition
      Type: Object
      The position represented as { left, top } before the resizable is resized
    • originalSize
      Type: Object
      The size represented as { width, height } before the resizable is resized
    • position
      Type: Object
      The current position represented as { left, top }
    • size
      Type: Object
      The current size represented as { width, height }
Code examples:

Initialize the resizable with the start callback specified:

1
2
3
 
$( ".selector" ).resizable({
  start: function( event, ui ) {}
});

Bind an event listener to the resizestart event:

1
 
$( ".selector" ).on( "resizestart", function( event, ui ) {} );

stop( event, ui )Type: resizestop

This event is triggered at the end of a resize operation.
  • event
    Type: Event
  • ui
    Type: Object
    • element
      Type: jQuery
      The jQuery object representing the element to be resized
    • helper
      Type: jQuery
      The jQuery object representing the helper that's being resized
    • originalElement
      Type: jQuery
      The jQuery object representing the original element before it is wrapped
    • originalPosition
      Type: Object
      The position represented as { left, top } before the resizable is resized
    • originalSize
      Type: Object
      The size represented as { width, height } before the resizable is resized
    • position
      Type: Object
      The current position represented as { left, top }
    • size
      Type: Object
      The current size represented as { width, height }
Code examples:

Initialize the resizable with the stop callback specified:

1
2
3
 
$( ".selector" ).resizable({
  stop: function( event, ui ) {}
});

Bind an event listener to the resizestop event:

1
 
$( ".selector" ).on( "resizestop", function( event, ui ) {} );

Example:

A simple jQuery UI Resizable.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
 
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>resizable demo</title>
  <link rel="stylesheet" href="./code.jquery.com/ui/1.12.0/themes/smoothness/jquery-ui.css">
  <style>
  #resizable {
    width: 100px;
    height: 100px;
    background: #ccc;
}	</style>
  <script src="./code.jquery.com/jquery-1.12.4.js"></script>
  <script src="./code.jquery.com/ui/1.12.0/jquery-ui.js"></script>
</head>
<body>
 
<div id="resizable"></div>
 
<script>
$( "#resizable" ).resizable();
</script>
 
</body>
</html>

Demo: