jQuery UI API - Widget Redimensionable (Resizable Widget)
Categoría
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 la
$( ".selector" ).resizable({ alsoResize: "#mirror" });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ animate: true });
Después de la inicialización, obtenga o establezca la // 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:
Ejemplo de código: Inicialice el resizable con la
$( ".selector" ).resizable({ animateDuration: "fast" });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ animateEasing: "easeOutBounce" });
Después de la inicialización, obtenga o establezca la // 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:
Ejemplo de código: Inicialice el resizable con la
$( ".selector" ).resizable({ aspectRatio: true });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ autoHide: true });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ cancel: ".cancel" });
Después de la inicialización, obtenga o establezca la // 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:
Ejemplo de código: Inicialice el resizable con la
$( ".selector" ).resizable({ containment: "parent" });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ delay: 150 });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ disabled: true });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ distance: 30 });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ ghost: true });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ grid: [ 20, 10 ] });
Después de la inicialización, obtenga o establezca la // 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:
Notas:Al generar sus propios tiradores, cada tirador debe tener la Ejemplo de código: Inicialice el resizable con la
$( ".selector" ).resizable({ handles: "n, e, s, w" });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ helper: "resizable-helper" });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ maxHeight: 300 });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ maxWidth: 300 });
Después de la inicialización, obtenga o establezca la // 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 la
$( ".selector" ).resizable({ minHeight: 150 });
Después de la inicialización, obtenga o establezca la // 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 las
$( ".selector" ).resizable({ minWidth: 150 });
Después de la inicialización, obtener o establecer // 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.
Ejemplo de código: Llamar al método destroy: $( ".selector" ).resizable( "destroy" ); |
| disable() | jQuery (plugin only) | Deshabilita resizable.
Ejemplo de código: Llamar al método disable: $( ".selector" ).resizable( "disable" ); |
| enable() | jQuery (plugin only) | Habilita resizable.
Ejemplo de código: Llamar al método enable: $( ".selector" ).resizable( "enable" ); |
| option( optionName ) | Object | Obtiene el valor actualmente asociado con laoptionNameopción especificada.
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.
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.
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.
Ejemplo de código: Llamar a este método:
$( ".selector" ).resizable( "option", { disabled: true } );
|
| widget() | jQuery | Devuelve un objeto que contiene el elementojQueryresizable.
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.
Nota: 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.
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.
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.
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