Documentación



Clase isiAJAX

Definicion: Crea una clase para empezar a trabajar con AJAX.

Parametros: Tiene como opcion las urls de tipo: http://www.example.com/#inicio.html. Pues el primer parametro debe ser el ID donde debe se quiera cargar el contenido de inicio.html en este caso. De esta manera si estamos por ejemplo en google e introducimos en la barra de direcciones esta url: http://www.example.com/#inicio.html quiere decir que cargara todo el contenido de inicio.html en la capa que pongamos como primer parametro.
El segundo parametro sirve para activar el cargador. Es decir, si hemos definido el ID del cargador, cada vez que hacemos una peticion la capa cargador se hara visible, y al terminar se ocultara automaticamente. Por eso como segundo parametro seria poner el ID del elemento a ocultar o mostrar.

Devuelve: Un mensaje de Alerta si no se ha podido crear el objeto XMLHttp

Metodos:

Modo de uso:

myajax = new isiAJAX();

myajax = new isiAJAX('idmain');

myajax = new isiAJAX('idmain', 'idcargador');

myajax = new isiAJAX(null, 'idcargador');
Ver ejemplo



Metodo Link()

Definicion: Carga la informacion de una URL en la capa/tabla identificada.

Parametros:
- URL: La url que queramos cargar.
- ID (Opcional): Sera el id del elemento donde queramos que se cargue la informacion. Si no se identifica ningun elemento solo enviara datos pero no recibira nada.
- Lugar (Opcional): Lugar donde sera cargada la informacion, si es 0 lo cargara encima de lo que ya tenga la capa/tabla identificada. Y si es 1 lo añadira a lo que ya tenga la capa/tabla.

NOTAS:
- No es prescindible añadir la almohadilla a los links. Simplemente se usa para los links de tipo: <a href="#link.php">...

Modo de uso:

myajax = new isiAJAX();
myajax.Link('link.php', 'micapa', 1);
Ver ejemplo




Metodo Form()

Definicion: Envia los datos de un formulario por POST o GET.

Parametros:
- ID: Sera el id del formulario que queramos enviar los datos.
- ID (Opcional): Sera el id del elemento donde queramos que se cargue la informacion. Si no se identifica ningun elemento solo enviara datos pero no recibira nada.
- Lugar (Opcional): Lugar donde sera cargada la informacion, si es 0 lo cargara encima de lo que ya tenga la capa/tabla identificada. Y si es 1 lo añadira a lo que ya tenga la capa/tabla.

Modo de uso:

myajax = new isiAJAX();
myajax.Form('miform', 'micapa');
Ver ejemplo




Metodo XML()

Definicion: Devuelve un array con los datos deseados de un fichero XML.

Parametros:
- URL: La url del xml que queramos leer.
- Funcion: Deberas poner el nombre de la funcion donde quieras recibir los datos.
- Sentencia: Sera la sentencia de busqueda que desemos. Esto es dificil de explicar, si deseas informacion sobre como hacer consultas a un xml mirate la informacion de isiXML.

NOTAS:
- Requiere estar incluida la libreria isiXML para usar este metodo.
- Si no tienes ganas de estudiarte todas las posibilidades de isiXML en principio con los ejemplos que pongamos te debe bastar.

Modo de uso:

myajax = new isiAJAX();
myajax.XML('xml.xml', miFuncion, 'SELECT node.value');
Ver ejemplo




Metodo Value()

Definicion: Carga el contenido descargado en un input o un textarea.

Parametros:
- URL: La url que queramos cargar.
- ID: Sera el id del elemento donde queramos que se cargue la informacion.
- Lugar (Opcional): Lugar donde sera cargada la informacion, si es 0 lo cargara encima de lo que ya tenga el elemento. Y si es 1 lo añadira a final. Si se deja en blanco este parametro machacara todo lo que tenga.

Modo de uso:

myajax = new isiAJAX();
myajax.Value('value.php?valor=mivalor', 'micapa', 0);
Ver ejemplo




Metodo Select()

Definicion: Actualiza una lista desplegable (SELECT) de formulario select.

Parametros:
- URL: La url que queramos cargar.
- ID: Sera el id del SELECT donde queramos que se cargue la informacion.

