Y el combate se decidió por KO (vi)–Validaciones

Bueno… sigamos con otro post sobre esta serie en la que vamos hablando de cosas sobre knockout. Y en esta ocasión toca hablar de como validar los campos que tengamos enlazados en un formulario.

Dado que estamos moviendo toda nuestra lógica al viewmodel de cliente, es lógico asumir que las validaciones irán también en él, en lugar de estar “ancladas” al DOM como ocurre cuando usamos jQuery validate, p.ej. Si usamos knockout lo normal es tener los campos de nuestro formulario enlazados con propiedades de nuestro viewmodel.

Extendiendo observables

Lo primero que necesitamos para poder aplicar una validación en un viewmodel de knockout es poder colocar código en las propiedades del viewmodel. De esa forma podremos poner el código que queramos cuando se establezca el valor de dicha propiedad. Pues bien ello es posible, pero con una condición: que dichas propiedades sean observables. Para ello se usa la técnica de extender un observable a través del objeto ko.extenders.

Retomemos el ejemplo del post anterior y añadamos una vista de edición de cervezas. Para ello, creamos un método en el controlador de WebApi para que nos devuelva una cerveza:

public Beer GetById(int id)

{

    return beers[id];

}

Y luego creamos una vista para el controlador HomeController que llamaremos Edit. El código inicial puede ser algo como:

@model int

 

@{

    ViewBag.Title = "Edit Beer";

}

 

@section scripts

{

    <script type="text/javascript">

        $(document).ready(function() {

            var getUri = "@Url.RouteUrl("DefaultApi", new {httproute="", controller="Beers", id=Model.ToString()})";

            $.getJSON(getUri, function (data)

            {

                createViewModel(data);

            });

        });

 

        function createViewModel(jsonData)

        {

            var vm = {

                name: ko.observable(jsonData.Name),

                brewery: ko.observable(jsonData.Brewery),

                ibu: ko.observable(jsonData.Ibu)

            };

            ko.applyBindings(vm);

        }

    </script>

 

}

 

@using (Html.BeginForm())

{

    <fieldset>

        <legend>Edit Beer</legend>

        <div class="editor-label">

            <label for="name">Name:</label>

        </div>

        <div class="editor-field">

            <input type="text" id="name" data-bind="value: name"/>

        </div>

 

        <div class="editor-label">

           <label for="brewery">Brewery</label>

        </div>

        <div class="editor-field">

            <input type="text" id="brewery" data-bind="value: brewery"/>

        </div>

 

        <div class="editor-label">

            <label for="ibu">Ibu</label>

        </div>

        <div class="editor-field">

            <input type="text" id="ibu" data-bind="value: ibu"/>

        </div>

        <p>

            <input type="button" value="Save" id="cmdSave"/>

        </p>

    </fieldset>

}

La vista recibe el ID de la cerveza a editar, hace la llamada via Ajax para obtener esos datos, crea el viewmodel de knockout y muestra los campos de la UI enlazados.

Vamos a validar los IBUs. Los IBUs son una medida que indican la amargura de una cerveza. Una lager normal suele estar alrededor de los 30-35 IBUs mientras que una IPA puede alcanzar los 150. Así que vamos a meter una validación para que el valor de los IBUs sea numérico 🙂

Para ello vamos a extender el observable ibu. Para ello debemos añadir la función que extiende el observable en ko.extenders. Extender un observable significa declarar una función que se ejecutará cuando se acceda a dicho observable. Dicha función puede hacer algo y debe devolver un observable (que es el que se terminará enlazando al campo enlazado al observable inicial). Usualmente se devuelve el propio observable original, pero se puede devolver un observable calculado que use el original de cualquier manera.

Empecemos pues por declarar una función que valide si ibu es un número. Para ello añadimos al principio de la función createViewModel:

ko.extenders.numericval = function (target, params) {

    function validate(value) {

        return  value % 1 == 0;

    }

    validate(target());

    target.subscribe(validate);

 

    return target;

};

En este código hacemos cuatro cosas:

  1. Definimos y añadimos el campo numericval dentro de ko.extenders. Dicho campo es una función.
  2. Dentro de dicha función definimos otra función interna que es la que realmente comprueba si un valor es entero o no.
  3. Realizamos una primera validación (del valor inicial del observable)
  4. Suscribimos la función validate al observable. Cada vez que el observable se modifique la función validate se ejecutará.

