Seleccionando un origen válido
No existe ningún método específico para detectar si el elemento origen es válido o no. No podemos confiar en la información retornada por el método getData() porque incluso cuando podemos recuperar solo los datos del tipo especificado, otras fuentes podrían originar el mismo tipo y proveer datos que no esperábamos. Hay una propiedad del objeto dataTransfer llamada types que retorna un array con la lista de tipos configurados durante el evento dragstart, pero también es inútil para propósitos de validación.
Por esta razón, las técnicas para seleccionar y validar los datos transferidos en una operación arrastrar y soltar son variados, y pueden ser tan simples o complejos como necesitemos.
Código 8-5. Nueva plantilla con varias imágenes para arrastrar.
<!DOCTYPE html> <html lang="es"> <head> <title>Drag and Drop</title> <link rel="stylesheet" href="dragdrop.css"> <script src="dragdrop.js"></script> </head> <body> <section id="cajasoltar"> Arrastre y suelte las imágenes aquí </section> <section id="cajaimagenes"> <img id="imagen1" src="http://www.minkbooks.com/content/monster1.gif"> <img id="imagen2" src="http://www.minkbooks.com/content/monster2.gif"> <img id="imagen3" src="http://www.minkbooks.com/content/monster3.gif"> <img id="imagen4" src="http://www.minkbooks.com/content/monster4.gif"> </section> </body> </html>
Usando la nueva plantilla HTML del Código 8-5 vamos a filtrar los elementos a ser soltados dentro del elemento destino controlando el atributo id de la imagen. El siguiente código Javascript indicará cuál imagen puede ser soltada y cuál no:
Código 8-6. Enviando el valor del atributo id.
function iniciar(){
var imagenes=document.querySelectorAll('#cajaimagenes > img');
for(var i=0; i<imagenes.length; i++){
imagenes[i].addEventListener('dragstart', arrastrado, false);
}
soltar=document.getElementById('cajasoltar');
soltar.addEventListener('dragenter', function(e){
e.preventDefault(); }, false);
soltar.addEventListener('dragover', function(e){
e.preventDefault(); }, false);
soltar.addEventListener('drop', soltado, false);
}
function arrastrado(e){
elemento=e.target;
e.dataTransfer.setData('Text', elemento.getAttribute('id'));
}
function soltado(e){
e.preventDefault();
var id=e.dataTransfer.getData('Text');
if(id!="imagen4"){
var src=document.getElementById(id).src;
soltar.innerHTML='<img src="'+src+'">';
}else{
soltar.innerHTML='la imagen no es admitida';
}
}
window.addEventListener('load', iniciar, false);
No han cambiado muchas cosas en el Código 8-6 de anteriores códigos. En este código estamos usando el método querySelectorAll() para agregar una escucha para el evento dragstart a cada imagen dentro del elemento cajaimagenes, enviando el valor del atributo id con setData() cada vez que una imagen es arrastrada, y controlando el valor de id en la función soltado() para evitar que el usuario arrastre y suelte la imagen con el atributo igual a ”imagen4” (el mensaje “la imagen no es admitida” es mostrado dentro del elemento destino cuando el usuario intenta arrastrar y soltar esta imagen en particular).
Este es, por supuesto, un filtro extremadamente sencillo. Puede usar el método querySelectorAll() en la función soltado() para controlar que la imagen recibida es una de las que se encuentran dentro del elemento cajaimagenes, por ejemplo, o usar propiedades del objeto dataTransfer (como types o files), pero es siempre un proceso personalizado. En otras palabras, deberemos hacernos cargo nosotros mismos de realizar este control.
setDragImage()
Cambiar la imagen en miniatura que es mostrada junto al puntero del ratón en una operación arrastrar y soltar puede parecer inútil, pero en ocasiones nos evitará dolores de cabeza. El método setDragImage() no solo nos permite cambiar la imagen sino también recibe dos atributos, x e y, para especificar la posición de esta imagen relativa al puntero. Algunos navegadores generan una imagen en miniatura por defecto a partir del objeto original que es arrastrado, pero su posición relativa al puntero del ratón es determinada por la posición del puntero cuando el proceso comienza. El método setDragImage() nos permite declarar una posición específica que será la misma para cada operación arrastrar y soltar.
Código 8-7. <canvas> como elemento destino.
<!DOCTYPE html> <html lang="es"> <head> <title>Drag and Drop</title> <link rel="stylesheet" href="dragdrop.css"> <script src="dragdrop.js"></script> </head> <body> <section id="cajasoltar"> <canvas id="lienzo" width="500" height="300"></canvas> </section> <section id="cajaimagenes"> <img id="imagen1" src="http://www.minkbooks.com/content/monster1.gif"> <img id="imagen2" src="http://www.minkbooks.com/content/monster2.gif"> <img id="imagen3" src="http://www.minkbooks.com/content/monster3.gif"> <img id="imagen4" src="http://www.minkbooks.com/content/monster4.gif"> </section> </body> </html>
Con el nuevo documento HTML del Código 8-7 vamos a estudiar la importancia del método setDragImage() usando un elemento <canvas> como el elemento destino.
Código 8-8. Una pequeña aplicación para arrastrar y soltar.
function iniciar(){
var imagenes=document.querySelectorAll('#cajaimagenes > img');
for(var i=0; i<imagenes.length; i++){
imagenes[i].addEventListener('dragstart', arrastrado, false);
imagenes[i].addEventListener('dragend', finalizado, false);
}
soltar=document.getElementById('lienzo');
lienzo=soltar.getContext('2d');
soltar.addEventListener('dragenter', function(e){
e.preventDefault(); }, false);
soltar.addEventListener('dragover', function(e){
e.preventDefault(); }, false);
soltar.addEventListener('drop', soltado, false);
}
function finalizado(e){
elemento=e.target;
elemento.style.visibility='hidden';
}
function arrastrado(e){
elemento=e.target;
e.dataTransfer.setData('Text', elemento.getAttribute('id'));
e.dataTransfer.setDragImage(e.target, 0, 0);
}
function soltado(e){
e.preventDefault();
var id=e.dataTransfer.getData('Text');
var elemento=document.getElementById(id);
var posx=e.pageX-soltar.offsetLeft;
var posy=e.pageY-soltar.offsetTop;
lienzo.drawImage(elemento,posx,posy);
}
window.addEventListener('load', iniciar, false);
Probablemente, con este ejemplo, nos estemos acercando a lo que sería una aplicación de la vida real. El código 8-8 controlará tres diferentes aspectos del proceso. Cuando la imagen es arrastrada, la función arrastrado() es llamada y en su interior una imagen miniatura es generada con el método setDragImage(). El código también crea el contexto para trabajar con el lienzo y dibuja la imagen soltada usando el método drawImage() estudiado en el capítulo anterior. Al final de todo el proceso la imagen original es ocultada usando la función finalizado().
Para la imagen miniatura personalizada usamos el mismo elemento que está siendo arrastrado, pero declaramos la posición relativa al puntero del ratón como 0,0. Gracias a esto ahora sabremos siempre cual es exactamente la ubicación de la imagen miniatura.
Aprovechamos este dato importante dentro de la función soltado(). Usando la misma técnica introducida en el capítulo anterior, calculamos dónde el objeto es soltado dentro del lienzo y dibujamos la imagen en ese lugar preciso. Si prueba este ejemplo en navegadores que ya aceptan el método setDragImage() (por ejemplo, Firefox 4+), verá que la imagen es dibujada en el lienzo exactamente en la posición de la imagen miniatura que acompaña al puntero del ratón, haciendo fácil para el usuario seleccionar el lugar adecuado donde soltarla.
IMPORTANTE: El código 8-8 usa el evento dragend para ocultar la imagen original cuando la operación termina. Este evento es disparado por el elemento origen cuando una operación de arrastre finaliza, incluso cuando no fue exitosa. En nuestro ejemplo la imagen será ocultada en ambos casos, éxito o fracaso.
Usted deberá crear los controles adecuados para actuar solo en caso de éxito.
Archivos
Posiblemente la característica más interesante de la API Drag and Drop es la habilidad de trabajar con archivos. La API no está solo disponible dentro del documento, sino también integrada con el sistema, permitiendo a los usuarios arrastrar elementos desde el navegador hacia otras aplicaciones y viceversa. Y normalmente los elementos más requeridos desde aplicaciones externas son archivos.
Como vimos anteriormente, existe una propiedad especial en el objeto dataTransfer que retornará un array conteniendo la lista de archivos que están siendo arrastrados.
Podemos usar esta información para construir complejos códigos que trabajan con archivos o subirlos a un servidor.
Código 8-9. Plantilla simple para arrastrar archivos.
<!DOCTYPE html> <html lang="es"> <head> <title>Drag and Drop</title> <link rel="stylesheet" href="dragdrop.css"> <script src="dragdrop.js"></script> </head> <body> <section id="cajasoltar"> Arrastre y suelte archivos en este espacio </section> </body> </html>
El documento HTML del Código 8-9 genera simplemente una caja para soltar los archivos arrastrados. Los archivos serán arrastrados desde una aplicación externa (por ejemplo, el Explorador de Archivos de Windows). Los datos provenientes de los archivos serán procesados por el siguiente código:
Código 8-10. Procesando los datos en la propiedad files.
function iniciar(){
soltar=document.getElementById('cajasoltar');
soltar.addEventListener('dragenter', function(e){
e.preventDefault(); }, false);
soltar.addEventListener('dragover', function(e){
e.preventDefault(); }, false);
soltar.addEventListener('drop', soltado, false);
}
function soltado(e){
e.preventDefault();
var archivos=e.dataTransfer.files;
var lista='';
for(var f=0;f<archivos.length;f++){
lista+='Archivo: '+archivos[f].name+' '+archivos[f].size+'<br>';
}
soltar.innerHTML=lista;
}
window.addEventListener('load', iniciar, false);
La información retornada por la propiedad files del objeto dataTransfer puede ser grabada en una variable y luego leída por un bucle for. En el código 8-10, solo mostramos el nombre y el tamaño del archivo en el elemento destino usando las propiedades name y size. Para aprovechar esta información y construir aplicaciones más complejas, necesitaremos recurrir a otras APIs y técnicas de programación, como veremos más adelante en esta serie de publicaciones.
Hágalo usted mismo: Cree nuevos archivos con los códigos 8-9 y 8-10, y abra la plantilla en su navegador. Arrastre archivos desde el Explorador de Archivos o cualquier otra aplicación similar dentro del elemento destino. Luego de esta acción debería ver en pantalla una lista con el nombre y tamaño de cada archivo arrastrado.
Referencia rápida
La API Drag and Drop introduce eventos específicos, métodos y propiedades para construir aplicaciones que incorporan la capacidad de arrastrar y soltar elementos en pantalla.
Eventos
Existen siete eventos para esta API:
- dragstart Este evento es disparado por el elemento origen cuando la operación de arrastre comienza.
- drag Este evento es disparado por el elemento origen mientras una operación de arrastre se está realizando.
- dragend Este evento es disparado por el elemento origen cuando una operación de arrastre es terminada, ya sea porque la acción de soltar fue exitosa o porque la operación de arrastre fue cancelada.
- dragenter Este evento es disparado por el elemento destino cuando el puntero del ratón entra en el área ocupada por este elemento. Este evento siempre tiene que ser cancelado usando el método preventDefault().
- dragover Este evento es disparado periódicamente por el elemento destino cuando el puntero del ratón está sobre él. Este evento siempre tiene que ser cancelado usando el método preventDefault().
- drop Este evento es disparado por el elemento destino cuando el elemento origen es soltado en su interior. Este evento siempre tiene que ser cancelado usando el método preventDefault().
- dragleave Este evento es disparado por el elemento destino cuando el puntero del ratón sale del área ocupada por el mismo.
Métodos
La siguiente es una lista de los métodos más importantes incorporados por esta API:
- setData(tipo, dato) Este método es usado para preparar los datos a ser enviados cuando el evento dragstart es disparado. El atributo tipo puede ser cualquier tipo de datos regular (como text/plain o text/html) o un tipo de datos personalizado.
- getData(tipo) Este método retorna los datos del tipo especificado. Es usado cuando un evento drop es disparado.
- clearData(type) Este método remueve los datos del tipo especificado.
- setDragImage(elemento, x, y) Este método reemplaza la imagen en miniatura creada por el navegador en la operación arrastrar y soltar por una imagen personalizada. También declara la posición que esta imagen tendrá con respecto al puntero del ratón.
Propiedades
El objeto dataTransfer, que contiene los datos transferidos en una operación arrastrar y soltar, también introduce algunas propiedades útiles:
- types Esta propiedad retorna un array con todos los tipos establecidos durante el evento dragstart.
- files Esta propiedad retorna un array con información acerca de los archivos que están siendo arrastrados.
- dropEffect Esta propiedad retorna el tipo de operación actualmente seleccionada. Los valores posibles son: none, copy, link y move.
- effectAllowed Esta propiedad retorna los tipos de operación que están permitidos. Puede ser declarada para cambiar las operaciones permitidas. Los posibles valores son: none, copy, copyLink, copyMove, link, linkMove, move, all y uninitialized.
Twittear
No hay comentarios:
Publicar un comentario