pon css en tu vida!

Uno de los primeros posts que escribí en este blog, fue un tutorial para crear un sistema de valoración por css.

Ese sistema nos puede interesar cuando no necesitamos la valoración del usuario, y tan solo queremos mostrar un ranking estático de forma mucho más visual de lo que podría ser el típico numero de 1 a 5.

Hoy, para cerrar el círculo, vamos a ver como crear otro sistema de valoración, esta vez utilizando jQuery.

- VER DEMO - | - DESCARGAR EJEMPLO -

Creando el HTML

El código HTML necesario es muy simple:

<h1>Test rating jQuery</h1>
<div id="rating">
<span class="moving-bg">&nbsp;</span>
<span>&nbsp;</span>
</div>
<div id="status2">8.0</div>
<div id="msg"></div>

Necesitamos 2 capas, una para la barra (rating), otra para el valor numérico de la votación (status2). La tercera capa (msg) es simplemente para mostrar al usuario la votación que ha realizado, y es totalmente prescindible.

Como veis, el código no es demasiado semántico, pero es algo que se puede perdonar en favor de una mayor interactividad por parte del usuario.

Los resultados, por ahora, no son espectaculares.

Añadiendo CSS.

Para formar la “rejilla” de valoración, necesitaremos 2 imágenes: la rejilla y el fondo con el degradado.

La idea es la siguiente:

rainbow.png y grid.png son imágenes de fondo para el div#rating y el segundo span, respectivamente. El span.moving-bg, situado en medio de los dos, es el que iremos moviendo dependiendo de la posición del cursor, o del valor de la votación.

Al desplazar el span gris,  a través de las transparencias de grid.png se podrá ver el degradado que hay como fondo, dando la sensación de que son las “celdas” de grid.png las que se van “llenando”.

El CSS quedaría así:

#rating {
background: transparent url(images/rainbow.png) 0 0 no-repeat;
width: 216px;
height: 41px;
float: left;
position: relative;
z-index: 2;
overflow: hidden;
cursor: pointer;
}
#rating span{
display: block;
width: 216px;
height: 41px;
background: transparent url(images/grid.png) 0 0 no-repeat;
position: relative;
z-index: 1;
}
#rating span.moving-bg{
position: absolute;
top:0;
left:0;
background-image: none;
background-color: #CCC;
}
#status2 {
width: 50px;
float: left;
border: 1px solid #ccc;
border-radius: 5px;
-webkit-border-radius: 5px;
-moz-border-radius: 5px;
-khtml-border-radius: 5px;
font-size: 2em;
text-align: center;
font-weight: bold;
margin-left: 10px;
}
#msg {
clear: both;
}

Después aplicar los estilos del CSS, el resultado mejora notablemente.

Dale vida con jQuery

Ahora, lo tenemos todo ya preparado para añadir el “toque mágico” con jQuery, y convertir esto en un sistema de valoración como esperamos.

Analizando la situación, nos damos cuenta de que tendremos cuatro escenarios diferentes:

1. Carga de la página
2. El usuario sitúa el cursor encima de la barra.
3. El usuario hace clic para emitir su voto.
4. El usuario quita el cursor de la barra.

Sabemos que una tarea que tendremos que repetir con frecuencia es la de actualizar la posición del fondo gris, por lo tanto vamos a crear una sencilla función, para que nuestro código esté lo más limpio posible.

/**
 * Mueve la capa de "color" para que se adapte al valor
 * pasado.
 * @param valor int
 * @param tamanyo_capa int
 */
function actualizarPos (valor, tamanyo_capa) {
var p = Math.round(valor * tamanyo_capa / 10);
$('#rating span.moving-bg').animate( { left: p }, 500 );
}

actualizarPos tan solo actualiza, dependiendo del tamaño de la capa contenedora, la posición del fondo gris, dependiendo de la valoración (valor).
Nos valdremos de la función de jQuery document.ready, para ejecutar nuestro código cuando ya el DOM esté cargado:

$(document).ready( function() {
// Obtenemos el valor inicial
var valoracion_defecto = parseFloat($('#status2').html());
// Obtenemos el tamaño del div
var w = $('#rating').css('width');
// eliminamos el px
var width_div = parseInt(w.slice(0,w.length-2));

// Al usuario siempre mostraremos una cifra con un solo decimal
var valoracion_defecto_num = valoracion_defecto.toPrecision(2);
actualizarPos(valoracion_defecto, width_div);

   $("#rating").mousemove(function(e){

// Obtenemos la posición del cursor dentro del elemento
var x = e.pageX - this.offsetLeft;
// Desplazamos la barra gris hasta esa posición
$('#rating span.moving-bg').css('left', x);
// Actualizamos el valor numérico
// Este valor siempre será un entero
$('#status2').html(Math.round(x*10/width_div));

   });
   $("#rating").click(function(e){
// Obtenemos la posicion del cursor dentro del elemento.
var x = e.pageX - this.offsetLeft;
// Obtenemos el resultado de la votación
var r = Math.round(x*100/width_div/10);

// Actualizamos el valor numerico
valoracion_defecto = (valoracion_defecto + r) / 2;
// lo mostramos en pantalla, siempre con un solo decimal
valoracion_defecto_num = valoracion_defecto.toPrecision(2);
$('#status2').html(valoracion_defecto_num);

// Actualizamos la posición de la barra gris
actualizarPos(valoracion_defecto, width_div);
// Mostramos el mensaje al usuario de su voto.
$('#msg').html("Has votado: " + r);
   });

   $("#rating").mouseout(function(e){
// Actualizamos el valor numérico al que pertenece
$('#status2').html(valoracion_defecto_num);
// Actualizamos la posición de la barra gris
actualizarPos(valoracion_defecto, width_div);
   });

});

Dividimos el código en cuatro bloques:
Al cargar la página, obtenemos el valor por defecto de la votación y posicionamos la barra gris dependiendo del valor obtenido.
La valoración que se muestra al usuario siempre será una cifra con 1 decimal, por lo que utilizamos la función toPrecision().

Cuando el usuario situé el cursor encima del elemento, se ejecutará la función mousemove. En este caso, obtenemos la posición del cursor dentro del elemento, y movemos la barra gris a la posición del cursor. También actualizamos el valor numérico, que deberá ser un entero.

Cuando el usuario mueva el cursor fuera de la barra (mouseout), esta volverá a tomar el valor del campo numérico por defecto.

Si el usuario hace click sobre la barra (click), lo tomaremos como que quiere realizar una valoración. Entonces, actualizaremos el valor para hacer la media entre el valor existente, y su votación.
Si asociamos el sistema a una base de datos, es en este método donde deberemos realizar la consulta de actualización mediante AJAX. Para este tutorial, nos conformaremos con actualizar el valor en pantalla, y que se vea reflejado en la barra.

Utilizando los métodos mousemove, mouseout y click de jQuery, cubrimos todos los posibles estados por los que puede pasar nuestro sistema de valoración, y con pageX y offsetLeft, seremos capaces de conocer la posición del cursor dentro del elemento.

Cómo conectar este sistema a una base de datos, y registrar las votaciones mediante AJAX, lo dejaremos para un próximo capítulo

- VER DEMO -
- DESCARGAR EJEMPLO -