Si ahora ejecutáramos el código veríamos que no ocurre nada. El código dentro de ko.extenders.numericval no se ejecuta nunca. La razón es que hemos definido la extensión del observable pero nos falta extender el observable en sí. Eso se consigue con el método extend. Este método recibe un objeto json con una propiedad. El nombre de la propiedad es la extensión a aplicar y el valor de la propiedad es el valor que tomará el segundo parámetro (params) de la extensión que hemos creado (el primer parámetro target es el observable que extendemos):

var vm = {

    name: ko.observable(jsonData.Name),

    brewery: ko.observable(jsonData.Brewery),

    ibu: ko.observable(jsonData.Ibu).extend({ numericval: "" })

};

Ahora sí! Hemos definido una extensión (numericval) y la hemos aplicado al observable ibu. Le pasamos “” como parámetros (que tampoco usamos para nada).

Pero esta extensión todavía NO hace nada. Es decir, si depuráis el código javascript veréis que se efectivamente cada vez que se modifica el observable ibu se ejecuta el método validate, pero este método no hace nada salvo devolver true o false.

¿Como podemos informar al usuario de que el valor es incorrecto?

Subobservables

Pues la solución a la pregunta anterior pasa por usar un “subobservable”. Un subobservable es un observable definido dentro de otro observable. Vamos pues a crear un subobservable, que llamaremos hasError. Este subobservable lo definiremos dentro del observable que extendamos, es decir dentro de target. Luego modificaremos validate() para que en lugar de devolver true o false, establezca el valor del subobservable hasError:

ko.extenders.numericval = function (target, params) {

    target.hasError = ko.observable();

    function validate(value) {

        target.hasError(!(value % 1 == 0));

    }

    validate(target());

    target.subscribe(validate);

    return target;

};

Y ya casi estamos! Ahora nos queda un punto que es… enlazar un elemento de la UI al subobservable. ¿Y como enlazamos a un subobservable? Pues del mismo modo que enlazamos a un observable normal, salvo que ahora el nombre del observable es “observable.subobservable”. Así si queremos enlazar algo al valor del subobservable hasError, deberemos usar “ibu.hasError” como nombre:

<div class="editor-field">

    <input type="text" id="ibu" data-bind="value: ibu, css: {‘input-validation-error’: ibu.hasError, ‘field-validation-error’ : ibu.hasError}"/>

</div>

Fijaos en el atributo data-bind del <input>. Ahora estoy usando dos bindings:

  1. value (que ya usábamos) para enlazar el valor
  2. css para aplicar clases css en función del valor del observable. El binding css toma un objeto json, en el cual los nombres de las propiedades son las clases que se aplicarán y el valor de dichar propiedades es un campo del viewmodel. Si vale true se aplica la clase y si vale false no. En este caso:
    1. Se aplicará input-validation-error si ibu.hasError vale true
    2. Se aplicará field-validation-error si ibu.hasError vale true

Nota: En este caso he puesto los nombres de las clases entre comillas simples porque esos nombres no son identificadores javascript válidos. Si los nombres de las clases a aplicar son identificadores javascript válidos, no es necesario entrecomillarlos.

Por supuesto podríamos añadir un mensaje de error, p.ej. en un <span> que se visualice si ibu.hasError vale true. Para ello podemos usar el binding visible que tiene knockout:

<div class="editor-field">

    <input type="text" id="ibu" data-bind="value: ibu, css: {‘input-validation-error’: ibu.hasError, ‘field-validation-error’ : ibu.hasError}"/>

    <span data-bind="visible: ibu.hasError" class="message-error">Error: Debe ser numérico</span>

</div>

¡Y listos!

Aquí tenéis el resultado:

image

Un tema que se observa si se ejecuta el código es que el observable ibu no se modifica cada vez que tecleamos, si no tan solo cuando el textbox pierde el foco. Pero como ya vimos en el post anterior, eso tiene fácil solución.  Basta con usar valueUpdate:

<input type="text" id="ibu" data-bind="value: ibu, valueUpdate: ‘afterkeydown’ ,

    css: {‘input-validation-error’: ibu.hasError, ‘field-validation-error’ : ibu.hasError}"/>

Y con eso hemos terminado. Apuntar solamente que las extensiones se “almacenan” en ko.extenders y son independientes del viewmodel (recordad que debemos “aplicarlas” usando extend). Por lo tanto podemos tener nuestras librerías de “validaciones” con knockout!

Espero que os haya resultado interesante!

Os dejo el ejemplo completo en my skydrive: https://skydrive.live.com/redir?resid=6521C259E9B1BEC6!174 (Nota el zip es KoDemoVI.zip, aunque la solución y la carpeta luego se llamen KoDemoV). Para probar la edición basta con ir a /Home/Edit/{id}, pasando el id de la cerveza.

Saludos!

Deja un comentario

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