Serveur Apache HTTP Version 2.4
Serveur Apache HTTP Version 2.4
| 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 |
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.
Nouvelles fonctionnalitésFichier imagemapExemple de fichier imagemapRéférencement de votre fichier imagemap
Le module imagemap propose quelques nouvelles fonctionnalités qui n'étaient pas disponibles avec les programmes imagemap précédemment distribués.
<base> par défaut via la nouvelle directive base.imagemap.conf non requis.
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.
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.
baseElle 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.
defaultpoly, 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.polycirclerectpointdefault ne sera pas suivie si une directive point est présente et si des coordonnées valides sont fournies.Les valeurs passées aux directives peuvent contenir :
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.
mapImapMenu n'ait été définie à none.menumap.refererhttp://nom_serveur/ si aucun en-tête Referer: n'est présent.nocontent204 No Content, indiquant au client qu'il doit continuer à afficher la même page. Valide pour toutes les directives, sauf base.error500 Server Error. Valide pour toutes les directives, sauf base, mais n'a de sens qu'avec la directive default.0,0 200,2000,0 a le même effet que si aucune coordonnée n'a été sélectionnée."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 ".
#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?"
<a href="/maps/imagemap1.map">
<img ismap src="/images/imagemap1.gif">
</a>
<a href="/maps/imagemap1.map">
<img ismap="ismap" src="/images/imagemap1.gif" />
</a>
| 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/.
| 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.
| 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.
nonenone, aucun menu n'est généré, et l'action default est effectuée.formattedformatted 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.semiformattedsemiformatted, 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