Tutoriel Ajax – Création d’un diaporama

(‘Article rédigé par un groupe d’étudiants d’IUT dans le cadre d’un projet tutoré)

Dans cet article, je vais vous montrer comment réaliser un diaporama en Ajax. Pour cela je vais utiliser trois langages: le HTML, du JavaScript ainsi que du PHP.
Le code du diaporama est scindé en 3 fichier: galerie.html, galerie.js et galerie.php.
Le premier est la page web contenant la mise en page avec les différents évènements possibles tels que le clic sur la flèche précédente ou suivante.
Voici son code avec des explications:
—————————————

<!DOCTYPE html PUBLIC “-//W3C//DTD HTML 4.01 Transitional//EN”>
<html>
<head>
<meta content=”text/html; charset=ISO-8859-1″
http-equiv=”content-type”/>
<!– On inclut notre future fichier JavaScript –>
<script type=”text/javascript” src=”/ajax/galerie.js”></script>
<title>galerie</title>
</head>

<body style=”background-color: rgb(170, 0, 0);”>
<h1 style=”text-align: center;”>GALERIE D’ IMAGES</h1>
<hr />
<!– Voilà l’endroit où le résultat sera affiché, reconnu dans notre futur fichier JavaScript par son id. Pour le moment, on affiche rien. –>
<div style=”background:black; text-align: center” >
<br /><br />
<img id=”i_pred” src=”/ajax/pred.png” onClick=”javascript:galerie=pred()” style=”cursor:pointer”/>
———-
<img id=”i_suiv” src=”/ajax/suiv.png” onClick=”javascript:galerie=suiv();” style=”cursor:pointer”/>
<br />
<img id=”image” src=”/ajax/start.jpg”/>
<br /><br />
</div>
<hr />
<script type=”text/javascript” >galerie=suiv();</script>
</body>
</html>

—————————————

Ce sont les fonctions pred et suiv, appelées une fois qu’une flèche a été cliquée, qui modifieront l’image. A la fin du body, on appel la fonction suiv pour initialiser l’image.

Jetons un coup d’oeil dans le fichier JavaScript:

—————————————

/*
Fonction qui crée un objet XHR.
Cette fonction initialisera la valeur dans la variable globale “requete”
*/

var requete = null; /* On crée une variable qui contiendra l’objet XHR */
var galerie =-1;

function creerRequete() {
try {
requete = new XMLHttpRequest(); /* On essaye de créer un objet XmlHTTPRequest */
} catch (microsoft) {
/* Si cela ne marche pas, on a peut-être affaire à un navigateur de Microsoft. On tente alors de créer un objet ActiveX */
try {
requete = new ActiveXObject(‘Msxml2.XMLHTTP’);
} catch(autremicrosoft) {
/* Autre méthode si la première n’a pas marché */
try {
requete = new ActiveXObject(‘Microsoft.XMLHTTP’);
} catch(echec) {
/* Si aucune méthode ne fonctionne, on laisse l’objet vide*/
requete = null;
}
}
}
if(requete == null) {
alert(‘Votre navigateur ne semble pas supporter les object XMLHttpRequest.’);
}
}

function pred()
{
creerRequete();
galerie –;
var url = ‘galerie.php?image=’+galerie;
requete.open(‘GET’, url, true);
requete.onreadystatechange = function() {
if(requete.readyState == 4) {
if(requete.status == 200) {
if(requete.responseText!=””)
{
document.getElementById(‘image’).src=”/ajax/img/” + requete.responseText;
}
}
}
};
requete.send(null);
return galerie;
}

function suiv()
{
creerRequete();
galerie ++;
var url = ‘galerie.php?image=’+galerie;
requete.open(‘GET’, url, true);
requete.onreadystatechange = function() {
if(requete.readyState == 4) {
if(requete.status == 200) {
if(requete.responseText!=””)
{
document.getElementById(‘image’).src=”/ajax/img/” + requete.responseText;
}
}
}
};
requete.send(null);
return galerie;
}
—————————————

