ASP.NET MVC: Enlazar una propiedad a jQuery UI Slider

¡Hola! Un compañero me ha preguntado si era posible enlazar una propiedad (de tipo int) a un control slider de jQuery UI. La verdad es que sí que es posible y vamos a ver en este post una posible solución que de hecho es extrapolable a otras situaciones parecidas que podáis tener.

Templated helpers al rescate

En ASP.NET MVC2 introdujeron el concepto de templated helpers un mecanismo para construir la interfaz de usuario a partir del tipo de datos del modelo. Simplificando un poco, si colocamos en la carpeta DisplayTemplates y EditorTemplates una vista parcial ASP.NET MVC usará esta vista automáticamente cada vez que se use el método Html.DisplayFor o Html.EditorFor respectivamente.

Si tenemos un Modelo de tipo X que tiene una propiedad, llamémosle Foo, cuyo tipo sea BarType, si hacemos:

  1. @Html.EditorFor(x=>x.Foo)

ASP.NET MVC buscará la vista EditorTemplates/BarType (el nombre de la vista es el tipo de la propiedad usada en EditorFor).

Como esta regla del nombre de tipo puede ser demasiado genérica, también es posible usar el atributo [UIHint] indicando el nombre del template (la vista parcial) a usar para editar o mostrar los datos:

  1. public class FooModel
  2. {
  3.     [UIHint("FooEdit")]
  4.     public BarType Foo { get; set; }
  5. }

Ahora la llamada a Html.EditorFor, buscará la vista llamada FooEdit en EditorTamplates.

Vamos pues a crear el template para editar y visualizar una propiedad de tipo int usando el slider de jQuery UI.

Para ello creamos una vista parcial en Views/Shared/EditorTemplates y le damos el nombre que queramos, en mi caso slider.cshtml. Para crear un slider basta con tener un <div> y luego llamar al método slider() (doy por supuesto que jQuery UI se ha descargado y está referenciada). Así que empezaremos con este código:

  1. <script type="text/javascript">
  2.     $(document).ready(function () {
  3.         $("#slider").slider();
  4.     });
  5. </script>
  6. <div id="slider">
  7. </div>

Con esto creamos el slider pero dado que estamos en modo edición, necesitamos alguna manera para guardar el valor que el usuario seleccione. Una forma rápida de hacerlo es tener un hidden que mantenga en todo momento el valor que el usuario seleccione en el slider. Y aquí nos surge la primera duda: que valor ha de tener el atributo name para que luego ASP.NET MVC sea capaz de reconocerlo y enlazarlo a la propiedad del viewmodel? El problema es que el valor del atributo name depende del nombre de la propiedad que estamos enlazando así que hemos de recuperar este nombre… Por suerte podemos saber este nombre, usando la propiedad HtmlFieldPrefix de la propiedad TemplateInfo del ViewData. Es decir, podemos generar el campo hidden así:

  1. <input type="hidden" name="@ViewData.TemplateInfo.HtmlFieldPrefix"/>

Finalmente sólo nos queda suscrbirnos al evento change del slider y actualizar el campo hidden. Para ello deberemos añadir un id (he usado slider_hidden) al campo hidden y usar el siguiente código para crear el slider:

  1. <script type="text/javascript">
  2.     $(document).ready(function () {
  3.         var options = {
  4.             change: function (event, ui) {
  5.                 $("#slider_hidden").val(ui.value);
  6.             }     
  7.         };       
  8.         $("#slider").slider(options);
  9.     });
  10. </script>

Con eso ya podemos crear un ViewModel con una propiedad int, decorada con [UIHint(“silder”)] y observar como aparece el slider para editar la propiedad. P.ej. dado el siguiente ViewModel:

  1. public class Ratio
  2. {
  3.     public string Texto { get; set; } 
  4.     [UIHint("slider")]
  5.     public int Rating2 { get; set; }
  6. }

Una vista para editar un objeto Ratio sería tan sencilla como:

  1. @using MvcSliderBinding.Models
  2. @model Ratio
  3. @{
  4.     ViewBag.Title = "title";   
  5. }
  6. @using (Html.BeginForm())
  7. {
  8.     @Html.LabelFor(x => x.Texto)
  9.     @Html.EditorFor(x => x.Texto)
  10.     <br />
  11.     @Html.LabelFor(x => x.Rating)
  12.     @Html.EditorFor(x => x.Rating)
  13.     
  14.     <input type="submit" />
  15. }

Al usar @Html.EditorFor(x=>x.Rating), al ser Rating una propiedad decorada con UIHint(“slider”) se va a usar el editor template que hemos creado antes.

Ya tenemos enlazado una propiedad con el slider de jQuery! Ahora vamos a pulir detalles…

Preparándolo para que pueda haber más de un slider

