Un nuevo plugin para el stack, lo comparto por acá aunque fue escrito hoy día así es que está en Beta, no ha sido probado exigentemente aún.
Sirve para ejecutar una función de callback pasado un intervalo de tiempo en milisegundos sobre un evento que se defina en un elemento.
“Puede ser usado o modificado a voluntad.”
Can be used to execute any callback function on an event after some interval in milliseconds.
(Lo coloque en español e ingles [my so so english :p ]) para que después de indexada en google, búsquedas en español o ingles llegen al post.
Fuente:
Update (02-04-2009): aquí (http://downloads.continuum.cl/downloads/projects/jquery-plugins/oninterval.jquery.js) está el código fuente.
Opciones:
Las opciones que pueden ser pasadas como objeto literal de javascript son:
- event. El evento en la forma jQuery.
blur,focus,load,resize,scroll,unload,beforeunload,click,dblclick,mousedown,mouseup,mousemove,mouseover,mouseout,mouseenter,mouseleave,change,select,submit,keydown,keypress,keyup,error. Solo ha sido probado con los eventos ‘change’ y ‘keyup’. - interval. El intervalo en milisegundos que demorará la ejecución de la función de callback pasada.
- callback: Función que será invocada cuando pase le intervalo de tiempo. A la función le es pasada como argumento el valor del elemento (val() de jQuery) y el objeto evento del DOM. En una versión inicial se pasaba como primer elemento el objeto jQuery que representa el elemento al que se le ejecuta el evento, pero por una razón de fuerza mayor (que solo explicaré si me lo piden porque es extensa) tuve que dejar de hacerlo pasando el valor, no obstante se puede acceder al objeto jQuery en la función de callback.
- doNotExecOnRegexp. Expresión reglar que sera testeada contra el valor del elemento, si el test retorna true la funcion de callback no será invocada.
- onlyExecOnRegexp: Lo contrario a lo anterior, expresión regular contra la que se testea el valor, solo si el test retorna true entonces, se ejecuta la función de callback.
- charNum: Update (02-04-2009). Número de caracteres que deben digitarse antes de gatillar la funcion de callback. Valor default (1).
Nota: Si se especifican las dos expresiones regulares, se hacen ambos chequos, si alguno da false no se ejecuta la función de callback.
Ejemplo del uso:
En cuanto tenga un tiempo escribiré alguna página con ejemplos, por ahora solo la forma de uso.
En este caso se trata de un input text, en el que cuando se escribe texto y se deja de escribir por 2 segundos, se ejecuta la función de callback que en el ejemplo solo escribe en la consola del firebug, pero que puede ejecutar un request Ajax para hacer búsqueda, o lo que se les ocurra. Si el texto del input es ‘Ingrese el nombre’, o se escriben menos de 4 caracteres entonces no se ejecuta la función.
$('#filtro-nombre').onInterval({
event: 'keyup',
interval: 2000,
charNum: 4,
callback: function (value, ev) {
console.log(value);
// do some Ajax here...
},
doNotExecOnRegexp: /^Ingrese el nombre$/
});
…
Nota: No ha sido probado aún para Internet Explorer.
) en su casi totalidad (lo que cupo en el mini DVD en modalidad baja calidad, no obstante se ve bien).