NOTAS:
- El archivo que genere los datos debe ir con la cabecera Content-Type: text/xml como en este ejemplo.
- Solo actualizara las etiquetas y los valores.
- Se debe imprimir como si de un select nuevo se tratara como vemos aqui.
- Requiere la libreria isiXML para poder usarlo.

Modo de uso:

myajax = new isiAJAX();
myajax.Select('select.php?opcion=b', 'micapa');
Ver ejemplo




Metodo Run()

Definicion: Ejecuta lo recibido como si fuese javascript.

Parametros:
- URL: La url que queramos cargar.

Modo de uso:

myajax = new isiAJAX();
myajax.Run('run.php');
Ver ejemplo




Metodo Img()

Definicion: Descarga una imagen nueva y la muestra en el ID que indiquemos.

Parametros:
- URL: La url que queramos cargar.
- ID: El id donde queramos que se cargue la foto.
- Ancho (Opcional) : El ancho de la foto.
- Alto (Opcional) : El alto de la foto.

Modo de uso:

myajax = new isiAJAX();
myajax.Img('mifoto.jpg', 'idfotos', 200, 100);
Ver ejemplo




Metodo Request()

Definicion: Hace todo lo de los demas metodos, especificado a nuestro gusto. Mas bien esta es una funcion para expertos, para aquellos que se les queden cortas las anteriores.

Parametros:
- url: La url que queramos cargar.
- method: El metodo de transferencia de datos, por GET o por POST. Por defecto sera GET.
- async: True o false, si es true tambien recibira datos cuando hagamos la peticion. Si es false enviara datos pero no recibira. Por defecto sera true.
- param: Parametos que se quieran enviar del tipo: valor1=a&valor2=hola&valor3=23
- headers : Cabeceras que queramos enviar, se enviaran con este formato: ['Content-Type','application/x-www-form-urlencoded','Otra cabecera', 'con este valor'].
- onOK : Se le pasara el nombre de la funcion donde queramos recoger los valores descargados, y ejecutara la funcion cuando los haya recibido correctamente.
- onError : Igual que la anterior pero actuara cuando se produzca un error al recibir los datos.
- onComplete : Como las dos anteriores, pero actuara cuando readyState tenga el valor 4.

Modo de uso:

myajax = new isiAJAX();
myajax.Request({
url: 'request.php',
param: 'valor=jaejae',
onOK: mifuncion

});

Ver ejemplo




Metodo Cancel()

Definicion: Cancela cualquier peticion que este en proceso.

Modo de uso:

myajax = new isiAJAX();
myajax.Cancel();
Ver ejemplo




Metodo DataForm()

Definicion: Retorna todo el contenido de un formulario y lo deja preparado para enviar. Con un formato como este: myinput=valor1&myselect=valor

Parametros:
- Elemento: Se le pasa el elemento del formulario.

Modo de uso:

myajax = new isiAJAX();
alert(myajax.DataForm($('miformulario')));
Ver ejemplo




Metodo Cargador()

Definicion: Oculta o muestra un elemento el cual nos puede servir para hacer de cargador.

Parametros:
- Activar/Desactivar: Se le pasa true o false. true para que se muestre y false para ocultarla. - ID (OPCIONAL): Id de la capa que se quiera tratar. Si no se pone nada por defecto actuara en la capa que hayamos definido al crear la clase.

Modo de uso:

myajax = new isiAJAX('idmain', 'idcargador');
myajax.Cargador(true);

myajax = new isiAJAX();
myajax.Cargador(true, 'miotrocargador');
Ver ejemplo




Variables Globales

Definicion: Tenemos la posibilidad de cambiar algunas opciones en el script cuando nos convenga.

  • myajax.debug: Por defecto es true. Si se pone en false (myajax.debug=false) no saltara un mensaje (alert) diciendo que la url no existe o que no ha podido ser cargada.
  • myajax.idloader: Por defecto es null. Pero si quisiesemos aplicar un cargador en mitad de la navegacion podriamos hacerlo de esta manera: myajax.idloader='id_de_la_capa'



Contacto

Source Forge

Visitas:

Ultima actualizacion: 09/08/2006