El template de edición que hemos creado NO admite ser repetido en una misma vista, ya que usa ids estáticos para el <div> que será el slider y el hidden que contiene el valor. Si tuviéramos un viewmodel que tiene dos propiedades y quisiéramos usar dos sliders no nos funcionaría bien. Para solucionarlo nos basta con asegurar que los IDs son siempre distintos. Hay varias maneras, una es usar como id un prefijo y el valor que nos da HtmlFieldPrefix, ya que ese se supone único. Otro es usar un GUID, como se muestra a continuación:

  1. @model Nullable<int>
  2. @{
  3.     var suffix = Guid.NewGuid().ToString(); 
  4. }
  5. <script type="text/javascript">
  6.     $(document).ready(function () {
  7.         var options = {
  8.             value: @(Model.HasValue ? Model.Value : min),
  9.             change: function (event, ui) {
  10.                 $("#@suffix").val(ui.value);
  11.             }
  12.         };  
  13.         $("#slider_@(suffix)").slider(options);
  14.     });
  15. </script>
  16. <div id="slider_@(suffix)">
  17. </div>

Guardamos en suffix el GUID creado y lo añadimos al hidden y al div. Un detalle más que aprovecho para enseñaros es establecer el valor inicial del slider al valor que tenga la propiedad (que está en Model). Pero, si estamos creando el objeto el valor de Model será null. Es por ello que debo declarar que el modelo de la vista es de tipo Nullable<int>, en lugar de int, para poder aceptar esos valores nulos.

Accediendo a la información del viewmodel

Una cosa muy interesante al usar template helpers, es que nuestro template helper puede acceder a información del viewmodel que define la propiedad. Es decir, dentro del template helper, yo puedo saber cual es la propiedad que estoy editando (en mi caso es Rating) y tengo información sobre la clase que define dicha propiedad (en mi caso Ratio). A esos datos se puede acceder a través de ViewData.ModelMetadata:

image

Podeis usar las propiedades de ViewData.ModelMetadata para realizar ciertas tareas, como analizar el ViewModel en busca de atributos que os puedan ayudar a definir como renderizar el template… lo que se os ocurra.

Un ejemplo de esto, imaginad que tenemos una propiedad decorada con el atributo [Range], para indicar que acepta un rango de valores. Pues desde aquí podríais consultar dicho atributo Range (teneis acceso al Type del ViewModel y sabeis el nombre de la propiedad) y configurar el slider para que sólo acepte entradas en este rango.

Es lo que he hecho yo, salvo que en lugar de usar reflection para acceder al atributo Range, lo que he hecho es obtener los validadores que hay asociados a la propiedad y generar código acorde a ellos. Para ello uso el método GetVaidators() de ModelMetadata:

  1. @model Nullable<int>
  2. @{
  3.     var suffix = Guid.NewGuid().ToString();
  4.  
  5.     bool hasRange = false;
  6.     var rangeVal = ViewData.ModelMetadata.GetValidators(ViewContext.Controller.ControllerContext).OfType<RangeAttributeAdapter>().FirstOrDefault();
  7.     ModelClientValidationRangeRule rule = null;
  8.     var min = 0;
  9.     var max = -1;
  10.     if (rangeVal != null)
  11.     {
  12.         rule = rangeVal.GetClientValidationRules().OfType<ModelClientValidationRangeRule>().FirstOrDefault();
  13.         if (rule != null)
  14.         {
  15.             min = Convert.ToInt32(rule.ValidationParameters["min"]);
  16.             max = Convert.ToInt32(rule.ValidationParameters["max"]);
  17.         }
  18.     }
  19.  
  20. }

Llamo a GetValidatos y busco el validador de tipo RangeAttributeAdapter. Eso es lo mismo que buscar si existe un atributo [Range], salvo que es más genérico (aunque no entraremos en detalles, simplemente comentar que DataAnnotations es una manera de añadir validadores, pero pueden haber más). Si existe el validador de rango, obtengo su configuración, en concreto sus valores mínimo y máximo, y me los guardo. Con esto ahora tengo información para generar un slider que sólo acepte valores en este rango:

  1. <script type="text/javascript">
  2.     $(document).ready(function () {
  3.         var options = {
  4.          @if (rule!=null)
  5.          {
  6.             @:min: @min,
  7.             @:max: @max,
  8.          }
  9.             value: @(Model.HasValue ? Model.Value : min),
  10.             change: function (event, ui) {
  11.                 $("#@suffix").val(ui.value);
  12.             }
  13.         };       
  14.         $("#slider_@(suffix)").slider(options);
  15.     });

Listos! Ahora tenemos un editor que además respeta el validador de rango que tenga la propiedad.

Y así podríamos ir perfilando este template de edición con todo lo que necesitáramos para adaptarlo a nuestras necesidades… ¡Simple, sencillo y potentísimo!

Os dejo un proyecto VS2010 con la implementación del template de edición y uno de visualización para que podáis verlo en acción: https://skydrive.live.com/?cid=6521c259e9b1bec6&sc=documents&uc=1&id=6521C259E9B1BEC6%21167#

Espero que os haya sido útil! Un saludo!

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *