jQuery UI API - Widget Redimensionable (Resizable Widget)

Categoría

Interacciones

Uso

Descripción:Cambia el tamaño de los elementos con el ratón.

Versión añadida:1.0

Dependencias:

Notas:El complemento Resizable de jQuery UI hace que los elementos seleccionados sean redimensionables (es decir, tienen tiradores de ajuste de tamaño arrastrables). Puede especificar uno o más tiradores, así como los valores mínimos y máximos de ancho y alto.

Notas adicionales:Este widget requiere CSS funcional; de lo contrario, no funcionará. Si crea un tema personalizado, utilice el archivo CSS específico del widget como punto de partida.

Navegación rápida

Opciones Métodos Eventos

Opciones Tipo Descripción Valor por defecto
alsoResize Selector o jQuery o Element Uno o más elementos cuyo tamaño se ajusta de forma sincronizada con el elemento resizable.

Ejemplo de código:

Inicialice el resizable con laalsoResizeopción especificada:

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

Después de la inicialización, obtenga o establezca laalsoResizeopción:

// getter
var alsoResize = $( ".selector" ).resizable( "option", "alsoResize" );
 
// setter
$( ".selector" ).resizable( "option", "alsoResize", "#mirror" );
    
false
animate Boolean Cambia dinámicamente al tamaño final después de redimensionar.

Ejemplo de código:

Inicialice el resizable con laanimateopción especificada:

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

Después de la inicialización, obtenga o establezca laanimateopción:

// getter
var animate = $( ".selector" ).resizable( "option", "animate" );
 
// setter
$( ".selector" ).resizable( "option", "animate", true );
    
false
animateDuration Number o String Cuando se utiliza laanimateopción, la duración de la animación.

Admite varios tipos:

  • Number: duración en milisegundos.
  • String: una duración con nombre, como"slow"o"fast"。

Ejemplo de código:

Inicialice el resizable con laanimateDurationopción especificada:

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

Después de la inicialización, obtenga o establezca laanimateDurationopción:

// getter
var animateDuration = $( ".selector" ).resizable( "option", "animateDuration" );
 
// setter
$( ".selector" ).resizable( "option", "animateDuration", "fast" );
    
"slow"
animateEasing String Cuando se utiliza laanimateopción, se utilizará elEasings。

Ejemplo de código:

Inicialice el resizable con laanimateEasingopción especificada:

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

Después de la inicialización, obtenga o establezca laanimateEasingopción:

// getter
var animateEasing = $( ".selector" ).resizable( "option", "animateEasing" );
 
// setter
$( ".selector" ).resizable( "option", "animateEasing", "easeOutBounce" );
    
"swing"
aspectRatio Boolean o Number Si el elemento debe estar limitado a una relación de aspecto específica.

Admite varios tipos:

  • Boolean: cuando se establece entrue, el elemento mantendrá su relación de aspecto original.
  • Number: obliga al elemento a mantener una relación de aspecto específica al redimensionar.

Ejemplo de código:

Inicialice el resizable con laaspectRatioopción especificada:

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

Después de la inicialización, obtenga o establezca laaspectRatioopción:

// getter
var aspectRatio = $( ".selector" ).resizable( "option", "aspectRatio" );
 
// setter
$( ".selector" ).resizable( "option", "aspectRatio", true );
    
false
autoHide Boolean Si ocultar los tiradores cuando el ratón del usuario no está sobre el elemento.

Ejemplo de código:

Inicialice el resizable con laautoHideopción especificada:

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

Después de la inicialización, obtenga o establezca laautoHideopción:

// getter
var autoHide = $( ".selector" ).resizable( "option", "autoHide" );
 
// setter
$( ".selector" ).resizable( "option", "autoHide", true );
    
false
cancel Selector Evita comenzar a redimensionar desde los elementos especificados.

Ejemplo de código:

Inicialice el resizable con lacancelopción especificada:

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

Después de la inicialización, obtenga o establezca lacancelopción:

// getter
var cancel = $( ".selector" ).resizable( "option", "cancel" );
 
// setter
$( ".selector" ).resizable( "option", "cancel", ".cancel" );
    
"input, textarea, button, select, option"
containment Selector o Element o String Restringe el redimensionamiento dentro de los límites del elemento o área especificados.

