DIV CSS 佈局教程網

自製右鍵選單:JavaScript 攔截右鍵並在 ASP.NET 頁面實現多層菜單
編輯:關於JavaScript     

把瀏覽器預設的右鍵選單換成自己的內容,可以做出類似桌面應用程式的操作體驗,例如檔案總管風格的「新增資料夾/排序/刪除」。以下以 ASP.NET Web Forms 為例,記錄完整實作。

JavaScript 部分

關鍵是攔截 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 狀態控制顯示。

ASPX 頁面部分

<%@ 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 時重新定位等情境,這些在原始示範中都還缺。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved