把瀏覽器預設的右鍵選單換成自己的內容,可以做出類似桌面應用程式的操作體驗,例如檔案總管風格的「新增資料夾/排序/刪除」。以下以 ASP.NET Web Forms 為例,記錄完整實作。
關鍵是攔截 document.oncontextmenu,並在處理函式中計算面板應出現的位置,最後回傳 false 取消預設選單。
<script type="text/javascript">
// 禁用右鍵預設選單
document.oncontextmenu = ContextMenu;
function ContextMenu() {
// 菜單出現的座標
var x, y;
// 取得一級菜單面板
var FramePanel = document.getElementById("FrameDiv");
var PanelWidth = parseInt(FramePanel.style.width.replace("px", ""));
var PanelHeight = parseInt(FramePanel.style.height.replace("px", ""));
// 取得滑鼠座標
var MouseX = event.clientX;
var MouseY = event.clientY;
// 取得視窗可視範圍
var WindowWidth = document.body.offsetWidth;
var WindowHeight = document.documentElement.offsetHeight;
// 右側空間不足則改為向左展開
if ((MouseX + PanelWidth) >= WindowWidth) {
x = MouseX - PanelWidth - 20;
} else {
x = MouseX;
}
// 下方空間不足則改為向上展開
if ((MouseY + PanelHeight) >= WindowHeight) {
y = MouseY - PanelHeight - 20;
} else {
y = MouseY;
}
FramePanel.style.left = x;
FramePanel.style.top = y;
FramePanel.style.display = "block";
// 隱藏二級菜單
document.getElementById("ChildDiv").style.display = "none";
return false; // 等同 event.returnValue = false
}
這段程式有兩個值得注意的設計。一是邊界翻轉:先假設選單向右下展開,若超出視窗就改向左上,這讓選單永遠完整可見。二是回傳 false,在 IE 事件模型中它等同於 event.returnValue = false,是取消預設行為的關鍵。
function MenuOnMouseOver(arg, imageUrl, hasChildMenu, childPanelId) {
// 替換背景圖(相對路徑)
arg.style.backgroundImage = "url('" + imageUrl + "')";
arg.style.backgroundColor = "#1665CB";
arg.style.color = "#ffffff";
if (hasChildMenu) {
var x, y;
var ChildPanel = document.getElementById(childPanelId);
var ChildPanelWidth = parseInt(ChildPanel.style.width.replace("px", ""));
var ChildPanelHeight = parseInt(ChildPanel.style.height.replace("px", ""));
// 父面板
var FramePanel = event.srcElement;
var PanelWidth = FramePanel.offsetWidth;
var PanelHeight = FramePanel.offsetHeight;
var MouseX = event.clientX;
var MouseY = event.clientY;
// 滑鼠在父面板內的偏移量
var MouseOffsetWidth = event.offsetX;
var MouseOffsetHeight = event.offsetY;
var WindowWidth = document.body.offsetWidth;
var WindowHeight = document.documentElement.offsetHeight;
if ((MouseX - MouseOffsetWidth + PanelWidth + ChildPanelWidth) >= WindowWidth) {
x = MouseX - MouseOffsetWidth - ChildPanelWidth - 3;
} else {
x = MouseX - MouseOffsetWidth + PanelWidth - 5;
}
if ((MouseY - MouseOffsetHeight + ChildPanelHeight) >= WindowHeight - 30) {
y = MouseY - MouseOffsetHeight - ChildPanelHeight - 15;
} else {
y = MouseY - MouseOffsetHeight + 5;
}
ChildPanel.style.left = x;
ChildPanel.style.top = y;
ChildPanel.style.display = "block";
}
}
子選單的定位比一級菜單複雜,因為它要貼在「滑鼠所在的父選單項」旁邊,而不是貼在滑鼠位置。這裡用 offsetX/offsetY 減掉滑鼠在父項內的偏移,還原出父項的左上角座標,再加上父項寬度,子選單就正好接在右側。那些 -3、-5、-15 是視覺微調,用來消除邊框造成的縫隙。
function MenuOnMouseOut(arg, imageUrl, hasChildMenu, childPanelId) {
if (hasChildMenu) {
var ChildPanel = document.getElementById(childPanelId);
var ToElement = event.toElement;
// 滑鼠可能移到子面板的子孫元素上,此時需比對 parentNode
if (ToElement == ChildPanel || ToElement.parentNode == ChildPanel) {
ChildPanel.style.display = "block";
} else {
ChildPanel.style.display = "none";
}
}
arg.style.backgroundImage = "url('" + imageUrl + "')";
arg.style.backgroundColor = "#ffffff";
arg.style.color = "#000000";
}
</script>
這段處理的是多層選單最經典的問題:滑鼠從父項移向子選單時,會先觸發父項的 mouseout,若無條件隱藏子選單,它就會在滑鼠抵達前消失。解法是檢查 event.toElement 是否為子面板本身或其父元素,若是則維持顯示。現代做法則是改用 setTimeout 延遲數百毫秒再判斷,或用 CSS 的 hover 狀態控制顯示。
<%@ Page Language="C#" AutoEventWireup="true"
CodeFile="ContextMenu.aspx.cs" Inherits="ContextMenu" %>
<%@ Register Assembly="AjaxControlToolkit"
Namespace="AjaxControlToolkit" TagPrefix="cc1" %>
<html xmlns="https://www.w3.org/1999/xhtml">
<head runat="server">
<title>右鍵選單示範</title>
<link href="Css/StyleSheet.css" rel="Stylesheet" type="text/css"/>
</head>
<body>
<form id="form1" runat="server">
<asp:ScriptManager ID="ScriptManager1" runat="server"></asp:ScriptManager>
<!-- 一級選單 -->
<div id="FrameDiv" runat="server"
style="width:170px; height:300px; border-style:solid; border-width:1px;
border-color:#A09F9F; background-color:White; display:none;
position:relative; padding:1px;">
<div class="MenuDivDefault"
onmouseover="MenuOnMouseOver(this,'Images/menu1_click.jpg')"
onmouseout="MenuOnMouseOut(this,'Images/menu1.jpg')"
style="background-image:url('Images/menu1.jpg')"
onclick="OnCreateFolderMenuClick()">創建新文件夾</div>
<div class="MenuDivDefault"
onmouseover="MenuOnMouseOver(this,'Images/menu2_click.jpg')"
onmouseout="MenuOnMouseOut(this,'Images/menu2.jpg')"
style="background-image:url('Images/menu2.jpg')">搜索新文件夾</div>
<div class="MenuDivDefault"
onmouseover="MenuOnMouseOver(this,'Images/menu3_click.jpg')"
onmouseout="MenuOnMouseOut(this,'Images/menu3.jpg')"
style="background-image:url('Images/menu3.jpg')">刪除該文件夾</div>
<div class="MenuDivDefault"
onmouseover="MenuOnMouseOver(this,'Images/menu4_click.jpg')"
onmouseout="MenuOnMouseOut(this,'Images/menu4.jpg')"
style="background-image:url('Images/menu4.jpg')">全部刪除</div>
<hr style="color:#A09F9F; width:160px; height:1px;"/>
<!-- 帶有子選單的項目 -->
<div class="MenuDivDefault"
onmouseover="MenuOnMouseOver(this,'Images/menu5_click.jpg','true','ChildDiv')"
onmouseout="MenuOnMouseOut(this,'Images/menu5.jpg','true','ChildDiv')"
style="background-image:url('Images/menu5.jpg')">文件排序</div>
</div>
<cc1:DropShadowExtender ID="DropShadowExtender1" runat="server"
TargetControlID="FrameDiv" Width="2" TrackPosition="true" Opacity="0.3">
</cc1:DropShadowExtender>
<!-- 二級選單 -->
<div id="ChildDiv" runat="server"
style="width:170px; height:200px; z-index:2; background-color:White;
border-style:solid; border-width:1px; border-color:#A09F9F;
display:none; position:absolute; padding:1px;">
<div class="MenuDivDefault"
onmouseover="MenuOnMouseOver(this,'Images/child_menu1_click.jpg')"
onmouseout="MenuOnMouseOut(this,'Images/child_menu1.jpg')"
style="background-image:url('Images/child_menu1.jpg')">名稱</div>
<div class="MenuDivDefault"
onmouseover="MenuOnMouseOver(this,'Images/child_menu2_click.jpg')"
onmouseout="MenuOnMouseOut(this,'Images/child_menu2.jpg')"
style="background-image:url('Images/child_menu2.jpg')">創建時間</div>
<div class="MenuDivDefault"
onmouseover="MenuOnMouseOver(this,'Images/child_menu3_click.jpg')"
onmouseout="MenuOnMouseOut(this,'Images/child_menu3.jpg')"
style="background-image:url('Images/child_menu3.jpg')">類型</div>
<div class="MenuDivDefault"
onmouseover="MenuOnMouseOver(this,'Images/child_menu4_click.jpg')"
onmouseout="MenuOnMouseOut(this,'Images/child_menu4.jpg')"
style="background-image:url('Images/child_menu4.jpg')">大小</div>
</div>
<cc1:DropShadowExtender ID="DropShadowExtender2" runat="server"
TargetControlID="ChildDiv" Width="2" TrackPosition="true" Opacity="0.3">
</cc1:DropShadowExtender>
</form>
</body>
</html>
陰影效果。DropShadowExtender 是 ASP.NET AJAX Control Toolkit 提供的陰影控制項,因此頁面開頭必須註冊控制項:
<%@ Register Assembly="AjaxControlToolkit"
Namespace="AjaxControlToolkit" TagPrefix="cc1" %>
面板定位。一級選單用 position: relative 搭配 left/top 偏移,二級選單用 position: absolute,才能脫離文件流浮在上層;z-index 則確保子選單蓋在父選單之上。
點擊事件。各選單項的 onclick 若要呼叫伺服器端方法,Web Forms 下需搭配 <asp:LinkButton> 或手動觸發 __doPostBack,純 <div onclick> 是不會產生回送的。
這份實作有幾處明顯的時代痕跡:使用 IE 的全域 event 物件(標準環境應由事件參數傳入)、用 parseInt 搭配 replace("px","") 解析尺寸(應改用 offsetWidth/offsetHeight 或 getBoundingClientRect)、以及以圖片背景實作選單項(今日改用 CSS 與 icon font 或 SVG 更靈活)。
更重要的是,全域攔截 oncontextmenu 會剝奪使用者的預設操作,在可訪問性上是有爭議的。實務上建議限定只在特定區域(如檔案清單容器)內攔截,並提供鍵盤操作路徑與 skip 機制。此外,選單開啟後應處理 ESC 關閉、點擊外部關閉、視窗 resize 時重新定位等情境,這些在原始示範中都還缺。