DIV CSS 佈局教程網

jQuery ContextMenu 右鍵選單外掛使用指南
編輯:JavaScript綜合知識     

ContextMenu 是一個能讓你在任意 HTML 元素上掛載自訂右鍵選單的 jQuery 外掛,選單的樣式、項目、以及項目的互動都能自由定義。以下示範三種常見的綁定方式。

基本 HTML 結構

先在頁面中準備好「選單的內容來源」——用一般 div 寫出清單,外掛會負責把它變成浮動的右鍵選單。

<HTML>
<HEAD>
  <TITLE>jQuery 右鍵選單</TITLE>
  <script src="jquery-1.2.6.min.js"></script>
  <script src="jquery.contextmenu.r2.js"></script>
</HEAD>
<BODY>
<span class="demo1" style="color:green;">右鍵點此</span>
<hr />
<div id="demo2">右鍵點此</div>
<hr />
<div class="demo3" id="dontShow">不顯示</div>
<hr />
<div class="demo3" id="showOne">顯示第一項</div>
<hr />
<div class="demo3" id="showAll">顯示全部</div>
<hr />

<!-- 右鍵選單的來源 -->
<div class="contextMenu" id="myMenu1">
  <ul>
    <li id="open"><img src="folder.png" /> 打開</li>
    <li id="email"><img src="email.png" /> 郵件</li>
    <li id="save"><img src="disk.png" /> 保存</li>
    <li id="delete"><img src="cross.png" /> 關閉</li>
  </ul>
</div>
<div class="contextMenu" id="myMenu2">
  <ul>
    <li id="item_1">選項一</li>
    <li id="item_2">選項二</li>
    <li id="item_3">選項三</li>
    <li id="item_4">選項四</li>
  </ul>
</div>
<div class="contextMenu" id="myMenu3">
  <ul>
    <li id="item_1">csdn</li>
    <li id="item_2">javaeye</li>
    <li id="item_3">itpub</li>
  </ul>
</div>
</BODY>

方式一:以 class 批次綁定並定義各項事件

<script>
// 所有 class 為 demo1 的 span 標籤都會綁定此右鍵選單
$('span.demo1').contextMenu('myMenu1', {
  bindings: {
    'open': function(t) { alert('Trigger was ' + t.id + '\nAction was Open'); },
    'email': function(t) { alert('Trigger was ' + t.id + '\nAction was Email'); },
    'save': function(t) { alert('Trigger was ' + t.id + '\nAction was Save'); },
    'delete': function(t) { alert('Trigger was ' + t.id + '\nAction was Delete'); }
  }
});

bindings 的 key 對應選單項目的 id,value 就是點擊後要執行的函式;參數 t 是觸發者元素,因此 t.id 能取得是哪個元素叫出這份選單。

方式二:以 id 綁定並自訂樣式

$('#demo2').contextMenu('myMenu2', {
  // 選單樣式
  menuStyle: {
    border: '2px solid #000'
  },
  // 選單項樣式
  itemStyle: {
    fontFamily: 'verdana',
    backgroundColor: 'green',
    color: 'white',
    border: 'none',
    padding: '1px'
  },
  // 滑鼠移入項目時的樣式
  itemHoverStyle: {
    color: 'blue',
    backgroundColor: 'red',
    border: 'none'
  },
  bindings: {
    'item_1': function(t) { alert('Trigger was ' + t.id + '\nAction was item_1'); },
    'item_2': function(t) { alert('Trigger was ' + t.id + '\nAction was item_2'); },
    'item_3': function(t) { alert('Trigger was ' + t.id + '\nAction was item_3'); },
    'item_4': function(t) { alert('Trigger was ' + t.id + '\nAction was item_4'); }
  }
});

方式三:動態決定要不要顯示、要顯示哪些項目

$('div.demo3').contextMenu('myMenu3', {
  // 重寫 onContextMenu 與 onShowMenu 事件
  onContextMenu: function(e) {
    if ($(e.target).attr('id') == 'dontShow') return false;
    else return true;
  },
  onShowMenu: function(e, menu) {
    if ($(e.target).attr('id') == 'showOne') {
      $('#item_2, #item_3', menu).remove();
    }
    return menu;
  }
});
</script>

onContextMenu 回傳 false 就等於「這裡不要顯示右鍵選單」,可以拿來排除特定元素;onShowMenu 則能在選單實際出現前拿到選單節點做加工,例如移除用不到的項目,實現「同一份選單、依情境顯示不同選項」的效果。

使用提醒

這個外掛搭配的是 jQuery 1.2.6,相當早期的版本,API 與安全性設計都已經不適用於現代專案。右鍵選單本身也會覆蓋掉瀏覽器預設選單,可能讓使用者不習慣,建議只在自訂應用情境(如線上表格、圖片編輯器)中使用,並提供鍵盤或長按的替代操作路徑。若要自行實作,用 contextmenu 事件搭配 preventDefault() 加上定位好的浮層即可,不必引入額外套件。

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