Admite varios tipos:

  • Selector: el elemento redimensionable se incluirá dentro de los límites del primer elemento del selector. Si no se encuentra el elemento, no se establece la contención.
  • Element: el elemento redimensionable se incluirá dentro de los límites del elemento.
  • String: valores posibles:"parent"、"document"。

Ejemplo de código:

Inicialice el resizable con lacontainmentopción especificada:

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

Después de la inicialización, obtenga o establezca lacontainmentopción:

// getter
var containment = $( ".selector" ).resizable( "option", "containment" );
 
// setter
$( ".selector" ).resizable( "option", "containment", "parent" );
    
false
delay Number Tiempo en milisegundos después de pulsar el ratón hasta que comience el redimensionamiento. Si se especifica esta opción, el redimensionamiento solo comienza después de que el ratón se haya movido más allá del tiempo. Esta opción puede evitar redimensionamientos innecesarios al hacer clic en un elemento.

Ejemplo de código:

Inicialice el resizable con ladelayopción especificada:

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

Después de la inicialización, obtenga o establezca ladelayopción:

// getter
var delay = $( ".selector" ).resizable( "option", "delay" );
 
// setter
$( ".selector" ).resizable( "option", "delay", 150 );
    
0
disabled Boolean Si se establece entrue, el resizable queda deshabilitado.

Ejemplo de código:

Inicialice el resizable con ladisabledopción especificada:

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

Después de la inicialización, obtenga o establezca ladisabledopción:

// getter
var disabled = $( ".selector" ).resizable( "option", "disabled" );
 
// setter
$( ".selector" ).resizable( "option", "disabled", true );
    
false
distance Number Distancia en píxeles que el ratón debe moverse antes de que comience el redimensionamiento después de pulsar el botón. Si se especifica esta opción, el redimensionamiento solo comienza después de que el ratón se haya movido más allá de la distancia. Esta opción puede evitar redimensionamientos innecesarios al hacer clic en un elemento.

Ejemplo de código:

Inicialice el resizable con ladistanceopción especificada:

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

Después de la inicialización, obtenga o establezca ladistanceopción:

// getter
var distance = $( ".selector" ).resizable( "option", "distance" );
 
// setter
$( ".selector" ).resizable( "option", "distance", 30 );
    
1
ghost Boolean Si se establece entrue, se muestra un elemento auxiliar semitransparente para redimensionar.

Ejemplo de código:

Inicialice el resizable con laghostopción especificada:

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

Después de la inicialización, obtenga o establezca laghostopción:

// getter
var ghost = $( ".selector" ).resizable( "option", "ghost" );
 
// setter
$( ".selector" ).resizable( "option", "ghost", true );
    
false
grid Array Alinea el elemento redimensionable a una cuadrícula, cada x e y píxeles. El formato del array debe ser[ x, y ]。

Ejemplo de código:

Inicialice el resizable con lagridopción especificada:

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

Después de la inicialización, obtenga o establezca lagridopción:

// getter
var grid = $( ".selector" ).resizable( "option", "grid" );
 
// setter
$( ".selector" ).resizable( "option", "grid", [ 20, 10 ] );
    
false
handles String o Object Los tiradores que se pueden utilizar para redimensionar.

Admite varios tipos:

  • String: una lista separada por comas, con cualquiera de los siguientes valores: n, e, s, w, ne, se, sw, nw, all. Los tiradores necesarios son generados automáticamente por el complemento.
  • Object: admite las siguientes claves: { n, e, s, w, ne, se, sw, nw }. Cualquier valor especificado debe ser un selector de jQuery que coincida con los elementos secundarios del resizable que se utilizarán como tiradores.

Notas:Al generar sus propios tiradores, cada tirador debe tener laui-resizable-handleclase, o también una apropiadaappropriate ui-resizable-{direction}clase, como ui-resizable-s.

Ejemplo de código:

Inicialice el resizable con lahandlesopción especificada:

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

Después de la inicialización, obtenga o establezca lahandlesopción:

// getter
var handles = $( ".selector" ).resizable( "option", "handles" );
 
// setter
$( ".selector" ).resizable( "option", "handles", "n, e, s, w" );
    
"e, s, se"
helper String El nombre de una clase que se agregará al elemento proxy para delinear el contorno del ajuste durante el arrastre del tirador. Una vez completado el ajuste, el elemento original se redimensiona.

Ejemplo de código:

