• Que es?
  • Documentación
  • Integración con jQuery Validation
  • Descarga
  • Demos

jQuery Rut es un sencillo plugin para formatear y validar el rut chileno.

Es flexible, configurable y fácil de usar. Descargalo, mira los ejemplos, y empieza a disfrutar.

Cargando dependencias

Asegurate que jQuery esta cargado antes que Rut.

<script src="jquery.js" type="text/javascript"></script>
<script src="jquery.Rut.js" type="text/javascript"></script>


Metodos del plugin


Rut( [options] )

options (opcional)       Options

Un conjunto de pares clave/valor para configurar el comportamiento. Todas las opciones son opcionales.

Opciones

on_error Callback Default: function(){}
Callback llamado cuando el rut ingresado es incorrecto.
  • Code
Muestra un alert diciendo que el rut es incorrecto.
$("#rut").Rut({
   on_error: function(){ alert('El rut ingresado es incorrecto'); }
})

on_success Callback Default: function(){}
Callback llamado cuando el rut ingresado es correcto.
  • Code
Muestra un alert diciendo que el rut es correcto.
$("#rut").Rut({
   on_success: function(){ alert('El rut es correcto'); }
})

digito_verificador Selector
Añade la opción de tener el digito verificador del rut en otro input.
  • Code
El rut esta en el input #rut y el digito verificador en otro input #digito-verificador .
$("#rut").Rut({
   digito_verificador: "#digito-verificador"
})

validation Boolean Default: true
Añade la posibilidad de que no se efectué la validación del rut, para en casos en el que por ejemplo sólo se quiere formatear el rut.
  • Code
En este caso no se efectuaría la validación.
$("#rut").Rut({
   validation: false
})

format Boolean Default: true
Añade la posibilidad de que no se efectué el formateo del rut, para en casos en el que por ejemplo sólo se quiere validar el rut.
  • Code
En este caso no se efectuaría el formateo.
$("#rut").Rut({
   format: false
})

format_on Event Default: change
Añade la posibilidad de cambiar el evento que gatilla el formateo del rut. ( Lo he probado sólo con keyup y change)
  • Code
En este caso el formateo del rut se efectuaría mientras lo voy escribiendo.
$("#rut").Rut({
   format_on: 'keyup'
})


Usando las funciones directamente

Es posible también utilizar las funciones directamente para mayor comodidad y utilidad.
Las funciones disponibles son:

formatear(rut)

rut      String


Función que da formato al rut.
$.Rut.formatear('123456789');
=> 12.345.678-9

quitarFormato(rut)

rut      String


Función que quita el formato al rut.
$.Rut.quitarFormato('12.345.678-9');
=> 123456789

getDigito(rut)

rut      String


Función que obtiene el digito verificador del rut (el rut es pasado sin formato).
$.Rut.getDigito('12995912');
=> 6

validar(rut)

rut      String


Función que valida si el rut es correcto.
$.Rut.validar('12.995.912-6');
=> true

Demo integración con jQuery Validation Plugin

  

Código

$.validator.addMethod("rut", function(value, element) {
  return this.optional(element) || $.Rut.validar(value);
}, "Este campo debe ser un rut valido.");

$("#jq-validation").validate();
              
<input type="text" name="rut_demo_int" class="required rut"/>

Descarga

Requiere jQuery 1.2.x.

Descarga jQuery Rut Plugin

Demo 1

 

Código

$('#rut_demo_1').Rut(); <input type="text" id="rut_demo_1" name="rut_demo_1" />

Demo 2

 

Código

$('#rut_demo_2').Rut({
  on_error: function(){ alert('Rut incorrecto'); }
});
<input type="text" id="rut_demo_2" name="rut_demo_2" />

Demo 3

 

 

Código

$('#rut_demo_3, #rut_demo_4').Rut({
  on_error: function(){ alert('Rut incorrecto'); },
  on_success: function(){ alert('Rut correcto'); }
});
<input type="text" id="rut_demo_3" name="rut_demo_3" />
<input type="text" id="rut_demo_4" name="rut_demo_4" />

Demo 5

 

Código

$('#rut_demo_5').Rut({
  on_error: function(){ alert('Rut incorrecto'); },
  format_on: 'keyup'
});
<input type="text" id="rut_demo_5" name="rut_demo_5" />

Demo 6

  -

Código

$('#rut_demo_6').Rut({
  validation: false,
  format_on: 'keyup',
  digito_verificador: '#digito_verificador_demo_6'
});
<input type="text" id="rut_demo_6" name="rut_demo_6" /> -
<input type="text" id="digito_verificador_demo_6" name="digito_verificador_demo_6" size="1" />

Demo 7

  -

Código

$('#rut_demo_7').Rut({
  digito_verificador: '#digito_verificador_demo_7',
  on_error: function(){ alert('Rut incorrecto'); }
});
<input type="text" id="rut_demo_7" name="rut_demo_7" /> -
<input type="text" id="digito_verificador_demo_7" name="digito_verificador_demo_7" size="1" />

Contacto

  • Copyleft 2008 José Joaquín Núñez
  • Licencia GPL
  • Generador de ruts chilenos validos