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és Fichier imagemap Exemple de fichier imagemap Ré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
https://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.refererhttps://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="https://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="https://example.com/">https://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 https://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 https://www.zyzzyva.example.com/ 100,100
point https://www.tripod.example.com/ 200,200
rect mailto:nate@tripod.example.com 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 https://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
https://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