<-
Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_imagemap

Langues Disponibles:  en  |  fr  |  ko 

Description:Traitement des cartes des zones interactives d'une image (imagemaps) au niveau du serveur
Statut:Base
Identificateur�de�Module:imagemap_module
Fichier�Source:mod_imagemap.c

Sommaire

Ce module traite les fichiers .map, et remplace ainsi la fonctionnalit� du programme CGI imagemap. Tout r�pertoire ou type de document configur� pour utiliser le gestionnaire imap-file (� l'aide des directives AddHandler ou SetHandler), sera trait� par ce module.

La directive suivante conf�re aux fichiers poss�dant l'extension .map le statut de fichiers imagemap :

AddHandler imap-file map

Notez que la syntaxe suivante reste encore support�e :

AddType application/x-httpd-imap map

Cependant, nous essayons d'abandonner progressivement les "types MIME magiques", et cette syntaxe est sur le point de devenir obsol�te.

Directives

Sujets

top

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.

top

Fichier imagemap

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

directive valeur [x,y ...]
directive valeur "Texte de menu" [x,y ...]
directive valeur x,y ... "Texte de menu"

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 &quot;.

top

Exemple de fichier imagemap

#Les commentaires sont affich�s dans un menu 'format�' ou #'semi-format�'.
#Et peuvent contenir des balises html. <hr>
base referer
poly map "Puis-je avoir un menu, s'il vous plait ?" 0,0 0,10 10,10 10,0
rect .. 0,0 77,27 "le r�pertoire du r�f�rant"
circle http://www.inetnebr.example.com/lincoln/feedback/ 195,0 305,27
rect autre_fichier "dans le m�me r�pertoire que le r�f�rant" 306,0 419,27
point http://www.zyzzyva.example.com/ 100,100
point http://www.tripod.example.com/ 200,200
rect mailto:[email protected] 100,150 200,0 "Bogues?"

top

R�f�rencement de votre fichier imagemap

Exemple HTML

<a href="/maps/imagemap1.map">
<img ismap src="/images/imagemap1.gif">
</a>

Exemple XHTML

<a href="/maps/imagemap1.map">
<img ismap="ismap" src="/images/imagemap1.gif" />
</a>

top

ImapBase Directive

Description:Valeur par d�faut de la directive base des fichiers imagemap
Syntaxe:ImapBase map|referer|URL
D�faut:ImapBase http://nom_serveur/
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_imagemap

La directive ImapBase permet de d�finir la valeur par d�faut de la directive base des fichiers imagemap. Sa valeur est �cras�e par la pr�sence �ventuelle d'une directive base dans le fichier imagemap. Si cette directive est absente, la valeur par d�faut de la directive base est http://nom_serveur/.

Voir aussi

top

ImapDefault Directive

Description:Action � entreprendre par d�faut lorsqu'un fichier imagemap est invoqu� avec des coordonn�es qui ne correspondent � aucune cible
Syntaxe:ImapDefault error|nocontent|map|referer|URL
D�faut:ImapDefault nocontent
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_imagemap

La directive ImapDefault permet de d�finir la valeur par d�faut de la directive default utilis�e dans les fichiers imagemap. Sa valeur est �cras�e par la pr�sence �ventuelle d'une directive default dans le fichier imagemap. Si cette directive est absente, l'action associ�e � default est nocontent, ce qui implique l'envoi d'un code de statut 204 No Content au client. Dans ce cas, le client doit continuer � afficher la m�me page.

top

ImapMenu Directive

Description:Action � entreprendre si aucune coordonn�e n'est fournie lorsqu'on invoque un fichier imagemap
Syntaxe:ImapMenu none|formatted|semiformatted|unformatted
D�faut:ImapMenu formatted
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_imagemap

La directive ImapMenu permet de sp�cifier l'action � entreprendre lorsqu'un fichier imagemap est invoqu� sans coordonn�es valides.

none
Si l'argument d'ImapMenu est none, aucun menu n'est g�n�r�, et l'action default est effectu�e.
formatted
Le menu formatted est le menu le plus simple. Les commentaires du fichier imagemap sont ignor�s. Un en-t�te de niveau un est affich�, puis un s�parateur horizontal, puis chacun des liens sur une ligne s�par�e. L'aspect du menu est similaire � celui d'un listing de r�pertoire.
semiformatted
Dans le menu semiformatted, les commentaires sont affich�s au moment o� ils apparaissent dans le fichier imagemap. Les lignes vides sont interpr�t�es comme des lignes de s�paration HTML. Aucun en-t�te ni s�parateur horizontal n'est affich�. � part ces diff�rences, le menu semiformatted est identique au menu formatted.
unformatted
Les commentaires sont affich�s et les lignes vides sont ignor�es. N'est affich� que ce qui apparait dans le fichier imagemap. Toutes les lignes de s�paration HTML et les en-t�tes doivent �tre inclus en tant que commentaires dans le fichier imagemap. Cela vous procure une grande souplesse pour d�finir l'apparence de vos menus, mais vous oblige � r�diger vos fichiers imagemap en HTML, et non en texte plat.

Langues Disponibles:  en  |  fr  |  ko 

top

Commentaires

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.