<-
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.