Jquery UI: usando draggables y droppables
Tuesday, November 27th, 2007En algún momento te haz preguntado; ¿Como obtengo el objeto, que estoy arrastrando con el ratón usando jquery.ui?; la pregunta es facil de responder y trataremos de explicar algunas cosas sobre draggables y dropables para entender mejor.
El concepto para comenzar a utilizar ui.draggables y ui.droppables es sencillo; simplemente creen un par de DIV (de ejemplo); cada uno con un nombre distinto (pueden, opcionalmente, agregarle el classname “draggable” o “droppable” para llegarle por selectores CSS como siempre se puede en jquery) y posicionenlos en cualquier area separada de pantalla (sea usando position: absolute o porque los han colocado dentro de tablas o celdas separadas).
Ahora viene la magia! detrás de jquery: para arrastrar simplemente declaren al DIV1 draggable:
$(”#dragged”).draggable();
Opcionalmente, pueden decirle al objeto draggable que genere un “clon”; esto es, que cuando se inicia el arrastre del objeto; no se arrastra al DIV1, sino a un “clon” del DIV1.
$(”#dragged”).draggable({
helper: ‘clone’
});
Posteriormente viene la declaración del DIV2, en este caso un contenedor de objetos “arrastrados” (droppable); igual que el anterior, podemos indicar que es droppable:
$(”#dropped”).droppable();
Claro, en este caso podemos contar con ciertas opciones para restringir o personalizar nuestro “droppable”:
accept: “.draggable”, : nos permite indicar que tipo de objeto (referencia a un id o selector) aceptará este droppable
activeClass: ‘droppable-active’, :cuando el droppable tenga dentro de si un “draggable”, cambiará su CSS a este estilo
hoverClass: ‘droppable-hover’, : cuando pasamos por encima (mouseover) el objeto draggable, esta será el estilo CSS aplicado
tolerance: ‘fit’ :tipo de tolerancia con los draggables, puede ser “fit”, si caen completo dentro del droppable, “intersect”, si los bordes del droppable y el draggable se intersectan.
Además, droppable posee una serie de “eventos” que pueden ser funciones callback que ocurren cuando un draggable los libera.
ejemplos:
drop: function(ev, ui) { //ocurre cuando el draggable cae dentro del droppable
},
activate: function(ev, ui) { //ocurre cuando el draggable se activa (comienza a ser arrastrado)
},
deactivate: function(ev, ui) { //ocurre cuando el draggable deja de ser arrastrado
},
como todo evento de droppable, posee 1 referencia implicita y dos parámetros; la referencia implicita es al objeto “this”; que se refiere al objeto droppable;
$(this).append(”");
o sin necesidad de jquery: var iddrop = this.id;
y ev, que se refiere al gestor de eventos (al DOM Event de la página actual).
con EV podemos obtener ejemplo, las coordenadas de donde ha estado el draggable:
ev.ClientX / evClientY
ahora, quien es ui?, con ese nombre tan críptico, uno no sabe lo que es.
Pues bueno, siguiendo la regla de John Resig (primeras opciones, parámetros, segundas, propiedades, ultimas, callbacks); ese ui debe ser un objeto o una propiedad de droppable; en este caso, UI retorna una referencia al objeto arrastrado (es decir al draggable).
ej.
var id = ui.draggable.element.id;
o
$(ui.draggable.element).
Con lo cual podemos extraer toda la información que necesitemos del elemento que fue arrastrado.
El bloque de código que usé para pruebas fue el siguiente:
$(document).ready(function(){
$(”#dragged”).draggable({
helper: ‘clone’
});
$(”#dropped”).droppable({
accept: “.draggable”,
activeClass: ‘droppable-active’,
hoverClass: ‘droppable-hover’,
drop: function(ev, ui) {
//alert(ev.clientX);
$(this).append(”<br>Dropped!”);
},
deactivate: function(ev, ui) {
alert(ui.draggable.element.id);
$(this).append($(document.createElement(’div’)).text(’deactivate’));
},
tolerance: ‘fit’
});
});
