Module Apache mod_imagemap

Nouvelles fonctionnalit�s

Le module imagemap propose quelques nouvelles fonctionnalit�s qui n'�taient pas disponibles avec les programmes imagemap pr�c�demment distribu�s.

• R�f�rences d'URLs relatives � l'information contenue dans l'en-t�te Referer: .
• Assignement <base> par d�faut via la nouvelle directive base.
• Fichier imagemap.conf non requis.
• R�f�rences � des points.
• G�n�ration configurable de menus d'images interactives.

Fichier imagemap

Les lignes d'un fichier imagemap peuvent se pr�senter sous plusieurs formats :

Les directives sont base, default, poly, circle, rect, ou point. valeur est une URL absolue ou relative, ou une des valeurs sp�ciales �num�r�es ci-dessous. Les coordonn�es sont des paires x,y s�par�es par des espaces. Le texte entre guillemets est le texte du lien si un menu imagemap est g�n�r�. Les lignes commen�ant par '#' sont des commentaires.

Directives d'un fichier imagemap

Les directives autoris�es dans un fichier imagemap sont au nombre de six. Elles peuvent se trouver � n'importe quelle position dans le fichier, mais sont trait�es dans l'ordre selon lequel elles sont enregistr�es dans le fichier imagemap.

Directive base

Elle a le m�me effet que <base href="valeur">. Les URLs non absolues du fichier imagemap sont consid�r�es comme relatives � cette valeur. La directive base l'emporte sur une directive ImapBase d�finie dans un fichier .htaccess ou dans le fichier de configuration du serveur. En l'absence de directive de configuration ImapBase, la valeur par d�faut de base est http://nom_serveur/.

base_uri est un synonyme de base. Notez que la pr�sence ou l'absence d'un slash de fin dans l'URL est importante.

Directive default

La d�cision � prendre si les coordonn�es fournies ne correspondent � aucune des directives poly, circle, ou rect, et si aucune directive point n'est pr�sente. En l'absence de d�finition d'une directive de configuration ImapDefault, la valeur par d�faut est nocontent et provoque l'envoi d'un code de statut 204 No Content. Le client verra toujours la m�me page s'afficher.

Directive poly

Accepte comme arguments trois � cent points, et est actionn�e si les coordonn�es s�lectionn�es par l'utilisateur tombent dans le polygone d�fini par ces points.

Directive circle

Accepte comme arguments les coordonn�es du centre d'un cercle et celles d'un point de ce cercle. Elle est actionn�e si les coordonn�es s�lectionn�es par l'utilisateur tombent dans ce cercle.

Directive rect

Accepte comme arguments les coordonn�es des sommets de deux angles oppos�s d'un rectangle. Elle est actionn�e si les coordonn�es s�lectionn�es par l'utilisateur tombent dans ce rectangle.

Directive point

Elle n'accepte qu'un seul point comme argument. Si aucune autre directive ne correspond, c'est la directive dont le point sp�cifi� est le plus pr�s du point s�lectionn� par l'utilisateur qui est actionn�e. Notez que la directive default ne sera pas suivie si une directive point est pr�sente et si des coordonn�es valides sont fournies.

Valeurs

Les valeurs pass�es aux directives peuvent contenir :

une URL

L'URL peut �tre absolue ou relative. Les URLs relatives peuvent contenir '..' et seront consid�r�es comme relatives � la valeur de base.

base en lui-m�me, ne sera pas r�solu en fonction de la valeur courante. Cependant, une directive base mailto: fonctionnera correctement.

map

�quivalent � l'URL du fichier imagemap lui-m�me. Aucune coordonn�e n'est sp�cifi�e, et un menu sera donc g�n�r�, � moins qu'une directive ImapMenu n'ait �t� d�finie � none.

menu

�quivalent � map.

referer

�quivalent � l'URL du document r�f�rant. La valeur par d�faut est http://nom_serveur/ si aucun en-t�te Referer: n'est pr�sent.

nocontent

Envoie un code de statut 204 No Content, indiquant au client qu'il doit continuer � afficher la m�me page. Valide pour toutes les directives, sauf base.

error

Envoie un code de statut d'�chec 500 Server Error. Valide pour toutes les directives, sauf base, mais n'a de sens qu'avec la directive default.

Coordonn�es

0,0 200,200

Une coordonn�e se compose de deux valeurs, x et y, s�par�es par une virgule. Les coordonn�es sont s�par�es entre elles par des espaces. Pour s'adapter � la mani�re dont Lynx traite les images interactives, la s�lection par un utilisateur de la coordonn�e 0,0 a le m�me effet que si aucune coordonn�e n'a �t� s�lectionn�e.

Texte entre guillemets

"Texte du menu"

Apr�s la valeur ou les coordonn�es, la ligne peut �ventuellement contenir un texte entre guillemets. Cette cha�ne constitue le texte du lien si un menu est g�n�r� :

<a href="http://example.com/">Texte de menu</a>

Si aucun texte entre guillemets n'est pr�sent, le texte sera constitu� du nom du lien :

<a href="http://example.com/">http://example.com</a>

Si vous voulez ins�rer des guillemets dans le texte, vous devez les inscrire sous la forme ".

Exemple de fichier imagemap

R�f�rencement de votre fichier imagemap