©
Ce document utiliseManuel du site Web PHP chinoisLibérer
| 说明 | 处理服务器端图像映射 |
|---|---|
| 状态 | 基本(B) |
| 模块名 | imagemap_module |
| 源文件 | mod_imagemap.c |
This module processes.mapfiles, thereby replacing the functionality of theimagemapCGI program. Any directory or document type configured to use the handlerimap-file(using eitherAddHandler或SetHandler) will be processed by this module.
The following directive will activate files ending with.mapas imagemap files:
AddHandler imap-file map
Note that the following is still supported:
AddType application/x-httpd-imap map
However, we are trying to phase out "magic MIME types" so we are deprecating this method.
The imagemap module adds some new features that were not possible with previously distributed imagemap programs.
base.imagemap.conffile.The lines in the imagemap files can have one of several formats:
directive value [x,y...]
directive value "Menu text" [x,y...]
directive valuex,y... "Menu text"
The directive is one ofbase,default,poly,circle,rect, orpoint. The value is an absolute or relative URL, or one of the special values listed below. The coordinates arex,ypairs separated by whitespace. The quoted text is used as the text of the link if a imagemap menu is generated. Lines beginning with '#' are comments.
There are six directives allowed in the imagemap file. The directives can come in any order, but are processed in the order they are found in the imagemap file.
baseDirective
Has the effect ofbasedirective overridesImapBaseas set in a.htaccessfile or in the server configuration files. In the absence of anImapBaseconfiguration directive,basedefaults tohttp://server_name/.
base_uriis synonymous withbase. Note that a trailing slash on the URL is significant.
defaultDirective
poly,
circle或
rectdirectives, and there are no
pointdirectives. Defaults to
nocontentin the absence of an
ImapDefaultconfiguration setting, causing a status code of
204 No Contentto be returned. The client should keep the same page displayed.
polyDirective
circle
rectDirective
pointDirective
defaultwill not be followed if a
pointdirective is present and valid coordinates are given.
The values for each of the directives can any of the following:
The URL can be relative or absolute URL. Relative URLs can contain '..' syntax and will be resolved relative to thebasevalue.
baseitself will not resolved according to the current value. A statementbase mailto:will work properly, though.
map
ImapMenuis set to
none.
menu
map.
referer
http://servername/if no
Referer:header was present.
nocontent
204 No Content, telling the client to keep the same page displayed. Valid for all but
base.
error
500 Server Error. Valid for all but
base, but sort of silly for anything but
default.
0,0 200,200
0,0, it is as if no coordinate had been selected.
"Menu Text"
After the value or after the coordinates, the line optionally may contain text within double quotes. This string is used as the text for the link if a menu is generated:
If no quoted text is present, the name of the link will be used as the text:
If you want to use double quotes within this text, you have to write them as".
#Comments are printed in a 'formatted' or 'semiformatted' menu.
#And can contain html tags.
base referer
poly map "Could I have a menu, please?" 0,0 0,10 10,10 10,0
rect .. 0,0 77,27 "the directory of the referer"
circle http://www.inetnebr.com/lincoln/feedback/ 195,0 305,27
rect another_file "in same directory as referer" 306,0 419,27
point http://www.zyzzyva.com/ 100,100
point http://www.tripod.com/ 200,200
rect mailto:nate@tripod.com 100,150 200,0 "Bugs?"
| 说明 | Defaultbasefor imagemap files |
|---|---|
| 语法 | ImapBase map|referer|URL |
| 默认值 | ImapBase http://servername/ |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆盖项 | Indexes |
| 状态 | 基本(B) |
| 模块 | mod_imagemap |
ImapBasedirective sets the defaultbaseused in the imagemap files. Its value is overridden by abasedirective within the imagemap file. If not present, thebasedefaults tohttp://servername/.
UseCanonicalName| 说明 | Default action when an imagemap is called with coordinates that are not explicitly mapped |
|---|---|
| 语法 | ImapDefault error|nocontent|map|referer|URL |
| 默认值 | ImapDefault nocontent |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆盖项 | Indexes |
| 状态 | 基本(B) |
| 模块 | mod_imagemap |
ImapDefaultdirective sets the defaultdefaultused in the imagemap files. Its value is overridden by adefaultdirective within the imagemap file. If not present, thedefaultaction isnocontent, which means that a204 No Contentis sent to the client. In this case, the client should continue to display the original page.
| 说明 | Action if no coordinates are given when calling an imagemap |
|---|---|
| 语法 | ImapMenu none|formatted|semiformatted|unformatted |
| 作用域 | server config, virtual host, directory, .htaccess |
| 覆盖项 | Indexes |
| 状态 | 基本(B) |
| 模块 | mod_imagemap |
ImapMenudirective determines the action taken if an imagemap file is called without valid coordinates.
none
none, no menu is generated, and the
defaultaction is performed.
formatted
formattedmenu is the simplest menu. Comments in the imagemap file are ignored. A level one header is printed, then an hrule, then the links each on a separate line. The menu has a consistent, plain look close to that of a directory listing.
semiformatted
semiformattedmenu, comments are printed where they occur in the imagemap file. Blank lines are turned into HTML breaks. No header or hrule is printed, but otherwise the menu is the same as a
formattedmenu.
unformatted