<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_imagemap - Serveur Apache HTTP Version 2.4</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.min.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.4</p>
<img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_imagemap</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_imagemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_imagemap.html" title="Français"> fr </a> |
<a href="../ko/mod/mod_imagemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Traitement des cartes des zones interactives d'une image
(imagemaps) au niveau du serveur</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>imagemap_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_imagemap.c</td></tr></table>
<h3>Sommaire</h3>
<p>Ce module traite les fichiers <code>.map</code>, et remplace
ainsi la fonctionnalité du programme CGI <code>imagemap</code>. Tout
répertoire ou type de document configuré pour utiliser le
gestionnaire <code>imap-file</code> (à l'aide des directives
<code class="directive"><a href="../mod/mod_mime.html#addhandler">AddHandler</a></code> ou <code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code>), sera traité par ce
module.</p>
<p>La directive suivante confère aux fichiers possèdant l'extension
<code>.map</code> le statut de fichiers imagemap :</p>
<pre class="prettyprint lang-config">AddHandler imap-file map</pre>
<p>Notez que la syntaxe suivante reste encore supportée :</p>
<pre class="prettyprint lang-config">AddType application/x-httpd-imap map</pre>
<p>Cependant, nous essayons d'abandonner progressivement les "types
MIME magiques", et cette syntaxe est sur le point de devenir
obsolète.</p>
</div>
<div id="quickview"><h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif" /> <a href="#features">Nouvelles fonctionnalités</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#imapfile">Fichier imagemap</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#example">Exemple de fichier imagemap</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#referencing">Référencement de votre fichier
imagemap</a></li>
</ul><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#imapbase">ImapBase</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#imapdefault">ImapDefault</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#imapmenu">ImapMenu</a></li>
</ul>
<ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="features" id="features">Nouvelles fonctionnalités</a></h2>
<p>Le module imagemap propose quelques nouvelles fonctionnalités qui
n'étaient pas disponibles avec les programmes imagemap précédemment
distribués.</p>
<ul>
<li>Références d'URLs relatives à l'information contenue dans
l'en-tête Referer: .</li>
<li>Assignement <code><base></code> par défaut via la
nouvelle directive <code>base</code>.</li>
<li>Fichier <code>imagemap.conf</code> non requis.</li>
<li>Références à des points.</li>
<li>Génération configurable de menus d'images interactives.</li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="imapfile" id="imapfile">Fichier imagemap</a></h2>
<p>Les lignes d'un fichier imagemap peuvent se présenter sous
plusieurs formats :</p>
<div class="example"><p><code>
directive valeur [<var>x</var>,<var>y</var> ...]<br />
directive valeur "<var>Texte de menu</var>" [<var>x</var>,<var>y</var>
...]<br />
directive valeur <var>x</var>,<var>y</var> ... "<var>Texte de menu</var>"
</code></p></div>
<p>Les directives sont <code>base</code>, <code>default</code>,
<code>poly</code>, <code>circle</code>, <code>rect</code>, ou
<code>point</code>. valeur est une URL absolue ou relative, ou une
des valeurs spéciales énumérées ci-dessous. Les coordonnées sont des
paires <code><var>x</var>,<var>y</var></code> 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.</p>
<h3><a name="imapfile.directives" id="imapfile.directives">Directives d'un fichier
imagemap</a></h3>
<p>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.</p>
<dl>
<dt>Directive <code>base</code></dt>
<dd><p>Elle a le même effet que <code><base
href="<var>valeur</var>"></code>. Les URLs non absolues du
fichier imagemap sont considérées comme relatives à cette valeur.
La directive <code>base</code> l'emporte sur une directive
<code class="directive"><a href="#imapbase">ImapBase</a></code> définie dans
un fichier <code>.htaccess</code> ou dans le fichier de
configuration du serveur. En l'absence de directive de
configuration <code class="directive">ImapBase</code>, la valeur par
défaut de <code>base</code> est
<code>http://nom_serveur/</code>.</p>
<p><code>base_uri</code> est un synonyme de <code>base</code>.
Notez que la présence ou l'absence d'un slash de fin dans l'URL
est importante.</p></dd>
<dt>Directive <code>default</code></dt>
<dd>La décision à prendre si les coordonnées fournies ne
correspondent à aucune des directives <code>poly</code>,
<code>circle</code>, ou <code>rect</code>, et si aucune directive
<code>point</code> n'est présente. En l'absence de définition
d'une directive de configuration <code class="directive"><a href="#imapdefault">ImapDefault</a></code>, la valeur par défaut est
<code>nocontent</code> et provoque l'envoi d'un code de statut
<code>204 No Content</code>. Le client verra toujours la même
page s'afficher.</dd>
<dt>Directive <code>poly</code></dt>
<dd>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.</dd>
<dt>Directive <code>circle</code></dt>
<dd>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.</dd>
<dt>Directive <code>rect</code></dt>
<dd>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.</dd>
<dt>Directive <code>point</code></dt>
<dd>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
<code>default</code> ne sera pas suivie si une directive
<code>point</code> est présente et si des coordonnées valides sont
fournies.</dd>
</dl>
<h3><a name="imapfile.values" id="imapfile.values">Valeurs</a></h3>
<p>Les valeurs passées aux directives peuvent contenir :</p>
<dl>
<dt>une URL</dt>
<dd><p>L'URL peut être absolue ou relative. Les URLs relatives
peuvent contenir '..' et seront considérées comme relatives à la
valeur de <code>base</code>.</p>
<p><code>base</code> en lui-même, ne sera pas résolu en fonction
de la valeur courante. Cependant, une directive <code>base
mailto:</code> fonctionnera correctement.</p></dd>
<dt><code>map</code></dt>
<dd>É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 <code class="directive"><a href="#imapmenu">ImapMenu</a></code> n'ait été définie à
<code>none</code>.</dd>
<dt><code>menu</code></dt>
<dd>Équivalent à <code>map</code>.</dd>
<dt><code>referer</code></dt>
<dd>Équivalent à l'URL du document référant. La valeur par défaut
est <code>http://nom_serveur/</code> si aucun en-tête
<code>Referer:</code> n'est présent.</dd>
<dt><code>nocontent</code></dt>
<dd>Envoie un code de statut <code>204 No Content</code>,
indiquant au client qu'il doit continuer à afficher la même page.
Valide pour toutes les directives, sauf <code>base</code>.</dd>
<dt><code>error</code></dt>
<dd>Envoie un code de statut d'échec <code>500 Server
Error</code>. Valide pour toutes les directives, sauf
<code>base</code>, mais n'a de sens qu'avec la directive
<code>default</code>.</dd>
</dl>
<h3><a name="imapfile.coords" id="imapfile.coords">Coordonnées</a></h3>
<dl>
<dt><code>0,0 200,200</code></dt>
<dd>Une coordonnée se compose de deux valeurs, <var>x</var> et
<var>y</var>, 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 <code>0,0</code> a le même effet que
si aucune coordonnée n'a été sélectionnée.</dd>
</dl>
<h3><a name="imapfile.quotedtext" id="imapfile.quotedtext">Texte entre
guillemets</a></h3>
<dl>
<dt><code>"<var>Texte du menu</var>"</code></dt>
<dd><p>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é :</p>
<div class="example"><p><code>
<a href="http://example.com/"><var>Texte de
menu</var></a>
</code></p></div>
<p>Si aucun texte entre guillemets n'est présent, le texte sera
constitué du nom du lien :</p>
<div class="example"><p><code>
<a href="http://example.com/">http://example.com</a>
</code></p></div>
<p>Si vous voulez insérer des guillemets dans le texte, vous devez
les inscrire sous la forme <code>&quot;</code>.</p></dd>
</dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="example" id="example">Exemple de fichier imagemap</a></h2>
<div class="example"><p><code>
#Les commentaires sont affichés dans un menu 'formaté' ou
#'semi-formaté'.<br />
#Et peuvent contenir des balises html. <hr><br />
base referer<br />
poly map "Puis-je avoir un menu, s'il vous plait ?" 0,0 0,10 10,10 10,0<br />
rect .. 0,0 77,27 "le répertoire du référant"<br />
circle http://www.inetnebr.example.com/lincoln/feedback/ 195,0 305,27<br />
rect autre_fichier "dans le même répertoire que le référant" 306,0 419,27<br />
point http://www.zyzzyva.example.com/ 100,100<br />
point http://www.tripod.example.com/ 200,200<br />
rect mailto:nate@tripod.example.com 100,150 200,0 "Bogues?"<br />
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="referencing" id="referencing">Référencement de votre fichier
imagemap</a></h2>
<div class="example"><h3>Exemple HTML</h3><p><code>
<a href="/maps/imagemap1.map"><br />
<span class="indent">
<img ismap src="/images/imagemap1.gif"><br />
</span>
</a>
</code></p></div>
<div class="example"><h3>Exemple XHTML</h3><p><code>
<a href="/maps/imagemap1.map"><br />
<span class="indent">
<img ismap="ismap" src="/images/imagemap1.gif" /><br />
</span>
</a>
</code></p></div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="imapbase" id="imapbase">Directive</a> <a name="ImapBase" id="ImapBase">ImapBase</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Valeur par défaut de la directive <code>base</code> des
fichiers imagemap</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ImapBase map|referer|<var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ImapBase http://nom_serveur/</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_imagemap</td></tr>
</table>
<p>La directive <code class="directive">ImapBase</code> permet de définir la
valeur par défaut de la directive <code>base</code> des fichiers
imagemap. Sa valeur est écrasée par la présence éventuelle d'une
directive <code>base</code> dans le fichier imagemap. Si cette
directive est absente, la valeur par défaut de la directive
<code>base</code> est
<code>http://<var>nom_serveur</var>/</code>.</p>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="imapdefault" id="imapdefault">Directive</a> <a name="ImapDefault" id="ImapDefault">ImapDefault</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action à entreprendre par défaut lorsqu'un fichier imagemap
est invoqué avec des coordonnées qui ne correspondent à aucune
cible</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ImapDefault error|nocontent|map|referer|<var>URL</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ImapDefault nocontent</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_imagemap</td></tr>
</table>
<p>La directive <code class="directive">ImapDefault</code> permet de définir
la valeur par défaut de la directive <code>default</code> utilisée
dans les fichiers imagemap. Sa valeur est écrasée par la présence
éventuelle d'une directive <code>default</code> dans le fichier
imagemap. Si cette directive est absente, l'action associée à
<code>default</code> est <code>nocontent</code>, ce qui implique
l'envoi d'un code de statut <code>204 No Content</code> au client.
Dans ce cas, le client doit continuer à afficher la même page.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="imapmenu" id="imapmenu">Directive</a> <a name="ImapMenu" id="ImapMenu">ImapMenu</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Action à entreprendre si aucune coordonnée n'est fournie
lorsqu'on invoque un fichier imagemap</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ImapMenu none|formatted|semiformatted|unformatted</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>ImapMenu formatted</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_imagemap</td></tr>
</table>
<p>La directive <code class="directive">ImapMenu</code> permet de spécifier
l'action à entreprendre lorsqu'un fichier imagemap est invoqué sans
coordonnées valides.</p>
<dl>
<dt><code>none</code></dt>
<dd>Si l'argument d'ImapMenu est <code>none</code>, aucun menu
n'est généré, et l'action <code>default</code> est effectuée.</dd>
<dt><code>formatted</code></dt>
<dd>Le menu <code>formatted</code> 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.</dd>
<dt><code>semiformatted</code></dt>
<dd>Dans le menu <code>semiformatted</code>, 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 <code>semiformatted</code> est identique
au menu <code>formatted</code>.</dd>
<dt><code>unformatted</code></dt>
<dd>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.</dd>
</dl>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_imagemap.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_imagemap.html" title="Français"> fr </a> |
<a href="../ko/mod/mod_imagemap.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />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 <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mod_imagemap.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2015 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>
