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 -

Durante la maquetación de mi portfolio, me propuse utilizar este método de valoración para representar mi participación en los proyectos que he participado.

La idea.

El sistema es el típico método de valoraciones que todos conocemos (las tan conocidas estrellitas). Dándole “media” vuelta al diseño, cambiando las estrellas por asteríscos, podemos obtener algo así:

– VER EJEMPLO FUNCIONANDO -

Ejecución

A la hora de convertir el diseño en código HTML semántico, lo más adecuado es utilizar la etiqueta <dl>, para definir una lista compuesta por términos (<dt>) y descripciones (<dd>).  Veamos el HTML necesario para crear esta lista:

<dl>
<dt>xhtml</dt>
<dd class="star stars5" title="Total">Total</dd>

<dt>css</dt>
<dd class="star stars4" title="Muy significativa">Muy significativa</dd>

<dt>zendFramework</dt>
<dd class="star stars3" title="Significativa">Significativa</dd>

<dt>jQuery</dt>
<dd class="star stars2" title="Parcial">Parcial</dd>

<dt>diseño</dt>
<dd class="star stars1" title="Puntual">Puntual</dd>
</dl>

Observamos el código html antes de empezar con los estilos para comprobar que es perfectamente legible y comprensible sin la necesidad de CSS.

A la hora de crear las imágenes, vamos a utilizar sprites. Es decir, juntaremos todas las imágenes necesarias en una sola, que posicionaremos mediante CSS para obtener el resultado deseado. En el caso del diseño original, las imágenes de las “estrellas” debían tener el fondo transparente, sin embargo la versión que os muestro para que se aprecie mejor tiene color de fondo:

Utilizar sprites para nuestras imágenes tiene como resultado más significativo la reducción de peticiones al servidor. Suponiendo que creando las cinco imágenes por separado el peso será el mismo que creando tan solo una, la mejora la encontramos en que reducimos de 5 a 1 las veces que el servidor debe entregar archivos al navegador para obtener el mismo resultado.

Mejor con estilos…

Es el momento de darle vida a nuestro HTML, para ello hemos dotado a los elementos de difinición (<dd>) de la lista con dos clases: star y stars5.

Con la primera clase (star) proporcionaremos los estilos comunes a todos los elementos: ancho, alto, imagen de fondo, etc… La segunda clase será diferente dependiendo de la valoración que queramos asignar. En este caso hay cinco posibles opciones: stars5, stars4, stars3, stars2 y stars1. En función a esta clase, posicionaremos la imagen para obtener el resultado deseado. Por lo tanto, el CSS quedaría tal que así…

.star {
width: 74px;
height: 10px;
text-indent: -9999px;
background: transparent url(bg_interface.png) 0 0 no-repeat;
margin: 0 0 16px 13px;
}
.stars5 {
background-position: -1px 0;
}
.stars4 {
background-position: -1px -11px;
}
.stars3 {
background-position: -1px -22px;
}
.stars2 {
background-position: -1px -33px;
}
.stars1 {
background-position: -1px -44px;
}

Más sencillo imposible; asignamos al elemento un tamaño fijo, movemos el texto mediante text-indent para que sea invisible al usuario, y asignamos la imagen de fondo.

Después, tan solo necesitamos posicionar la imagen de fondo para que se muestre la sección correspondiente. Es importante el uso del atributo title, para que el usuario conozca el significado de nuestra puntuación al pasar el cursor por encima de los asteriscos.

- VER DEMO -