On initialise la variable galerie. Elle servira d’index.
Comme vous pouvez le voir, nos fonctions pred et suiv ont un code similaire.
Chacune effectue la création de l’objet XHR en appelant la fonction creerRequete.
Puis elles incrémentent ou décrémentent la variable relative à l’identifiant de l’image.
On construit ensuite l’URL, les arguments seront passés par la méthode GET.
On initialise la fonction de renvoi d’information.
On teste si on est au début du diaporama (galerie = 0) ou si on est a la fin (la requête retourne rien).
Si l’on est dans le cas optimal, on affiche la nouvelle image.
On retourne la variable galerie à la page HTML.
Pour comprendre la totalité du diaporama, il faut ensuite regarder le code qui sera exécuté sur le serveur : galerie.php

—————————————

<?php
/*
On vérifie que le paramètre GET est bien présent
*/
function isnotpoint($var)
{
return $var!=”.” && $var !=’..’;
}

if(isset($_GET[‘image’]))
{
$image = $_GET[‘image’];
$image = abs($image);
$tableau = scandir(‘./img/’);
$tableau = array_filter($tableau,”isnotpoint”);
$nbimage = count ($tableau);
$image = ($image%$nbimage)+2;

echo $tableau[$image];

}
else
echo “Erreur GET”;
?>

—————————————

L’algorithme de ce code est le suivant:
On vérifie que le paramètre image est présent. On prend la valeur absolue de notre paramètre, ceci est utile lorsque l’index est inférieur à zéro. Si c’est le cas on utilise la fonction scandir et on stocke le résultat dans la variable tableau. La fonction scandir est très utile dans ce cas, en effet elle va retourner chacun des fichiers du dossier mais aussi un “.” et “..”, c’est pour cela que l’on utilise la fonction array_filter qui va les enlever du tableau. La fonction count permet de retourner le nombre d’éléments du tableau. On effectue un modulo de l’index avec ce nombre, et on ajoute 2. En effet, la fonction array_filter ne créer pas un nouveau tableau, mais efface juste les éléments correspondant à la recherche, C’est pour cela qu’il faut penser que les deux premiers éléments du tableau sont vides et ajouter 2. On retourne par la suite l’élément voulu.

Voilà, ce tutorial est terminé, vous pouvez à présent créer un diaporama utilisant Ajax pour votre site web.

 

Tutoriel Ajax – Infobulle

(Article rédigé par un groupe d’étudiant d’IUT dans le cadre d’un projet tutoré)

Voici un tutorial qui permet lorsque l’utilisateur passe la souris au dessus d’un mot définie a préalable, d’afficher dans une bulle un texte, une image ou ce que l’on veut.

On peut ainsi utiliser ce principe pour donner la signification de certains mots, ou même pour un lien afficher dans la bulle la première phrase de la page cible du lien.
Dans cet exemple les mots et leur significations ce trouvent dans le fichier xml.

Voici le fichier html :

<html>

<head>

<link rel=”stylesheet” type=”text/css” href=”/ajax/bulle.css” media=”all” />

<script type=”text/javascript” src=”/ajax/bulles.js”></script>

</head>

<body>

<div id=”curseur”></div>

Mot :<br />

Connaissez vous l'<span onmouseover=”javascript:affbulle(this)” onmouseout=”javascript:cache()”>ajax</span> ?<br />

C’est un concept <span onmouseover=”javascript:affbulle(this)” onmouseout=”javascript:cache()”>informatique</span> !<br />

Retour à la ligne

</body>

</html>

Explication : On peut remarquer les balises <span>, ce sont elles qui vont nous servir pour récupérer le mot associé à la définition ;

Deux fonctions JavaScript vont être appelés :

-affbulle va servir pour charger la définition du mot et afficher la bulle lorsque le mot est survolé.

-cache va comme son nom l’indique masquer la bulle lorsque la souris ne se trouve plus sur le mot concerné.

On peut se demander a quoi va servir la balise <div>, c’est tout simplement la déclaration de la bulle.

 

Voici le fichier css associé :

.infobulle{

position: absolute;

visibility : hidden;

border: 1px solid Black;

padding: 10px;

font-family: Verdana, Arial;

font-size: 10px;

background-color: #FFFFCC;

}

 

.lienbulle{

color: #0000ff;

cursor: help;

text-decoration: underline;

}

 

Rien de particulier, infobulle concerne la bulle et lienbulle concerne le mot en question.

 

Voici maintenant le fichier xml :

 

<?xml version=”1.0″ ?>

