Apache 模組 mod_imagemap

可用的語言： en | fr | ko

說明	伺服端影像地圖處理
狀態	基礎
模組識別元	imagemap_module
原始檔	mod_imagemap.c

摘要

這個模組會處理 .map 檔案，因此取代了 imagemap CGI 程式功能。任何一個已設定使用處理常式 imap-file 的目錄或文件類型（使用 AddHandler 或 SetHandler）都會由這個模組處理。

下列指令會啟用以 .map 結尾的檔案作為影像地圖檔案

AddHandler imap-file map

請注意，以下內容仍然受支援

AddType application/x-httpd-imap map

然而，我們正嘗試逐步淘汰「神奇的 MIME 型別」，因此我們不建議再使用此方法。

主題

新功能
影像地圖檔案
範例地圖檔
參照您的地圖檔

錯誤修正檢查清單

請參閱

留言

新功能

影像地圖模組新增了一些先前發行的影像地圖程式所沒有的新功能。

根據 Referer: 資訊建立的相對 URL 參照。
透過新的地圖指令 base 預設指定 <base>。
無需 imagemap.conf 檔案。
點參照。
可設定影像地圖選單產生方式。

影像地圖檔案

影像地圖檔案中的行可能有下列幾種格式

指令值 [x,y ...] 指令值 "選單文字" [x,y ...] 指令值 x,y ... "選單文字"

指令可以為base、default、poly、circle、rect或point之一。值可以是絕對或相對 URL，或下列特殊值之一。這些座標是空白分隔的x,y配對。如果產生圖像地圖清單時，引號內文字便是連結的文字。井號開頭的行是註解。

圖像地圖檔案指令

圖像地圖檔案中允許六種指令。指令可以按任何順序出現，但會依圖像地圖檔案中出現的順序處理。

指令base

效果為<base href="value">。地圖檔案的非絕對 URL 會相對於此值而定。base指令會覆寫 .htaccess 檔案或伺服器設定檔中設定的ImapBase。在缺乏ImapBase設定指令的情況下，base會預設為http://server_name/。

base_uri與base同義。請注意 URL 中尾隨斜線很重要。

指令default

若提供的座標不符合任何poly、circle或rect指令，而且沒有point指令時執行這個動作。在沒有設定ImapDefault設定的情況下，會預設為nocontent，導致傳回狀態碼 204 No Content。用戶端應保持顯示相同的頁面。

指令poly

包含三到一百個點，且若使用者選取的座標在這些點所定義的多邊形內，便會予以遵從。

circle

取得圓的中心座標和圓上的點。若使用者選取的點位於圓內，便會予以遵從。

指令rect

取得矩形兩個相對角落的座標。若選取的點位於此矩形內，便會予以遵從。

指令point

取得單點。若沒有其他指令符合條件，則距離使用者選取點最近的點指令便會予以遵從。請注意，在有point指令而且有提供有效座標時，不會遵從default。

值

每個指令的值可以是下列任何一項

URL

URL 可以是相對或絕對 URL。相對 URL 可以包含'..'語法，而且會相對於base值解析。

base本身不會根據目前的解析。不過，陳述base mailto:會正常運作。

地圖

等同於 imagemap 檔本身的 URL。這樣不會傳送任何坐標，所以會產生一個功能表，除非 ImapMenu 已設為 none。

menu

與 map 同義。

referer

等同於參照文件的 URL。如果沒有 Referer: 標頭，預設為 http://servername/。

nocontent

傳送狀態碼 204 No Content，告訴客戶端保持顯示相同頁面。所有項目都適用，但 base 除外。

error

以 500 Server Error 失敗。所有項目都適用，但 base 除外，但對除 default 以外的任何項目而言，這有點蠢。

坐標

0,0 200,200: 坐標由 x 和 y 值組成，它們以逗號分隔。坐標由空白分隔。為了配合 Lynx 處理 imagemaps 的方式，如果使用者選擇 sit 標 0,0，就等於沒有選取任何坐標。

引用文字

"功能表文字"

在值或坐標之後，行可能會包含在雙引號內的文字。如果產生一個功能表，此字串會用做連結的文字

<a href="http://example.com/">功能表文字</a>

如果沒有引文文字，連結名稱會用做文字

<a href="http://example.com/">http://example.com</a>

如果你要在這段文字中使用雙引號，你必須將其寫成 "。

# 註解會以 '格式化' 或 '半格式化' 功能表印出。 # 而且可以包含 html 標籤。<hr> base referer poly map "是否可以給我一個功能表？" 0,0 0,10 10,10 10,0 rect .. 0,0 77,27 "參照文件的目錄" circle http://www.inetnebr.example.com/lincoln/feedback/ 195,0 305,27 rect another_file "與參照文件在同目錄中" 306,0 419,27 point http://www.zyzzyva.example.com/ 100,100 point http://www.tripod.example.com/ 200,200 rect mailto:nate@tripod.example.com 100,150 200,0 "程式錯誤？"

參照你的 mapfile

HTML 範例

<a href="/maps/imagemap1.map"> <img ismap src="/images/imagemap1.gif"> </a>

XHTML 範例

<a href="/maps/imagemap1.map"> <img ismap="ismap" src="/images/imagemap1.gif" /> </a>

ImapBase 指令

說明	imagemap 檔案的預設 `base`
語法	`ImapBase map\|referer\|URL`
預設	`ImapBase http://servername/`
環境	伺服器組態、虛擬主機、目錄、.htaccess
覆寫	索引
狀態	基礎
模組	mod_imagemap

ImapBase 指令設定 imagemap 檔案中使用的預設 base。它的值會被 imagemap 檔案中的 base 指令覆寫。如果未指定，base 預設為 http://servername/。

請參閱

UseCanonicalName

ImapDefault 指令

說明	當影像圖被呼叫，可是坐標並未明確對應時，預設的動作
語法	`ImapDefault error\|nocontent\|map\|referer\|URL`
預設	`ImapDefault nocontent`
環境	伺服器組態、虛擬主機、目錄、.htaccess
覆寫	索引
狀態	基礎
模組	mod_imagemap

ImapDefault 指令設定影像圖檔中使用的預設 default。其值會被影像圖檔中的 default 指令覆寫。如果未設定，default 動作為 nocontent，代表 204 No Content 會傳送給用戶端。在這種情況下，用戶端應繼續顯示原始頁面。

ImapMenu 指令

說明	當呼叫影像圖時，如果沒有提供坐標會執行的動作
語法	`ImapMenu none\|formatted\|semiformatted\|unformatted`
預設	`ImapMenu formatted`
環境	伺服器組態、虛擬主機、目錄、.htaccess
覆寫	索引
狀態	基礎
模組	mod_imagemap

ImapMenu 指令決定在影像圖檔被呼叫，但沒有提供有效坐標時的動作。

none: 如果 ImapMenu 是 none，不會產生選單，而且會執行 default 動作。
formatted: formatted 選單是最簡單的選單。影像圖檔中的註解會被忽略。會列印一級標題、再列印水平分割線，然後各連結會列印在不同的行。選單會以穩定的樸素外觀顯示，類似於目錄清單。
semiformatted: 在 semiformatted 選單中，註解會在出現於影像圖檔中的位置列印。空白行會轉換成 HTML 換行。不會列印標題或水平分割線，但在其他方面，選單會和 formatted 選單相同。
unformatted: 會列印註解，而空白行會被忽略。不會列印未出現在影像圖檔中的任何內容。所有換行和標題都必須包含在影像圖檔的註解中。這賦予你最大的彈性，可控制選單的外觀，但這表示你必須將映射檔視為 HTML，而非純文字。