Inicialice el resizable con lahelperopción especificada:

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

Después de la inicialización, obtenga o establezca lahelperopción:

// getter
var helper = $( ".selector" ).resizable( "option", "helper" );
 
// setter
$( ".selector" ).resizable( "option", "helper", "resizable-helper" );
    
false
maxHeight Number La altura máxima a la que se permite ajustar el resizable.

Ejemplo de código:

Inicialice el resizable con lamaxHeightopción especificada:

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

Después de la inicialización, obtenga o establezca lamaxHeightopción:

// getter
var maxHeight = $( ".selector" ).resizable( "option", "maxHeight" );
 
// setter
$( ".selector" ).resizable( "option", "maxHeight", 300 );
    
null
maxWidth Number El ancho máximo al que se permite ajustar el resizable.

Ejemplo de código:

Inicialice el resizable con lamaxWidthopción especificada:

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

Después de la inicialización, obtenga o establezca lamaxWidthopción:

// getter
var maxWidth = $( ".selector" ).resizable( "option", "maxWidth" );
 
// setter
$( ".selector" ).resizable( "option", "maxWidth", 300 );
    
null
minHeight Number La altura mínima a la que se permite ajustar el resizable.

Ejemplo de código:

Inicialice el resizable con laminHeightopción especificada:

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

Después de la inicialización, obtenga o establezca laminHeightOpciones:

// getter
var minHeight = $( ".selector" ).resizable( "option", "minHeight" );
 
// setter
$( ".selector" ).resizable( "option", "minHeight", 150 );
    
10
minWidth Number El ancho mínimo al que se puede redimensionar resizable.

Ejemplo de código:

Inicializar con lasminWidthopciones especificadas de resizable:

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

Después de la inicialización, obtener o establecerminWidthopciones:

// getter
var minWidth = $( ".selector" ).resizable( "option", "minWidth" );
 
// setter
$( ".selector" ).resizable( "option", "minWidth", 150 );
    
10

Métodos Devuelve Descripción
destroy() jQuery (plugin only) Elimina por completo la funcionalidad resizable. Esto devuelve el elemento a su estado previo a la inicialización.
  • Este método no acepta ningún parámetro.

Ejemplo de código:

Llamar al método destroy:

$( ".selector" ).resizable( "destroy" );
    
disable() jQuery (plugin only) Deshabilita resizable.
  • Este método no acepta ningún parámetro.

Ejemplo de código:

Llamar al método disable:

$( ".selector" ).resizable( "disable" );
    
enable() jQuery (plugin only) Habilita resizable.
  • Este método no acepta ningún parámetro.

Ejemplo de código:

Llamar al método enable:

$( ".selector" ).resizable( "enable" );
    
option( optionName ) Object Obtiene el valor actualmente asociado con laoptionNameopción especificada.
  • optionName
    Tipo: String
    Descripción: El nombre de la opción a obtener.

Ejemplo de código:

Llamar a este método:

var isDisabled = $( ".selector" ).resizable( "option", "disabled" );
    
option() PlainObject Obtiene un objeto que contiene pares clave/valor que representan el hash de opciones actual de resizable.
  • Este método no acepta ningún parámetro.

Ejemplo de código:

Llamar a este método:

var options = $( ".selector" ).resizable( "option" );
    
option( optionName, value ) jQuery (plugin only) Establece el valor de la opción resizable asociada con laoptionNameopción especificada.
  • optionName
    Tipo: String
    Descripción: El nombre de la opción a establecer.
  • value
    Tipo: Object
    Descripción: El valor a establecer para la opción.

Ejemplo de código:

Llamar a este método:

$( ".selector" ).resizable( "option", "disabled", true );
    
option( options ) jQuery (plugin only) Establece una o más opciones para resizable.
  • options
    Tipo: Object
    Descripción: Los pares de opción-valor a establecer.

Ejemplo de código:

Llamar a este método:

$( ".selector" ).resizable( "option", { disabled: true } );
    
widget() jQuery Devuelve un objeto que contiene el elementojQueryresizable.
  • Este método no acepta ningún parámetro.

Ejemplo de código:

Llamar al método widget:

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

Eventos Tipo Descripción
create( event, ui ) resizecreate Se dispara cuando se crea el resizable.
  • event
    Tipo: Event
  • ui
    Tipo: Object