<root>

<ajax>Texte correspondant a l’Ajax</ajax>

<informatique>Texte correspondant a l’informatique</informatique>

</root>

 

Il suffit de créer la balise <nom> (nom étant le mot qui va être décrit), puis entre cette balise ouvrante et la balise fermante, on placera la description qui apparaîtra dans la bulle

 

Attaquons nous maintenant au fichier JavaScript :

 

/*

Fonction qui crée un objet XHR.

Cette fonction initialisera la valeur dans la variable globale “requete”

*/

 

var requete = null; /* On crée une variable qui contiendra l’objet XHR */

 

function creerRequete() {

try {

requete = new XMLHttpRequest(); /* On essaye de créer un objet XmlHTTPRequest */

} catch (microsoft) {

/* Si cela ne marche pas, on a peut-être affaire à un navigateur de Microsoft. On tente alors de créer un objet ActiveX */

try {

requete = new ActiveXObject(‘Msxml2.XMLHTTP’);

} catch(autremicrosoft) {

/* Autre méthode si la première n’a pas marché */

try {

requete = new ActiveXObject(‘Microsoft.XMLHTTP’);

} catch(echec) {

/* Si aucune méthode ne fonctionne, on laisse l’objet vide*/

requete = null;

}

}

}

if(requete == null) {

alert(‘Votre navigateur ne semble pas supporter les objets XMLHttpRequest.’);

}

}

 

Pour l’instant, nous avons le même code que pour l’implémentation.

 

function GetId(id)

{

return document.getElementById(id);

}

var i=false; // La variable i nous dit si la bulle est visible ou non

 

function move(e) {

if(i) { // Si la bulle est visible, on calcul en temps reel sa position idéal

if (navigator.appName!=”Microsoft Internet Explorer”) { // Si on est pas sous IE

GetId(“curseur”).style.left=e.pageX + 5+”px”;

GetId(“curseur”).style.top=e.pageY + 10+”px”;

}

else {

if(document.documentElement.clientWidth>0) {

GetId(“curseur”).style.left=20+event.x+document.documentElement.scrollLeft+”px”;

GetId(“curseur”).style.top=10+event.y+document.documentElement.scrollTop+”px”;

} else {

GetId(“curseur”).style.left=20+event.x+document.body.scrollLeft+”px”;

GetId(“curseur”).style.top=10+event.y+document.body.scrollTop+”px”;

}

}

}

}

 

La fonction qui précède ce charge de la position de la bulle par rapport au curseur

 

function montre() {

if(i==false) {

GetId(“curseur”).style.visibility=”visible”; // Si elle est cachée (la verification n’est qu’une sécurité) on la rend visible.

i=true;

}

}

 

La fonction montre() va simplement rendre visible la bulle.

 

function cache() {

if(i==true) {

GetId(“curseur”).style.visibility=”hidden”; // Si la bulle est visible on la cache

i=false;

}

}

 

A l’inverse cache() va masquer la bulle.

 

function affbulle(src) {

/* On crée notre super objet XHR global */

creerRequete();

 

/* On édite les propriété de l’objet : type de paramètre, url (avec paramètres) et une option autorisant une réponse du serveur */

requete.open(‘GET’, ‘test.xml’, true);

 

/* On initialise la fonction de renvoi d’information */

requete.onreadystatechange = function() {

if(requete.readyState == 4) {

if(requete.status == 200) {

 

/* On récupère le contenu de notre fichier */

var xml = requete.responseXML;

document.getElementById(‘curseur’).innerHTML = xml.getElementsByTagName(src.innerHTML).item(0).firstChild.data;//c’est ici que l’on charge la définition du mot

 

}

}

}

/* C’est partit ! On envoi la requête XHR au serveur */

requete.send(null);

montre();

}

document.onmousemove=move; // dés que la souris bouge, on appelle la fonction move pour mettre à jour la position de la bulle.

 

Cette fonction va donc accéder au fichier xml et charger la définition du mot et la retourner au ‘curseur’ pour qu’il affiche le tout dans la bulle.

Le ‘src.innerHTML’ correspond au mot qui se trouve dans le fichier html entre les balises span, ce mot doit être identique a la balise du fichier xml contenant la définition, il servira par conséquent d’identifiant.