Nota:uiEl objeto está vacío; se incluye aquí para mantener la coherencia con otros eventos.

Ejemplo de código:

Inicializar el resizable con la devolución de llamada (callback) create especificada:

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

Vincular un detector de eventos al evento resizecreate:

$( ".selector" ).on( "resizecreate", function( event, ui ) {} );
    
resize( event, ui ) resize Se dispara durante el redimensionamiento cuando se arrastra el controlador de ajuste.
  • event
    Tipo: Event
  • ui
    Tipo: Object
    • element
      Tipo: jQuery
      Descripción: Objeto jQuery que representa el elemento que se va a redimensionar.
    • helper
      Tipo: jQuery
      Descripción: Objeto jQuery que representa el helper (asistente) que se está redimensionando.
    • originalElement
      Tipo: jQuery
      Descripción: Objeto jQuery que representa el elemento original antes de ser envuelto.
    • originalPosition
      Tipo: Object
      Descripción: La posición del resizable antes del redimensionamiento, representada como{ top, left }。
    • originalSize
      Tipo: Object
      Descripción: El tamaño del resizable antes del redimensionamiento, representado como{ width, height }。
    • position
      Tipo: Object
      Descripción: La posición actual, representada como{ top, left }。
    • size
      Tipo: Object
      Descripción: El tamaño actual, representado como{ width, height }。

Ejemplo de código:

Inicializar el resizable con la devolución de llamada (callback) resize especificada:

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

Vincular un detector de eventos al evento resize:

$( ".selector" ).on( "resize", function( event, ui ) {} );
    
start( event, ui ) resizestart Se dispara cuando comienza la operación de redimensionamiento.
  • event
    Tipo: Event
  • ui
    Tipo: Object
    • element
      Tipo: jQuery
      Descripción: Objeto jQuery que representa el elemento que se va a redimensionar.
    • helper
      Tipo: jQuery
      Descripción: Objeto jQuery que representa el helper (asistente) que se está redimensionando.
    • originalElement
      Tipo: jQuery
      Descripción: Objeto jQuery que representa el elemento original antes de ser envuelto.
    • originalPosition
      Tipo: Object
      Descripción: La posición del resizable antes del redimensionamiento, representada como{ top, left }。
    • originalSize
      Tipo: Object
      Descripción: El tamaño del resizable antes del redimensionamiento, representado como{ width, height }。
    • position
      Tipo: Object
      Descripción: La posición actual, representada como{ top, left }。
    • size
      Tipo: Object
      Descripción: La posición actual, representada como{ width, height }。

Ejemplo de código:

Inicializar el resizable con la devolución de llamada (callback) start especificada:

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

Vincular un detector de eventos al evento resizestart:

$( ".selector" ).on( "resizestart", function( event, ui ) {} );
    
stop( event, ui ) resizestop Se dispara cuando la operación de redimensionamiento se detiene.
  • event
    Tipo: Event
  • ui
    Tipo: Object
    • element
      Tipo: jQuery
      Descripción: Objeto jQuery que representa el elemento que se va a redimensionar.
    • helper
      Tipo: jQuery
      Descripción: Objeto jQuery que representa el helper (asistente) que se está redimensionando.
    • originalElement
      Tipo: jQuery
      Descripción: Objeto jQuery que representa el elemento original antes de ser envuelto.
    • originalPosition
      Tipo: Object
      Descripción: La posición del resizable antes del redimensionamiento, representada como{ top, left }。
    • originalSize
      Tipo: Object
      Descripción: El tamaño del resizable antes del redimensionamiento, representado como{ width, height }。
    • position
      Tipo: Object
      Descripción: La posición actual, representada como{ top, left }。
    • size
      Tipo: Object
      Descripción: La posición actual, representada como{ width, height }。

Ejemplo de código:

Inicializar el resizable con la devolución de llamada (callback) stop especificada:

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

Vincular un detector de eventos al evento resizestop:

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

Ejemplos

Un widget de jQuery UI redimensionable (Resizable Widget) simple.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>可调整尺寸小部件(Resizable Widget)演示</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <style>
  #resizable {
    width: 100px;
    height: 100px;
    background: #ccc;
}    </style>
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
 
<div id="resizable"></div>
 
<script>
$( "#resizable" ).resizable();
</script>
 
</body>
</html>

Otras extensiones